Community라이팅 & 에디팅github.com

AradhanaID/agent-skills

4체크 방식(트리거, 구조, 유도, 가지치기)을 사용하여 스킬을 작성하거나 재작성합니다.

agent-skills란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)용 스킬을 체계적으로 작성하거나 재작성하기 위한 방법론을 제공합니다. 단순한 템플릿 생성이 아닌, 실제 실행 결과를 기준으로 판단되는 실용적인 스킬을 만드는 데 초점을 맞춥니다. 트리거(Trigger), 구조(Structure), 유도(Steering), 가지치기(Pruning)라는 네 가지 체크를 통해 스킬의 품질을 보장합니다. 참조 문서(`reference.md`)를 활용하여 프론트매터(frontmatter) 및 호출 방식에 대한 세부 사항을 관리하며, 모든 단계는 검증 가능한 완료 조건을 가집니다. 특히 '무작동 테스트(no-op test)'를 통해 중복을 제거하고 불필요한 설명을 줄여 간결하고 효과적인 스킬을 완성할 수 있도록 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AradhanaID/agent-skills/tree/HEAD/skills/write-a-skill

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

스킬 작성하기

한 번의 실행으로 하나의 스킬을 작성하거나 재작성합니다. 결과물은 스킬이 실행될 때의 동작으로 판단되며, 읽히는 방식으로 판단되지 않습니다. 이 실행은 사용자의 프로세스를 설치하는 것이지, 일반적인 스킬 보일러플레이트를 설치하는 것이 아닙니다.

작성하기 전에 reference.md의 컨텍스트 포인터를 따르세요. 프론트매터 관련 메커니즘은 거기에 있습니다.

단계

  1. 트리거를 고정하세요. 누가, 언제 스킬에 도달해야 하는지 물어보세요. 의도적으로만 실행되는 스킬은 사용자-호출(user-invoked) 입니다(disable-model-invocation: true, 설명은 한 줄의 사람 요약, <100자). 에이전트가 프롬프트 없이 도달해야 하는 스킬은 모델-호출(model-invoked) 입니다. 설명은 항상 로드되는 포인터이며, 그 표현이 실행 여부를 결정합니다. 완료 조건: 호출 선택이 부담하는 로드(컨텍스트 또는 사용자의 기억)를 지목합니다.
  2. 실제로 작업이 어떻게 실행되는지 목록화하세요. 이 작업의 마지막 실제 실행을 떠올려보세요. 무엇이 되돌려졌고, 수정되었으며, 반복되었나요? 그 수정 사항들이 스킬의 내용입니다. 모델이 도움 없이 수행하는 것은 내용이 아닙니다. 완료 조건: 초안이 방지하는 실제 실패를 적어도 하나 인용합니다.
  3. 단계를 먼저 작성하고, 그 다음 포인터를 작성하세요. 각 단계는 명시적인 완료 조건을 가진 하나의 절차이며, 먼저 확인 가능한 것을 배송할 수 있도록 순서대로 배열됩니다. 일부 실행에서만 필요한 지원 자료는 reference.md에 언제 읽어야 하는지를 지목하는 포인터 뒤에 배치합니다. 완료 조건: 모든 단계가 에이전트에게 성공 여부를 묻지 않고도 검증 가능합니다.
  4. 주도적인 단어를 선택하세요. 반복되는 아이디어 각각에 대해, 이미 모델의 사전 학습에 존재하는 간결한 단어를 가져와 의미를 전달하게 하세요. 포인터, 단계, 완료 조건은 그 단어들을 재사용합니다. 주변 설명을 하기보다는 전문 용어를 그 단어들로 이름을 바꾸세요. 완료 조건: 각 주도적인 단어가 둘 이상의 위치에 나타나고 각 위치에서 방향을 제시합니다.
  5. 무작동 테스트로 가지치기하세요. 문장 단위로: 문장을 삭제하고, 무엇이 깨졌는지 물어보세요. 아무것도 깨지지 않았다면 문장을 삭제합니다. 전체 문장을 삭제하며, 단어를 다듬지 않습니다. 중복은 두 개의 희미한 문장이 아닌 하나의 진실 공급원으로 축소됩니다. 완료 조건: 더 이상 무작동 테스트를 실행할 수 없을 때까지 실행하며, 파일이 이전 버전보다 짧아집니다.

참고

  • reference.md — 호출 유형별 프론트매터 메커니즘, 포인터 작성 규칙, 기존 스킬 검토를 위한 체크리스트 배터리.
  • 이 실행이 생성하는 스킬은 실제 실행을 통해 반복 개선되며, 한 번에 작성되지 않습니다. 실행이 잘못될 경우 참조 문서 읽기가 재작성 전에 실패를 검증합니다.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬