Community라이팅 & 에디팅github.com

에이전트 스킬 작성

재사용 가능한 AI 에이전트 스킬과 SKILL.md 패키지를 설계, 초안 작성, 수정 또는 감사합니다. 스킬의 범위, 트리거 설명, 워크플로우, 지원 참조 자료 또는 스크립트, 안전 경계 및 평가를 생성하거나 개선할 때 사용하세요. 스킬을 호스트 에이전트와 실제 작업에 맞게 조정하십시오.

에이전트 스킬 작성란 무엇인가요?

이 스킬은 개발자와 AI 에이전트 사용자가 재사용 가능하고 일관된 작업을 위한 AI 에이전트 스킬을 설계, 초안 작성, 수정 또는 감사할 수 있도록 안내합니다. 주 목적은 에이전트가 실제로 실행할 수 있는 구조화된 SKILL.md 명령 패키지를 제공하는 것입니다. 이 스킬은 스킬의 트리거 조건, 입력/출력 계약, 결정 절차, 안전 경계 및 평가를 정의하는 명확한 계약을 강조합니다. Claude Code, Cursor, Codex 등 다양한 플랫폼에서 사용할 수 있도록 설계되었으며, 실제 예제를 기반으로 스킬을 구체화하고, 가정이 필요한 경우 명확히 표시하도록 권장합니다. 또한 테스트 중심 접근법을 통해 대표 사례와 경계 사례를 사용하여 스킬을 검증하고 수정하는 프로세스를 포함합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rafik-mikhail/write-agent-skill/tree/main

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

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

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

문서

에이전트 스킬 작성은(는) 무엇을 하나요?

목표

하나의 일관되고 재사용 가능한 작업을 위한 에이전트가 실행할 수 있는 명령 패키지를 제공합니다. 사용자의 작업, 예제, 도구 환경, 기존 아티팩트 및 수정 사항에 기반을 둡니다. 실제 예제가 없는 경우 가정을 표시하고, 제품별 API를 임의로 만들지 말고 최소한의 테스트 가능한 지침을 초안으로 작성합니다. 계획, 진행 보고서 또는 비평이 아닌 실제 요청된 스킬을 완료하여 제시합니다.

계약 정의

  1. 트리거를 명시합니다: 이 스킬을 활성화해야 하는 작업 및 입력과 함께 활성화해서는 안 되는 관련 요청을 명시합니다. description은 이 스킬이 수행하는 작업과 사용 시기를 지정하는 간결한 라우팅 규칙으로 작성합니다.
  2. 필수 및 선택적 입력, 에이전트의 허용된 권한, 의도된 출력, 완료 정의를 명시합니다. 인접 스킬과의 핸드오프 시 중복을 해결합니다. 주제가 동일하다고 해서 서로 다른 단계를 병합하지 마십시오.
  3. 어떤 동작이 필수적인 안전 또는 정확성 게이트인지, 어떤 동작이 기본 휴리스틱인지, 어떤 동작이 선택적 개선 사항인지 표시합니다. 지침으로 런타임 권한을 강제할 수 없습니다. 파일 시스템, 네트워크 및 도구 접근에 대해서는 플랫폼 제어를 사용하십시오.

SKILL.md 초안 작성

폴더 이름과 일치하는 소문자 하이픈으로 연결된 name과 구체적인 description을 포함하는 YAML frontmatter를 사용합니다. 호스트 플랫폼의 형식과 기능을 따릅니다. 선택적 메타데이터나 allowed-tools가 플랫폼 간에 접근을 강제한다고 가정하지 마십시오.

본문을 간결하게 유지하십시오: 작업 및 경계, 입력, 결정 절차, 중단/실패 처리, 출력 계약, 명확하지 않은 함정. 동등한 대안 메뉴보다는 기본 경로를 제시하십시오. 취약한 작업에는 정확한 단계를 제공하십시오. 컨텍스트 선택에서 정당한 판단의 여지를 남겨두십시오. 모든 섹션에서 동일한 금지 사항을 반복하거나 일회성 작업의 답변을 일반 절차로 포함시키지 마십시오.

대용량 도메인 참조는 집중된 references/ 파일로 이동하고, 에이전트에게 언제 읽어야 하는지 정확히 알려주십시오. 반복적이고 결정적인 작업을 위한 재사용 가능한 스크립트는 런타임 종속성과 유효성 검사 동작을 확인한 후에만 추가하십시오. 참조를 SKILL.md에서 직접 도달할 수 있도록 유지하고, 초안이 설치, 실행 또는 검증되지 않았는데도 그렇게 주장하지 마십시오.

테스트 및 수정

경계 사례를 포함한 2~3개의 대표 사례부터 시작하십시오. 스킬이 신뢰할 수 없는 콘텐츠에 대해 작동하거나 중요한 경계가 있는 경우 부정적 트리거 및 적대적 사례를 추가하십시오. 스킬을 포함하거나 포함하지 않은 상태, 또는 이전 초안과 비교하여 새로운 세션을 실행하십시오. 지침이 얼마나 정교한지가 아니라 관찰 가능한 출력과 도구 동작을 평가하십시오. 불필요한 단계, 놓친 증거, 잘못된 활성화 및 범위 확장에 대해 추적을 검사하십시오. 기계적 검사에는 코드를 사용하고, 실질적인 판단은 사람이 검사하도록 하십시오. 실제 실패를 방지하지 못하면서 비용을 추가하는 지침은 제거하십시오.

전달 확인

응답하기 전에 요청된 전체 아티팩트가 실제로 존재하고 내부적으로 일관성이 있는지 확인하십시오. 사용자가 전체 마크다운을 요청하는 경우 패치 조각이 아닌 현재 SKILL.md 전체를 제공하십시오. 파일을 생성하는 경우 파일이 존재하고 전체 초안을 포함하는지 확인하고, 테스트되지 않은 상태를 정직하게 보고하십시오. 변경된 사항과 남아 있는 검증 필요 사항을 간략히 명시하십시오. 명확한 요청 없이 하나의 스킬에 대한 요청을 관련 없는 스위트로 바꾸지 마십시오.

관련 스킬