첫 번째 스킬 설치

이 수업을 마치면 할 수 있는 것

Anthropic 공식 저장소에서 스킬을 프로젝트에 설치
인터랙티브 선택 인터페이스로 필요한 스킬 선택
스킬이 어디에 설치되는지 이해 (.claude/skills/ 디렉터리)
스킬 설치 성공 여부 확인

사전 지식

이 튜토리얼은 OpenSkills 설치를 이미 완료했다고 가정합니다. 아직 설치하지 않았다면 먼저 설치 단계를 완료해 주세요.

현재 겪고 있는 어려움

방금 OpenSkills를 설치했지만 다음과 같은 상황일 수 있습니다:

스킬을 어디서 찾아야 할지 모름: GitHub에 많은 스킬 저장소가 있지만 어느 것이 공식인지 모름
스킬 설치 방법을 모름: install 명령어가 있다는 것만 알고 사용법을 모름
잘못된 위치에 설치할까 걱정: 스킬이 시스템 전역에 설치되어 프로젝트를 바꾸면 찾을 수 없을까 걱정

이러한 문제는 매우 흔합니다. 단계별로 해결해 보겠습니다.

언제 이 방법을 사용해야 할까

첫 번째 스킬 설치는 다음과 같은 상황에 적합합니다:

처음 OpenSkills를 사용하여 빠르게 체험하고 싶을 때
Anthropic 공식에서 제공하는 스킬(PDF 처리, Git 워크플로우 등)이 필요할 때
시스템 전역이 아닌 현재 프로젝트에서 스킬을 사용하고 싶을 때

권장 사항

처음 설치할 때는 Anthropic 공식 저장소 anthropics/skills에서 시작하는 것을 권장합니다. 이러한 스킬은 품질이 높고 검증되었습니다.

🎒 시작 전 준비

시작하기 전에 다음을 확인하세요:

[ ] OpenSkills 설치 완료
[ ] 프로젝트 디렉터리에 진입
[ ] Git 설정 완료(GitHub 저장소 복제용)

사전 확인

프로젝트 디렉터리가 없다면 연습용으로 임시 디렉터리를 만들 수 있습니다:

bash

mkdir my-project && cd my-project

핵심 아이디어: GitHub에서 스킬 설치

OpenSkills는 GitHub 저장소에서 스킬을 설치하는 것을 지원합니다. 설치 과정은 다음과 같습니다:

[저장소 지정] → [임시 디렉터리에 복제] → [SKILL.md 찾기] → [인터랙티브 선택] → [.claude/skills/에 복사]

핵심 포인트:

owner/repo 형식으로 GitHub 저장소 지정
도구가 자동으로 저장소를 임시 디렉터리에 복제
SKILL.md가 포함된 모든 하위 디렉터리 찾기
인터랙티브 인터페이스로 설치할 스킬 선택
스킬이 프로젝트의 .claude/skills/ 디렉터리에 복사

따라해 보세요

1단계: 프로젝트 디렉터리로 이동

먼저 개발 중인 프로젝트 디렉터리로 이동하세요:

bash

cd /path/to/your/project

왜 이 작업인가요

OpenSkills는 기본적으로 스킬을 프로젝트의 .claude/skills/ 디렉터리에 설치합니다. 이렇게 하면 스킬을 프로젝트 버전 관리와 함께 관리할 수 있고 팀원들과 공유할 수 있습니다.

다음을 볼 수 있어야 합니다:

프로젝트 디렉터리는 다음 중 하나를 포함해야 합니다:

.git/ (Git 저장소)
package.json (Node.js 프로젝트)
기타 프로젝트 파일

권장 사항

새 프로젝트라도 먼저 Git 저장소를 초기화하는 것이 좋습니다. 그러면 스킬 파일을 더 잘 관리할 수 있습니다.

2단계: 스킬 설치

다음 명령어를 사용하여 Anthropic 공식 스킬 저장소에서 스킬을 설치하세요:

bash

npx openskills install anthropics/skills

왜 이 작업인가요

anthropics/skills는 Anthropic에서 공식적으로 관리하는 스킬 저장소로, 고품질의 스킬 예제가 포함되어 있어 처음 체험하기에 적합합니다.

다음을 볼 수 있어야 합니다:

명령어가 인터랙티브 선택 인터페이스를 시작합니다:

Installing from: anthropics/skills
Location: project (.claude/skills)
Default install is project-local (./.claude/skills). Use --global for ~/.claude/skills.

Cloning repository...
✓ Repository cloned

Found 4 skill(s)

? Select skills to install:
❯ ◉ pdf (24 KB)    Comprehensive PDF manipulation toolkit for extracting text and tables...
  ◯ git-workflow (12 KB)   Git workflow: Best practices for commits, branches, and PRs...
  ◯ check-branch-first (8 KB)    Git workflow: Always check current branch before making changes...
  ◯ skill-creator (16 KB)   Guide for creating effective skills...

<Space> 선택  <a> 전체 선택  <i> 반전 선택  <Enter> 확인

작업 가이드:

┌─────────────────────────────────────────────────────────────┐
│  작업 설명                                                    │
│                                                             │
│  1단계         2단계          3단계                        │
│  커서 이동   →   Space로 선택   →   Enter로 확인            │
│                                                             │
│  ○ 미선택           ◉ 선택됨                              │
└─────────────────────────────────────────────────────────────┘

다음을 볼 수 있어야 합니다:
- 커서가 위아래로 이동 가능
- Space 키로 선택 상태 전환 (○ ↔ ◉)
- Enter 키로 설치 확인

3단계: 스킬 선택

인터랙티브 인터페이스에서 설치할 스킬을 선택하세요.

예시:

PDF 처리 스킬을 설치한다고 가정해 보겠습니다:

? Select skills to install:
❯ ◉ pdf (24 KB)    ← 이것 선택
  ◯ git-workflow (12 KB)
  ◯ check-branch-first (8 KB)
  ◯ skill-creator (16 KB)

작업:

커서 이동: 위아래 방향키를 사용하여 pdf 줄로 이동
스킬 선택: Space 키를 눌러 앞이 ◉이고 ◯가 아닌지 확인
설치 확인: Enter 키를 눌러 설치 시작

다음을 볼 수 있어야 합니다:

✅ Installed: pdf
   Location: /path/to/your/project/.claude/skills/pdf

Skills installed to: /path/to/your/project/.claude/skills/

Next steps:
  → Run openskills sync to generate AGENTS.md with your installed skills
  → Run openskills list to see all installed skills

고급 작업

한 번에 여러 스킬을 설치하려면:

필요한 각 스킬을 Space 키로 선택(여러 개 ◉)
<a>로 모든 스킬 선택
<i>로 현재 선택 반전

4단계: 설치 확인

설치가 완료된 후 스킬이 프로젝트 디렉터리에 성공적으로 설치되었는지 확인하세요.

디렉터리 구조 확인:

bash

ls -la .claude/skills/

다음을 볼 수 있어야 합니다:

.claude/skills/
└── pdf/
    ├── SKILL.md
    ├── .openskills.json
    ├── references/
    │   ├── pdf-extraction.md
    │   └── table-extraction.md
    └── scripts/
        └── extract-pdf.js

핵심 파일 설명:

파일	용도
`SKILL.md`	스킬의 주요 내용과 지침
`.openskills.json`	설치 메타데이터(소스 기록, 업데이트용)
`references/`	참조 문서 및 상세 설명
`scripts/`	실행 가능한 스크립트

스킬 메타데이터 보기:

bash

cat .claude/skills/pdf/.openskills.json

다음을 볼 수 있어야 합니다:

json

{
  "source": "anthropics/skills",
  "sourceType": "git",
  "repoUrl": "https://github.com/anthropics/skills",
  "subpath": "pdf",
  "installedAt": "2026-01-24T10:30:00.000Z"
}

이 메타데이터 파일은 스킬의 소스 정보를 기록합니다. 나중에 openskills update를 사용할 때 필요합니다.

체크포인트 ✅

위 단계를 완료한 후 다음을 확인하세요:

[ ] 명령줄에 인터랙티브 선택 인터페이스가 표시됨
[ ] 최소 하나의 스킬이 성공적으로 선택됨(앞에 ◉ 표시)
[ ] 설치 성공, ✅ Installed: 메시지 표시
[ ] .claude/skills/ 디렉터리가 생성됨
[ ] 스킬 디렉터리에 SKILL.md 파일이 포함됨
[ ] 스킬 디렉터리에 .openskills.json 메타데이터 파일이 포함됨

위 확인 항목이 모두 통과하면 축하합니다! 첫 번째 스킬 설치가 완료되었습니다.

일반적인 문제 해결

문제 1: 저장소 복제 실패

현상:

✗ Failed to clone repository
fatal: repository 'https://github.com/anthropics/skills' not found

원인:

네트워크 연결 문제
GitHub 저장소 주소 오류

해결 방법:

네트워크 연결 확인: ping github.com
저장소 주소가 올바른지 확인(owner/repo 형식)

문제 2: 인터랙티브 선택 인터페이스가 나타나지 않음

현상:

명령어가 모든 스킬을 즉시 설치하고 선택 인터페이스가 나타나지 않음

원인:

저장소에 SKILL.md 파일이 하나만 있음(단일 스킬 저장소)
-y 또는 --yes 플래그 사용(선택 건너뛰기)

해결 방법:

단일 스킬 저장소인 경우 정상적인 동작
선택이 필요한 경우 -y 플래그 제거

문제 3: 권한 오류

현상:

Error: EACCES: permission denied, mkdir '.claude/skills'

원인:

현재 디렉터리에 쓰기 권한이 없음

해결 방법:

디렉터리 권한 확인: ls -la
sudo 사용 또는 권한이 있는 디렉터리로 변경

문제 4: SKILL.md를 찾을 수 없음

현상:

Error: No SKILL.md files found in repository

원인:

저장소에 형식에 맞는 스킬 파일이 없음

해결 방법:

저장소가 스킬 저장소인지 확인
저장소 내 디렉터리 구조 확인

수업 요약

이 수업을 통해 다음을 배웠습니다:

openskills install anthropics/skills 사용하여 공식 저장소에서 스킬 설치
인터랙티브 인터페이스에서 스킬 선택, Space 키로 선택하고 Enter로 확인
스킬이 .claude/skills/ 디렉터리에 설치되며 SKILL.md와 메타데이터 포함
설치 성공 확인, 디렉터리 구조와 파일 내용 검사

핵심 명령어:

명령어	역할
`npx openskills install anthropics/skills`	공식 저장소에서 스킬 설치
`ls .claude/skills/`	설치된 스킬 보기
`cat .claude/skills/<name>/.openskills.json`	스킬 메타데이터 보기

다음 수업 미리보기

다음 수업에서는 **스킬 사용**을 학습합니다.
다음을 배울 수 있습니다:
openskills read 명령어를 사용하여 스킬 내용 읽기
AI 에이전트가 스킬을 컨텍스트로 로드하는 방법 이해
스킬 검색의 4단계 우선순위 순서 마스터

스킬 설치는 첫 단계입니다. 이제 AI 에이전트가 이러한 스킬을 사용하는 방법을 이해해야 합니다.

부록: 소스 코드 참조

클릭하여 소스 코드 위치 보기

업데이트 시간: 2026-01-24

기능	파일 경로	줄 번호
설치 명령어 진입점	`src/commands/install.ts`	83-183
설치 위치 판단(project vs global)	`src/commands/install.ts`	84-92
GitHub shorthand 파싱	`src/commands/install.ts`	131-143
저장소 복제	`src/commands/install.ts`	155-169
재귀적 스킬 검색	`src/commands/install.ts`	358-373
인터랙티브 선택 인터페이스	`src/commands/install.ts`	427-455
스킬 복사 및 설치	`src/commands/install.ts`	461-486
공식 스킬 목록(충돌 경고)	`src/utils/marketplace-skills.ts`	1-25

핵심 함수:

installFromRepo() - 저장소에서 스킬 설치, 인터랙티브 선택 지원
installSpecificSkill() - 지정된 하위 경로의 스킬 설치
installFromLocal() - 로컬 경로에서 스킬 설치
warnIfConflict() - 스킬 충돌 확인 및 경고

핵심 상수:

ANTHROPIC_MARKETPLACE_SKILLS - Anthropic Marketplace의 스킬 목록, 충돌 경고용

첫 번째 스킬 설치 ​

이 수업을 마치면 할 수 있는 것 ​

현재 겪고 있는 어려움 ​

언제 이 방법을 사용해야 할까 ​

🎒 시작 전 준비 ​

핵심 아이디어: GitHub에서 스킬 설치 ​

따라해 보세요 ​

1단계: 프로젝트 디렉터리로 이동 ​

2단계: 스킬 설치 ​

3단계: 스킬 선택 ​

4단계: 설치 확인 ​

체크포인트 ✅ ​

일반적인 문제 해결 ​

문제 1: 저장소 복제 실패 ​

문제 2: 인터랙티브 선택 인터페이스가 나타나지 않음 ​

문제 3: 권한 오류 ​

문제 4: SKILL.md를 찾을 수 없음 ​

수업 요약 ​

다음 수업 미리보기 ​

부록: 소스 코드 참조 ​

첫 번째 스킬 설치

이 수업을 마치면 할 수 있는 것

현재 겪고 있는 어려움

언제 이 방법을 사용해야 할까

🎒 시작 전 준비

핵심 아이디어: GitHub에서 스킬 설치

따라해 보세요

1단계: 프로젝트 디렉터리로 이동

2단계: 스킬 설치

3단계: 스킬 선택

4단계: 설치 확인

체크포인트 ✅

일반적인 문제 해결

문제 1: 저장소 복제 실패

문제 2: 인터랙티브 선택 인터페이스가 나타나지 않음

문제 3: 권한 오류

문제 4: SKILL.md를 찾을 수 없음

수업 요약

다음 수업 미리보기

부록: 소스 코드 참조