Skillkren는 Claude, Codex, Cursor 등이 쓰는 개방형 Agent Skills 형식을 따릅니다. 스킬은 다음과 같은 폴더입니다.
pdf-processing/
├── SKILL.md instructions (required)
├── LICENSE.txt license terms (optional)
├── references/ docs the agent reads only when needed
├── scripts/ code the agent can run
└── assets/ templates and data
스킬
- 제목: 내보내기 시 폴더
name(소문자, 하이픈)이 됩니다. - 설명(필수): 스킬이 무엇을 하는지, 그리고 언제 쓰는지. 에이전트는 먼저 이 글을 읽어 로드 여부를 정하므로, 상황과 키워드를 적으세요.
- 지시: SKILL.md 본문(Markdown). 약 500줄 이내로 두고, 긴 내용은 references로 옮기세요.
- 태그(선택).
- 라이선스(선택): MIT, Apache 2.0, CC BY 4.0, CC0, Proprietary 또는 기타. 전체 약관을 추가하면 LICENSE.txt로 내보내집니다.
- 요구사항(선택): 특정 도구나 접근이 필요할 때만. 예: "Needs Python 3.12 and internet access".
compatibility로 내보내집니다. - 공개 범위: Private(기본), 팀, Unlisted, 또는 Public. 자세한 내용: /docs/visibility.
스킬을 만들 때 SKILL.md 전체를 붙여넣으면 제목, 설명, 라이선스가 frontmatter에서 채워집니다.
안정적인 URL: /u/<username>/skills/<uuid>
참조 및 기타 파일
스킬의 References 탭을 열어 references/, scripts/, 또는 assets/ 아래에 파일을 추가하세요. SKILL.md에서는 경로로 각각을 언급하세요(예: "For the full style rules, read references/style-guide.md"). 에이전트가 언제 열지 알 수 있습니다. 텍스트 파일만, 각 100 KB까지, 스킬당 30개까지.
예시
예시는 스킬에 속하며 실제 출력을 보여 줍니다. 스킬을 신뢰할 수 있게 만듭니다. 동료나 에이전트가 "좋은" 결과가 어떤 모습인지 정확히 볼 수 있습니다.
- 목록:
/app/skills/<uuid>/examples - 상세:
/app/skills/<uuid>/<example-slug>
버전 기록
지시, 설명, 태그, 또는 라이선스를 편집할 때마다 번호가 매겨진 버전이 저장됩니다. Free 플랜은 최근 2개, Pro와 Team은 전체를 보여 줍니다.
복사, 다운로드, 설치
- 스킬 복사는 정확한 SKILL.md 지시를 복사합니다.
- .zip 다운로드는 전체 폴더(frontmatter가 있는 SKILL.md, LICENSE.txt, references)를 제공합니다.
다운로드 설치 방법:
- Claude(앱): Settings → Capabilities → Skills → zip 업로드.
- Claude Code:
~/.claude/skills/(또는 프로젝트의.claude/skills/)에 압축 해제. - Codex / Cursor / 기타: 앱의 skills 폴더(예:
~/.codex/skills/)에 압축 해제.
다운로드를 건너뛰고 MCP로 에이전트를 연결하면 항상 최신 버전을 읽습니다. 자세한 내용: /docs/connectors.
