시작하기
핵심 용어, 설치 방식 선택, 처음 실행하고 적용 여부를 확인하는 방법
목표: 내 AI 도구에 맞는 설치 방법을 선택하고, 스킬 하나가 읽히는 것을 확인합니다. 아직 Git이나 Python을 몰라도 설치부터 시작할 수 있습니다.
먼저 알아둘 다섯 가지#
| 용어 | 뜻 | 이 저장소에서 찾는 곳 |
|---|---|---|
| 스킬(Skill) | 특정 일을 수행하는 방법과 사용할 상황을 적은 문서 | skills/스킬이름/SKILL.md |
| 커맨드(Command) | 사람이 직접 선택해 시작하는 작업 절차 | commands/의 Markdown 파일 |
| 에이전트(Agent) | 역할과 사용할 도구가 정해진 작업자 정의 | agents/ |
| 규칙(Rule) | 작업할 때 참조하는 공통 약속 | rules/ |
| 플러그인(Plugin) | 위 파일과 메타데이터를 묶은 배포 단위 | plugins/cc-이름/ |
스킬의 description은 AI가 언제 이 스킬을 읽을지 판단하는 단서입니다.
자동 선택이 가능해도 반드시 발동한다는 뜻은 아닙니다. 사용 도구의 스킬 목록과 실행 기록으로 확인하세요.
커맨드·에이전트·규칙을 읽는 방식도 도구와 설치 방식에 따라 다릅니다.
명령은 어디에 입력하나요?#
-
터미널:
git,python3,bash,claude처럼 시작하는 명령을 입력합니다. -
AI 채팅: 자연어 요청이나
/로 시작하는 커맨드를 입력합니다. 터미널에/cc-dev:go를 입력하는 것이 아닙니다. -
저장소 루트:
README.md,plugins/,scripts/가 보이는 폴더입니다. 수정·검증 실습에서는 여기가 기준입니다. -
~: 내 사용자 홈 폴더입니다.~/.claude같은 점으로 시작하는 폴더는 파일 탐색기에서 숨겨질 수 있습니다.
이 가이드의 셸 명령은 macOS/Linux의 Bash 또는 zsh 기준입니다. Windows에서는 WSL 터미널 안에 Git·Python·사용할 AI CLI를 준비하고 그 환경에서 실행하세요. WSL의 홈 폴더와 Windows 앱의 설정 폴더는 별개입니다.
내 도구에 맞는 설치 선택#
자주 쓰는 명령은 대표 명령에서 먼저 고르세요. 제품 제작·Figma 구현·기존 기능 개발 중 무엇을 시작할지 정하려면 워크플로우 가이드를 확인하세요. 작게 설치하고 싶다면 경량 프리셋과 전환 안내를 참고하세요.
| 사용 환경 | 시작 방법 | 설치되는 범위 / 확인할 점 |
|---|---|---|
| Claude Code | 공개 설치 스크립트 | 플러그인 묶음. GitHub 인증 없이 설치 가능 |
| Claude Desktop / Web | ZIP 다운로드 후 업로드 | 다운로드 뒤 앱의 스킬 업로드가 필요. Code의 CLI/MCP 작업이 그대로 동작하는 것은 아님 |
| 여러 AI 도구에서 스킬만 사용 | 아래 Agent Skills | SKILL.md 중심. 플러그인의 커맨드·에이전트·규칙은 자동 등록되지 않음 |
| Codex CLI | 아래 Codex | Codex 플러그인 메타데이터와 공통 스킬. Claude 전용 커맨드를 자동 등록하지 않음 |
| OpenCode | 아래 OpenCode | 원본을 네이티브 스킬·에이전트·커맨드 구조로 변환. MCP는 별도 활성화 확인 |
| Orca | 아래 Orca | 앱의 플러그인 소스/설치 관리 사용 |
| OpenClaude | 아래 OpenClaude | 마켓플레이스와 사용자 범위 플러그인 설치 |
원격 Git 저장소로 설치·기여하려면 coco-de/skills 읽기 권한이 필요합니다.
공개 문서와 공개 다운로드는 GitHub 인증 없이 이용할 수 있습니다.
GitHub 권한 확인 (원격 저장소를 쓰는 경우)#
터미널 · 아무 폴더에서: gh는 GitHub CLI 설치 안내로 준비합니다.
gh auth login
gh auth status
gh repo view coco-de/skills --json name
정상 결과: 로그인 계정이 표시되고 마지막 명령이 {"name":"skills"}를 반환합니다.
인증은 성공했는데 저장소를 못 찾는다면 접근 권한을 요청하세요.
Agent Skills#
준비물: Node.js/npm(npx), Git, 원격 저장소 접근 권한.
터미널 · 아무 폴더에서:
npx skills add https://github.com/coco-de/skills --skill cocode-compass --global
npx skills list --global
설치 화면에서 사용할 에이전트를 선택합니다. --global은 사용자 범위 설치입니다.
명령을 실행할 프로젝트에만 설치하려면 그 프로젝트 폴더에서 --global을 빼세요.
정상 결과: 목록에 cocode-compass가 나타납니다. 새 AI 세션에서 아래 확인 요청을 사용하세요.
플러그인 전체가 필요한 워크플로는 스킬만 설치하는 이 경로로 충분하지 않을 수 있습니다.
Codex#
준비물: codex plugin을 지원하는 Codex CLI, gh, git, python3, GitHub 인증.
터미널 · 아무 폴더에서:
gh api repos/coco-de/skills/contents/scripts/install-codex.sh --jq .content | base64 --decode | bash
codex plugin marketplace list --json
codex plugin list --json --marketplace cocode-skills --available
이 스크립트는 전체 플러그인을 설치/갱신합니다. 정상 결과: cocode-skills 마켓플레이스와
설치 상태가 보입니다. Codex를 다시 열어 확인하세요.
Orca에서 실행한다면 계정별 CODEX_HOME 때문에 일반 터미널과 목록이 다를 수 있습니다.
등록이 사라지면 문제 해결을 먼저 확인하세요.
OpenCode#
준비물: OpenCode, Python 3.10 이상, rsync, PyYAML, 원격 설치 시 gh·git·인증.
PyYAML은 첫 수정 실습의 가상환경 준비로 설치할 수 있습니다.
터미널 · 아무 폴더에서:
gh api repos/coco-de/skills/contents/scripts/install-opencode.sh --jq .content | base64 --decode | bash
정상 결과: 변환된 스킬·에이전트·커맨드 수와 설치 위치가 출력됩니다.
산출물은 ~/.config/opencode/cocode-skills/에 있습니다.
같은 OpenCode 설정 폴더의 skills/, agents/, commands/에 연결됩니다.
사용자 파일과 이름이 겹치면 중단하므로, 해당 파일을 확인한 뒤 해결합니다.
OpenCode를 재시작하세요. MCP는 설치 트리의 MCP_SETUP.md를 따라 설정합니다.
설정의 모델 등 기존 사용자 값은 유지하며 MCP 항목을 병합합니다.
Orca#
앱의 설정 → 플러그인 → 소스 관리에서 아래 소스를 추가하고 새로고침한 뒤 CoCode Skills를 설치합니다.
Git URL: https://github.com/coco-de/skills.git
Git ref: main
정상 결과: 설치한 플러그인과 제공 스킬이 앱 목록에 나타납니다. 새 에이전트 세션에서 확인하세요.
로컬 수정을 시험할 때는 플러그인 화면의 개발 → 경로 추가에서 자신이 체크아웃한 저장소 루트를 선택합니다.
Orca용 orca-marketplace.json과 Codex CLI용 마켓플레이스는 서로 다른 등록 경로입니다.
OpenClaude#
준비물: openclaude, GitHub 접근 가능한 로컬 체크아웃.
터미널 · 이 저장소 루트에서:
openclaude plugin marketplace add "$(pwd)" --scope user
openclaude plugin install cc-compass@cocode-skills --scope user
openclaude plugin list
정상 결과: 목록에서 cc-compass의 설치·활성화 상태를 확인할 수 있습니다.
마켓플레이스 등록과 설치에 각각 --scope user를 지정합니다. /reload-plugins 또는 재시작으로 적용합니다.
전체 설치는 저장소 README를 참고하세요.
첫 실행 확인#
설치한 AI 도구의 새 채팅에서 입력합니다.
cocode-compass 스킬을 사용해서, 코드 리뷰를 시작할 때 어떤 도구를 고르면 좋을지 알려줘.
사용한 스킬 파일 경로와 추천 이유도 보여줘. 실제 작업이나 파일 수정은 하지 마.
성공 기준: 실행 기록에 해당 SKILL.md를 읽거나 로드한 흔적이 있고,
답변에 작업에 맞는 진입점과 이유가 나옵니다. 답변이 그럴듯하다는 이유만으로 설치 성공이라 판단하지 마세요.
파일을 못 찾거나 목록에 없다면 문제 해결에서 설치 경로·세션·중복 설치를 점검합니다.
다음 단계: 첫 스킬 수정 — 원본 파일을 고쳐 보기 →