source-to-skill은(는) 무엇을 하나요?
소스 자료를 분석하고 재사용 가능한 지식만을 에이전트 스킬로 컴파일합니다.
소개
이 스킬은 다양한 소스 자료(문서, 코드베이스, 튜토리얼, API 명세 등)를 입력받아 AI 에이전트가 직접 사용할 수 있는 재사용 가능한 지식 단위로 변환합니다. 목표는 원본 자료의 노이즈를 제거하고 핵심 패턴, 모범 사례, 주요 명령어 및 설정 방법을 추출하여 SKILL.md 형식으로 출력하는 것입니다.
사용 방법
- 소스 자료 준비: 분석할 원본 텍스트, 코드 조각, 또는 문서 링크를 준비합니다.
- 스킬 실행: 제공된 스크립트나 명령어를 통해 소스 자료를 분석합니다.
- 결과 확인: 생성된 SKILL.md 파일을 확인하여 에이전트에 적용합니다.
명령어 예시
# 기본 사용법
source-to-skill --input ./documentation.md --output ./skills/my-skill/SKILL.md
# 여러 파일 처리
source-to-skill --input ./docs/*.md --output ./skills/
주요 특징
- 지식 추출: 불필요한 내용을 걸러내고 재사용 가능한 지식만 선별
- 구조화된 출력: SKILL.md 표준 형식으로 자동 변환
- 멀티 플랫폼 호환: Claude Code, Cursor, Codex 등 다양한 에이전트 지원
- 재사용성 극대화: 원본 컨텍스트와 무관하게 독립적으로 활용 가능
설정
환경 변수나 설정 파일을 통해 동작을 제어할 수 있습니다.
| 변수명 | 설명 | 기본값 |
|---|---|---|
INPUT_DIR | 소스 자료 디렉토리 경로 | ./src |
OUTPUT_DIR | 출력 스킬 디렉토리 경로 | ./skills |
MAX_CHUNK_SIZE | 청크 최대 크기 (토큰) | 4096 |
예제
다음은 API 문서에서 스킬을 생성하는 예제입니다.
# 입력: REST API 문서 일부
## GET /users
사용자 목록을 반환합니다. 인증이 필요합니다.
# 출력 스킬
## REST API 호출
- `GET /users` - 사용자 목록 조회 (인증 필요)
- 헤더에 `Authorization: Bearer <token>` 포함
참고 사항
- 원본 자료의 저작권을 준수하세요.
- 생성된 스킬은 에이전트의 시스템 프롬프트나 컨텍스트에 포함하여 사용합니다.
- 대용량 자료는 청크 단위로 처리되므로 여러 번 실행이 필요할 수 있습니다.
라이선스
이 스킬은 MIT 라이선스 하에 배포됩니다.