with one click
ouroboros-setup
// Ouroboros 플러그인 설치 + 첫 사용. 인터뷰로 내 일을 명세화하고 에이전트로 만든다. "/ouroboros-setup" 또는 "오우로보로스 설치", "ouroboros 셋업" 요청에 사용.
// Ouroboros 플러그인 설치 + 첫 사용. 인터뷰로 내 일을 명세화하고 에이전트로 만든다. "/ouroboros-setup" 또는 "오우로보로스 설치", "ouroboros 셋업" 요청에 사용.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | ouroboros-setup |
| description | Ouroboros 플러그인 설치 + 첫 사용. 인터뷰로 내 일을 명세화하고 에이전트로 만든다. "/ouroboros-setup" 또는 "오우로보로스 설치", "ouroboros 셋업" 요청에 사용. |
Ouroboros는 "막연한 내 일"을 인터뷰로 끌어내서 PRD/Seed로 만들고, AI가 그 명세대로 실행하게 만드는 도구. 이 스킬은 설치 + 첫 호출까지만 다룬다. 인터뷰/Seed 작성은 워크샵에서 라이브로.
Q00/ouroboros (GitHub 공개 repo)ouroboros@ouroborosclaude 명령어 동작)한 단계가 완료될 때까지 다음 단계를 시작하지 않는다. 막히면 Block 6(트러블슈팅)으로 가고, 그래도 안 풀리면 슬랙
#ai-native-camp.
claude --version
최소 요구: 2.0.0 이상. (Plugin 시스템은 2.x부터 안정 동작)
AskUserQuestion({
"questions": [{
"question": "claude --version 출력이 어떻게 나오나요?",
"header": "버전 확인",
"options": [
{"label": "2.0 이상이다", "description": "Block 2로"},
{"label": "1.x 또는 더 낮다", "description": "업그레이드 필요"},
{"label": "claude 명령어 자체가 없다", "description": "Claude Code 신규 설치 필요"}
]
}]
})
Mac / Linux
npm i -g @anthropic-ai/claude-code@latest
# 또는 pnpm
pnpm add -g @anthropic-ai/claude-code@latest
# 또는 Homebrew (Mac)
brew upgrade claude-code
Windows (PowerShell)
npm i -g @anthropic-ai/claude-code@latest
→ npm이 없다고 나오면 먼저 Node.js 설치 (LTS 버전) 후 PowerShell 완전 종료 → 재시작 → 위 명령 다시.
Claude Code 켜고:
/plugin marketplace add Q00/ouroboros
✓ Added marketplace "ouroboros"
/plugin marketplace list 로 등록됐는지 확인. ouroboros 가 목록에 보이면 OK.같은 Claude Code 세션에서:
/plugin install ouroboros@ouroboros
→ 설치 메시지 + 의존성 자동 설치 안내가 나옴. 이어서:
/reload-plugins
이러면 재시작 없이 바로 활성화됨. (/reload-plugins 가 "loaded N plugins" 같은 카운트 출력하면 성공)
같은 세션에서 (재시작 안 해도 됨):
/ouroboros:welcome
🐍 Welcome to Ouroboros
Stop prompting. Start specifying.
Available commands:
• /ouroboros:tutorial - 5-min hands-on
• /ouroboros:interview - clarify a vague task
• /ouroboros:seed - generate a spec
...
스킬 목록에 ouroboros:welcome, ouroboros:interview, ouroboros:seed, ouroboros:tutorial 같은 항목이 보이면 OK.
안 보이면 → Block 6.
AskUserQuestion({
"questions": [{
"question": "지금 ouroboros 어디까지 해볼까요?",
"header": "첫 사용",
"options": [
{"label": "설치만 끝냄, 워크샵에서 실습", "description": "발표날 호스트와 같이 인터뷰 진행"},
{"label": "튜토리얼 한 번 돌려보고 싶음 (추천)", "description": "/ouroboros:tutorial 실행 — 5~10분"},
{"label": "바로 인터뷰 시작", "description": "/ouroboros:interview 로 내 일 명세화"}
]
}]
})
추천: 워크샵 전 /ouroboros:tutorial 한 번 돌려두면 발표 날 진도 훨씬 빠름.
/plugin 명령어가 없다고 나옴claude --version → 2.0 미만이면 Block 1 업그레이드which claude — 설치 경로 확인. /usr/local/bin/claude 가 아니면 PATH 충돌 의심. npm root -g 하위 경로 우선where.exe claude 실행. 여러 경로 잡히면 구버전 우선일 수 있음npm uninstall -g @anthropic-ai/claude-code → npm i -g @anthropic-ai/claude-code@latest)curl -s https://api.github.com/repos/Q00/ouroboros | head -5 — repo 정보 나오면 GitHub 자체는 OKInvoke-WebRequest https://api.github.com/repos/Q00/ouroboros | Select-Object -First 1 StatusCode — 200 이면 OKGH_TOKEN) 설정/ouroboros:welcome 호출했는데 스킬 목록에 안 보임/reload-plugins 한 번 더 실행cat ~/.claude/settings.json | grep ouroborosGet-Content $env:USERPROFILE\.claude\settings.json | Select-String ouroboros"ouroboros@ouroboros": true 가 보여야 함. 없으면 Block 3 재시도exit) 후 새 세션. Windows VSCode에서 쓰는 분은 VSCode 자체 재시작/plugin uninstall ouroboros@ouroboros
/plugin marketplace update ouroboros
/plugin install ouroboros@ouroboros
/reload-plugins
설치 다 끝났으면 슬랙 #ai-native-camp 에 이 한 줄 보고:
✅ /ouroboros-setup 완료 — [내 이름] / [Mac or Windows]
설치 완료. Ouroboros가 준비됐습니다.
기억할 것 3개:
1. ouroboros:interview — 막연한 내 일을 끌어낸다
2. ouroboros:seed — 인터뷰 결과를 실행 가능한 명세로
3. ouroboros:run — 명세대로 AI가 실행
워크샵 전 /ouroboros:tutorial 한 번 돌려보면
발표 날 진도가 훨씬 빨라집니다.
⚠️ 이건 오류가 아니라 정상 동작.
처음 인터뷰는 30분 이상 걸릴 수 있음. Ouroboros가 세션 상태 보존하니 휴식 후 이어가도 됨. 짧게 끝내고 싶으면 워크샵 라이브에서 호스트 가이드 흐름 따라하기.
#ai-native-camp 에 화면 캡처 + 에러 메시지 공유 → 호스트가 직접 봄Q00/ouroboros 는 GitHub 공개 repo. 별도 권한 부여 필요 없음