To Skill

하나의 portable Agent Skill 원본을 작성·수정하고 Codex와 Claude Code의 노출을 안전하게 정규화한다. 호스트별 확장은 공용 원본과 분리한다.

워크플로우

저장소 지침과 기존 skill, eval, discovery 경로를 먼저 읽는다.
요청을 새 작성, 기존 수정, 다중 host 사본 정규화, host preparation으로 분류한다.
실제 파일, symlink 대상과 내용을 변경 전에 조사한다. 불명확한 경로나 충돌을 추측하지 않는다.
새 작성이나 수정이면 책임과 비책임을 한 문장으로 정하고 positive, near-miss negative와 관찰 가능한 output eval을 먼저 기록한다.
portable 원본에는 필요한 SKILL.md, references/, scripts/, assets/만 둔다. 본문은 간결한 명령형으로 쓰고 reference chain은 한 단계로 유지한다.
아래 canonical 정책과 정규화 안전 규칙을 적용한다.
요청된 host preparation만 수행하고 portable 원본과 제품별 metadata를 분리한다.
구조 validator, 관련 eval과 저장소 검증을 실행하고 변경, no-op, 충돌과 남은 작업을 구분해 보고한다.

새 스킬 작성, 책임 경계 또는 평가 tradeoff를 판단할 필요가 있을 때만 작성 원칙을 읽는다.

agents/openai.yaml, Codex invocation, MCP, plugin 또는 packaging이 요청될 때만 Codex 참고를 읽는다.