Waylish/skillopt-skill-writer

skillopt-skill-writer은(는) 무엇을 하나요?

이중 언어 SkillOpt 기반 Codex 스킬 라이터. SKILL.md 생성, 검증 게이트, 범위 편집, 에이전트 스킬 최적화를 수행합니다.

개요

이 스킬은 AI 에이전트(Codex, Claude Code, Cursor 등)에서 사용할 스킬 정의 파일(SKILL.md)을 체계적으로 작성하고 개선하는 데 도움을 줍니다. SkillOpt 방법론을 따르며, 명확한 구조와 검증 단계를 통해 고품질의 스킬 문서를 제공합니다.

주요 기능

• SKILL.md 생성: 표준 템플릿을 기반으로 일관된 스킬 정의를 자동 생성합니다.
• 검증 게이트: 생성된 문서의 필수 요소(설명, 예제, 제한사항 등)가 누락되지 않았는지 확인합니다.
• 범위 편집: 기존 스킬 파일의 특정 부분만 수정할 수 있도록 지원합니다.
• 최적화: 불필요한 내용을 제거하고, 가독성을 높이며, 에이전트 성능을 향상시킵니다.

사용법

1. 스킬 디렉토리로 이동합니다.
2. skillopt init 명령어로 기본 템플릿을 생성합니다.
3. skillopt validate 명령어로 현재 SKILL.md를 검증합니다.
4. skillopt edit <section> 명령어로 특정 섹션을 편집합니다.
5. skillopt optimize 명령어로 스킬을 최적화합니다.

요구 사항

• Node.js 18 이상
• Codex, Claude Code, Cursor 등 AI 에이전트 환경

지원 플랫폼

• Codex: CLI 기반 AI 코딩 에이전트
• Claude Code: Anthropic의 Claude 기반 에이전트
• Cursor: AI 기반 IDE

스킬 구조

my-skill/
├── SKILL.md          # 스킬 정의 파일
├── skill.json        # 스킬 메타데이터 (선택 사항)
└── src/              # 스킬 관련 소스 코드 (선택 사항)

SKILL.md 템플릿

# 스킬 이름

## 설명

한 줄 설명.

## 상세 설명

3-4 문장의 상세 설명.

## 예제

```bash
예제 명령어

제한 사항

• 제한 사항 1
• 제한 사항 2

## 검증 규칙

- `name` 필드는 필수이며, 고유해야 합니다.
- `description`은 120자 이내여야 합니다.
- `aiSummary`는 100-150자 사이여야 합니다.
- `skillMarkdown`은 필수이며, 유효한 마크다운이어야 합니다.

## 라이선스

MIT