← 문서Markdown로그인

에이전트 플레이북

MCP를 쓰는 코딩 에이전트를 위한 짧은 안내.

당신은 Skillkren에 연결되어 있습니다. 재사용 가능한 AI 스킬과 그 출력 예시의 라이브러리입니다. 스킬은 개방형 Agent Skills 형식을 따릅니다. SKILL.md(name과 description frontmatter가 있는 지시)와 선택적 references/, scripts/, assets/ 파일입니다.

브랜드 이름: 항상 Skillkren. 도메인: skillkren.tech.

첫 단계

  1. 필요하면 topic agent로 get_docs를 호출하세요(또는 리소스 https://skillkren.tech/docs/agent.md를 읽으세요).
  2. 중복 생성 전에 list_skills로 사용자의 스킬과 팀 라이브러리를 확인하세요. 다른 사람이 공유한 스킬을 열려면 링크의 id로 get_skill을 쓰세요.
  3. Free 플랜에서는 최대 25개 스킬. 한도에서는 upsert_skill이 오류를 반환합니다. 우회하지 마세요.
  4. 명확한 제목으로 upsert_skill을 쓰세요. 같은 제목의 내 스킬을 업데이트하거나 새로 만듭니다. 팀 라이브러리에서는 team을 넘기세요.
  5. 새 스킬을 게시할 때는 항상 최소 하나의 예시를 붙이세요(add_example).

스킬 사용

  1. get_skill로 불러와 지시를 따르세요.
  2. get_skill은 번들 files를 경로로 나열합니다. 지시가 가리키거나 작업에 필요할 때만 get_skill_file로 읽으세요.
  3. 스킬의 예시를 형식, 톤, 품질의 기준으로 쓰세요.

좋은 스킬 작성

  • 설명: 스킬이 무엇을 하는지, 그리고 언제 쓰는지. 사용자가 실제로 말할 말로. 에이전트는 이것만으로 로드 여부를 정합니다.
  • 지시(content): 원본 Markdown. HTML이 아님. 단계, 규칙, 좋은 출력의 모습. 약 500줄 이내.
  • 참조: 긴 내용(스타일 가이드, API 메모, 체크리스트)은 put_skill_file로 references/에 옮기고, 지시에서 경로로 이름을 밝히세요. 예: "For banned words, read references/banned-words.md". 템플릿과 데이터는 assets/, 실행 코드는 scripts/.
  • 라이선스: 사용자가 고를 때만 license를 설정하세요(예: MIT, Apache-2.0, CC-BY-4.0, Proprietary). 물으세요. 대신 고르지 마세요.
  • 요구사항: 특정 도구나 접근이 필요할 때만 compatibility를 설정하세요.

스킬 폴더 업로드

사용자가 로컬 스킬(예: ~/.claude/skills/pdf-processing/) 업로드를 요청하면:

  1. SKILL.md를 읽으세요. name(읽기 쉬운 제목으로), description, license를 쓰고, frontmatter 뒤 본문이 content입니다.
  2. 그 필드로 upsert_skill을 호출하세요. 폴더에 LICENSE 파일이 있으면 그 텍스트를 licenseText로 넘기세요.
  3. references/, scripts/, assets/ 아래 각 파일에 대해 같은 상대 경로로 put_skill_file을 호출하세요. 예: references/forms.md.
  4. 텍스트 파일만, 각 100 KB까지, 스킬당 30개, 하위 폴더는 한 단계까지. 바이너리(이미지, PDF)는 건너뛰고 건너뛴 파일을 사용자에게 알리세요.
  5. 끝나면 스킬 링크를 주세요.

반대로는 사용자가 스킬 페이지에서 zip을 다운로드해 앱의 skills 폴더에 풀 수 있습니다.

공개 범위

새 스킬은 Private(소유자만)입니다. Unlisted 스킬은 링크가 있는 누구나 열 수 있고, Public 스킬은 소유자 프로필 https://skillkren.tech/u/<username>에도 게시됩니다.

공개 범위는 바꿀 수 없습니다. 사용자가 공유하고 싶어 하면 스킬 페이지로 보내고 제목 옆 스위치를 쓰라고 하세요. 비밀이 든 스킬 공유를 권하지 마세요.

인증 맥락

연결은 한 사용자에게 속합니다. 당신이 만드는 모든 것은 그 사용자 소유이며, 그 사용자가 변경할 수 있는 것만 변경할 수 있습니다.

인용할 URL

  • 앱: https://skillkren.tech/app
  • 스킬: 도구가 반환하는 url을 쓰세요. https://skillkren.tech/u/<username>/skills/<id> 형태입니다.
  • 예시: 스킬 URL에 /examples를 붙입니다. 참조: 스킬 URL에 /references를 붙입니다.
  • 문서: https://skillkren.tech/docs
  • 에이전트 문서(원본): https://skillkren.tech/docs/agent.md

하지 말 것

  • 사용자가 확인하기 전에 스킬이나 파일을 삭제하지 마세요.
  • 비밀을 스킬, 파일, 예시에 붙여넣지 마세요.
  • 클라이언트 측 렌더링에 의존하지 마세요. Markdown 소스를 저장하세요.