To-Spec 스킬
합의된 결정을 명세로 기록하고 설정된 이슈 도구에 게시합니다.
커뮤니티 · Matt Pocock| 작성자 | Matt Pocock |
|---|---|
| 라이선스 | MIT |
| 소스 | mattpocock/skills · GitHub의 SKILL.md |
| 프로젝트 웹사이트 | www.aihero.dev/skills-to-spec |
| 작동 환경 | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| 소스 확인 날짜 |
to-spec은 결정된 대화를 명세로 종합합니다. 코드, 용어집, 아키텍처 결정을 사용하며 요구 사항 인터뷰를 다시 하지 않습니다.
테스트 경계를 확인하고 사용자 이야기·범위를 기록해 설정된 도구에 명세를 게시합니다. 로컬 설정이면 Markdown도 지원합니다.
스킬의 SKILL.md에서: ## Out of Scope
하는 일
- 대화와 관련 프로젝트 결정을 읽습니다.
- 테스트 경계를 확인하고 명세를 종합합니다.
- 설정된 분류 라벨로 이슈 도구에 게시합니다.
얻을 수 있는 결과물
- 문제, 해결책, 이야기, 구현 결정, 테스트, 제외 범위를 담은 명세.
이럴 때 사용하세요
- 여러 에이전트 세션의 작업을 위해 합의된 결정을 보존할 때.
이럴 때는 맞지 않습니다
- 미정 요구 사항이나 한 세션으로 끝나는 작은 변경.
필요한 것
- 프로젝트 맥락의 에이전트와 setup-matt-pocock-skills 이슈 도구 설정.
- 원격 도구는 인증과 게시 권한이 필요합니다. 로컬 Markdown은 원격 서비스가 불필요합니다.
스킬에 들어 있는 파일
| 파일 또는 폴더 | 용도 |
|---|---|
SKILL.md | 명세 서식, 테스트 경계 확인, 이슈 게시. |
2026-11-19 기준 저장소에 있는 라이선스: MIT.
예시 프롬프트
설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.
- /to-spec — 새 요구 없이 합의한 계정 내보내기 설계를 종합하세요.
- /to-spec — 범위 밖 결정을 보존하고 테스트 경계를 먼저 확인하세요.
- /to-spec #42 — 결정된 지도를 구현 가능한 명세로 바꾸세요.
to-spec 설치 방법
설치와 권한
설치 후 setup-matt-pocock-skills로 이슈 도구와 라벨을 설정하세요. 생성된 설정을 사용 전 검토하세요.
수동 호출이며 disable-model-invocation은 true입니다. 대상과 권한을 확인하세요. 이 사이트는 이슈를 만들지 않습니다.
스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.
Claude Code: 스킬 폴더에 복사
이 컴퓨터의 모든 프로젝트에서 쓰려면 스킬 폴더를 ~/.claude/skills/에 넣고, 저장소에서 함께 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요(커밋하세요).
git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p ~/.claude/skills
cp -R skills/skills/engineering/to-spec ~/.claude/skills/Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /to-spec를 입력하거나 작업을 설명하면 됩니다.
Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.
Codex, Gemini CLI, Cursor, GitHub Copilot
이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .agents/skills/이므로, 아래 명령은 스킬을 그곳에 복사합니다.
git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p .agents/skills
cp -R skills/skills/engineering/to-spec .agents/skills/| 에이전트 | 프로젝트 폴더 | 사용자 폴더 | 참고 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | $를 입력하거나 /skills를 실행해 스킬을 고르세요. 작업이 맞으면 Codex가 스스로 스킬을 고르기도 합니다. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 또는 gemini skills install <git URL> --path <folder> --consent로 Git에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. Antigravity는 프로젝트에서는 .agents/skills/를, 사용자용으로는 ~/.gemini/config/skills/를 사용합니다. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Agent 채팅에서 /를 입력해 스킬을 고르세요. Cursor는 Claude Code의 .claude/skills/ 폴더도 읽습니다. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Copilot CLI, 클라우드 에이전트, 그리고 VS Code, Visual Studio, JetBrains의 에이전트 모드에서 작동합니다(IDE 지원은 버전에 따라 다름). 또는 gh skill install OWNER/REPOSITORY SKILL를 실행하세요(공개 프리뷰, GitHub CLI 2.90.0 이상). |
이 단계의 출처
2026-11-14에 각 업체의 문서와 대조해 확인했습니다:
이미 내린 결정의 기록
프로젝트 용어와 실제 제외 범위를 보존하세요. 빈 부분을 채우려고 결정을 만들지 마세요.
여러 세션 작업은 to-tickets로 넘기세요. 같은 맥락에서 이어가면 큰 이슈 본문을 다시 받지 않아도 됩니다.
to-spec에 관한 질문
인터뷰를 하나요?
새 요구 인터뷰는 하지 않지만 테스트 경계가 기대에 맞는지는 확인합니다.
GitHub가 필수인가요?
아니요. 로컬 Markdown이나 지원 원격 도구를 설정할 수 있습니다.
to-prd와 같은 명령인가요?
작성자가 to-spec으로 이름을 바꿨습니다. 현재 설치 이름을 쓰세요.
ready-for-agent가 원치 않는 작업을 시작할 수 있나요?
네. 폴링 에이전트가 상위 명세를 작업으로 볼 수 있습니다. 해당 에이전트 선택에서 명시적으로 제외하세요.
더 많은 AI 스킬
관련 스킬
To-Tickets 스킬
커뮤니티 · Matt Pocock명세를 시연 가능한 수직 단위로 나누고 차단 의존성을 명시합니다.Writing Plans 스킬
커뮤니티 · Jesse Vincent / Prime Radiant승인 설계를 인터페이스와 검증이 있는 검토 가능한 작업으로 전환합니다.Brainstorming 스킬
커뮤니티 · Jesse Vincent / Prime Radiant구현 전에 초기 아이디어를 합의된 설계로 정리합니다.Subagent-Driven Development 스킬
커뮤니티 · Jesse Vincent / Prime Radiant새 구현자, 범위 제한 검토, 작업 기록으로 승인 계획을 실행합니다.n8n 자체 호스팅 스킬
커뮤니티 · Romuald CzłonkowskiDocker 기반 n8n을 배포·유지하며 Caddy HTTPS, 비공개 서비스와 검증된 백업을 구성합니다.n8n Code JavaScript 스킬
커뮤니티 · Romuald Członkowski실행 모드에 맞는 데이터 접근과 반환으로 n8n JavaScript Code 노드를 작성하거나 디버깅합니다.