개인 스킬 빌더
특정 반복 워크플로우에 대한 에이전트 결정을 개선하는 작고 발견 가능한 스킬을 생성합니다.
범위
이 스킬은 새 스킬을 만들거나 기존 스킬에 집중적인 변경을 가할 때 사용합니다. 사용자가 요청한 위치, 호출 정책, 권한 경계를 유지하십시오. 에이전트가 이미 알고 있는 일반적인 조언을 담기 위해 스킬을 생성하지 마십시오.
워크플로우
-
파일을 작성하기 전에 작업 경계를 정의하십시오:
- 스킬이 제공하는 반복 가능한 결과는 무엇입니까?
- 어떤 요청이 이 스킬을 활성화해야 하며, 유사하지만 활성화되지 않아야 하는 요청은 무엇입니까?
- 어떤 입력, 도구, 부작용, 완료 확인이 중요한가요?
-
기존 스킬을 변경하기 전에 검사하십시오. 유용한 리소스와 정책을 유지하고, 기존 디렉토리를 다시 초기화하지 마십시오.
-
가장 작은 구조를 선택하십시오:
SKILL.md는 필수입니다.references/는 결정을 변경하는 중요하고 조건부 자료에만 추가하십시오.scripts/는 반복적이거나 결정론적인 작업으로 실행이 신뢰성을 향상시키는 경우에만 추가하십시오.assets/는 생성된 출력에 사용되는 파일에만 추가하십시오.
-
SKILL.md를 작성하십시오:- 프론트매터
name은 소문자 하이픈-케이스여야 하며 디렉토리 이름과 일치하고 최대 64자여야 합니다. description은 스킬이 무엇을 하는지와 언제 적용되는지를 모두 명시해야 하며, 잘못된 라우팅을 방지하기 위한 경계를 포함해야 합니다.- 본문은 결과, 명확하지 않은 규칙, 실행 순서, 확인 지점, 완료 확인에 초점을 맞추십시오.
- 조건부 세부 사항은 연결된 리소스에 배치하고 언제 읽어야 하는지 정확히 명시하십시오.
- 프론트매터
-
환경에서 스킬 검증 도구를 제공하는 경우 결과를 검증하십시오 (설치된
skill-creator스킬 아래에서quick_validate.py를 찾으십시오):python3 <skill-creator>/scripts/quick_validate.py /path/to/skill검증 도구를 사용할 수 없는 경우, 해당 프론트매터, 명명, 리소스 링크, 플레이스홀더, 스크립트 검사를 수동으로 수행하십시오. 추가된 스크립트는 실용적인 경우 실행하십시오.
설계 규칙
- 설명을 기능 카탈로그가 아닌 라우팅 조건으로 취급하십시오.
- 공유 지침은 일상적인 로딩에 충분히 짧게 유지하십시오. 외부 명세 전체를 진입점에 복사하지 마십시오.
- 광범위한 금지 사항이나 모호한 품질 형용사보다는 명시적인 범위와 관찰 가능한 완료 기준을 선호하십시오.
- 구체적인 워크플로우가 사용되지 않는 한 README 파일, 예제, 템플릿, 리소스 디렉토리를 추가하지 마십시오.
- 스킬을 업데이트할 때 기존 지원되는 프론트매터 및
agents/openai.yaml필드를 유지하십시오. - 사용자가 명시적으로 명시적 전용 호출을 요청하지 않는 한 자동 발견을 활성화된 상태로 유지하십시오.
참조
이식성, 프론트매터 필드, 명명 제한, 로딩 동작이 불확실한 경우 Agent Skills 사양을 읽으십시오. 사용자가 제공하거나 시스템 로컬의 설계 가이드는 선택적 선호도 소스로 취급하십시오: 사용자가 해당 규칙을 명시적으로 요청하거나 작업이 이에 의존하는 경우에만 읽고, 전체 내용을 스킬에 복사하지 마십시오. 설치된 skill-creator 스킬을 참조하여 초기화 도구, UI 메타데이터, 검증 세부 사항을 확인하고 시스템별 절대 경로에 의존하지 마십시오.