← 문서Markdown로그인

스킬과 예시

스킬과 예시 만들기, 복사, 정리.

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.