skill-creator는 Anthropic에서 공식 제공하는 메타 스킬 도구로, Hermes/Claude 생태계 내에서 사용자가 자연어만으로 AI 에이전트용 기능을 설계하고 배포할 수 있도록 지원합니다. 복잡한 파일 구조나 형식 지식 없이도, 이 도구를 통해 요구사항 정의부터 테스트, 최종 패키지 생성까지 일관된 프로세스를 안내받을 수 있습니다. 본 문서에서는 설치부터 실제 기능 배포까지의 전체 흐름을 단계별로 설명합니다.

준비 단계: skill-creator 설치 및 확인

1. CLI 명령어로 설치

터미널을 열고 다음 명령어를 실행하여 도구를 추가합니다:

skills install skills-sh/anthropics/skills/skill-creator

설치 후 Hermes 런타임이 업데이트되면 도구 사용이 가능해집니다.

2. 정상 작동 확인

다음 메시지를 전송하여 도구가 활성화되었는지 확인하세요:

skill-creator를 사용해 새로운 기능을 만들어줘

응답으로 질문 형식의 안내 흐름이 시작된다면 성공적으로 설치된 것입니다.

핵심 절차: 5단계 표준 기능 개발 워크플로우

1단계: 목적 정의 — 기능의 핵심 목표 설정

AI는 사용자의 의도를 파악하기 위해 기본 정보를 요청합니다. 기술적 지식 없이도 자연스러운 문장으로 답변하면 됩니다.

• 기능 이름: 예) 마크다운 테이블 → SQL 변환기
• 주요 기능: 예) "마크다운 형식의 표를 분석해 자동으로 데이터베이스 테이블 생성문을 작성"
• 입력 형태: 예) "헤더와 샘플 데이터를 포함한 마크다운 테이블 문자열"
• 출력 형태: 예) "CREATE TABLE 구문 (VARCHAR, INT 등 데이터 타입 추론 포함)"
• 사용 사례: 예) "기술 문서에서 테이블 스키마를 빠르게 DB에 반영할 때"

예시 응답:

이름: 마크다운 테이블 → SQL
목적: 마크다운 표를 분석해 컬럼명과 데이터 유형을 추출하고, 실행 가능한 SQL 문 생성
입력: 마크다운 형식의 표 텍스트 (첫 행은 헤더)
출력: 기본 키 없이 생성되며, 각 필드에 적절한 SQL 타입(VARCHAR, DATE 등)이 매핑된 CREATE TABLE 문

2단계: 로직 설계 — AI 기반 실행 플랜 생성

입력된 요구사항을 바탕으로, skill-creator는 다음과 같은 설계안을 자동 생성합니다:

• 처리 단계 분할 (파싱 → 타입 추론 → 쿼리 조합)
• 입출력 데이터 형식 명세
• 예외 상황 처리 방침 (빈 입력, 잘못된 형식, 숫자/날짜 혼재 등)
• 성공/실패 시나리오 예제

사용자는 결과를 검토하고, 필요 시 "날짜 형식 인식 강화", "각 컬럼에 주석 추가" 등의 보완 요청을 자연어로 제출할 수 있습니다.

3단계: 표준화된 SKILL.md 파일 생성

최종 설계안 확정 후, 도구는 Hermes 규격에 맞는 SKILL.md 파일을 자동 생성합니다. 이 파일에는 다음 내용이 포함됩니다:

• 메타데이터 (버전, 설명, 카테고리)
• 호출 트리거 조건 및 인수 형식
• 내부 처리 로직 순서도
• 에러 핸들링 전략
• 사용 예시 (입력/출력 대조)

모든 항목은 자동으로 올바른 형식으로 구성되므로, 수작업 포맷팅이 필요하지 않습니다.

4단계: 테스트 케이스 생성 및 유효성 검증

자동으로 다양한 테스트 케이스가 생성되어 기능의 신뢰성을 평가합니다:

• 정상 테스트: 일반적인 입력에 대해 정확한 출력 생성 여부 확인
• 경계 테스트: 빈 테이블, 특수문자 포함, 타입 불일치 등 비정상 입력 처리 능력 평가
• 피드백 루프: 실패 사례 발생 시 원인 분석과 함께 수정 제안 제공

5단계: 설치 가능한 패키지 내보내기

완료 시 두 가지 형태로 결과물을 배포할 수 있습니다:

1. ID 기반 설치 명령어:
   

   hermes skills install sc-gen2024-md2sql

   (실제 생성된 고유 ID로 대체됨)
2. 로컬 디렉터리 패키지:
   전체 파일 구조를 로컬에 저장한 후 경로로 설치 가능
   

   hermes skills install ./markdown-to-sql-tool

빠른 시작 템플릿: 즉시 사용 가능한 명령어

다음 메시지를 그대로 전송하면 전체 프로세스가 자동으로 시작됩니다:

skill-creator를 사용해 새로운 기능을 만들어줘. 다음 순서로 진행해:
1. 기능 이름, 목적, 입출력 형식, 사용 사례를 묻고 내가 답하면 기록해
2. 그에 맞는 처리 로직과 단계별 흐름을 제안해
3. Hermes 표준에 부합하는 SKILL.md 파일을 생성해
4. 정상 및 예외 테스트 케이스를 만들어 동작을 검증해
5. 마지막으로 설치 가능한 명령어와 로컬 패키지를 내보내줘

개인화된 기능 개발을 위해 위 템플릿의 목적 설명 부분을 자유롭게 수정하여 사용할 수 있습니다.

문제 해결 및 고급 활용 팁

1. 작업 도중 세션 종료 시 복구 방법

이전 작업을 이어가려면 다음 명령어를 보내세요:

이전에 만들던 기능 개발을 skill-creator로 계속 진행해줘

도구는 컨텍스트를 재구성하여 중단 지점부터 다시 시작합니다.

2. 기존 기능 개선 요청

이미 설치된 기능을 업그레이드하려면:

skill-creator를 사용해 [기능 이름]을 개선해줘. 경계 케이스 처리를 추가하고, 출력 결과에 포맷팅을 더 깔끔하게 해줘

3. 기능 안정성 확보 전략

• 초기 요구사항 단계에서 입력 형식을 구체적으로 명시 (예: "첫 줄은 반드시 헤더여야 함")
• 테스트 단계에서 직접 예외 입력 예시를 제시하여 검증 범위 확대
• 공식 도구보다 비공식 커뮤니티 스크립트 사용을 지양하여 호환성 문제 예방