skillsmith은(는) 무엇을 하나요?
한 줄짜리 아이디어로 사양을 준수하는 Agent Skill을 스캐폴드하고, SKILL.md 파일(이름 규칙, 설명 길이 및 "사용 시기", 호환성 제한, 메타데이터 맵, 본문 길이, 유출된 비밀 등)을 린트합니다.
SkillSmith 저장소 루트에 있는 종속성 없는 CLI인 cli.js가 작업을 수행합니다.
사용 시기
- 사용자가 작업에 대한 새 스킬을 원할 때 ("다음을 수행하는 스킬을 만들어줘…").
- 사용자가 스킬 폴더나 SKILL.md가 표준을 따르는지 확인하거나 수정을 원할 때.
단계
- 검증하려면
node <skillsmith-경로>/cli.js validate <스킬-디렉토리>를 실행합니다(여러 폴더 허용). 종료 코드 0은 유효함을 의미합니다. - 모든
error를 보고하고 사용자의 SKILL.md에서 수정합니다: 이름을 소문자-하이픈으로 변경하고, 폴더 이름이name과 일치하도록 하며,description을 1024자 이하로 유지하고 "Use when …"을 포함시킵니다. 그런 다음 1단계를 다시 실행합니다. - 스킬을 생성하려면
GEMINI_API_KEY가 설정되어 있는지 확인하고(절대 출력하지 마세요),node <skillsmith-경로>/cli.js new "<기능 및 사용 시기>" --out <스킬-디렉토리> --author "<이름>"을 실행합니다. - 사용자에게 생성된
SKILL.md를 보여준 다음, 새 폴더에서 1단계를 실행합니다. 필요에 따라 편집하세요. CLI는 기존 SKILL.md를 덮어쓰지 않습니다.
예시
node cli.js validate skills/commitcraft skills/skillsmithnode cli.js new "CSV 파일을 요약하고 차트를 제안합니다. 사용자가 .csv 파일을 공유할 때 사용하세요" --out ./skills
참고 사항
- 알 수 없는 최상위 필드는 경고를 생성합니다. 사용자 데이터는
metadata아래에 있어야 합니다. - 사양은 본문이 500줄 미만일 것을 권장합니다. 긴 문서는
references/로 이동하세요.