본문으로 건너뛰기

Declarative Skill Manifest

skill 컬렉션을 코드로 정의하세요 — 단일 manifest 파일로 설치하고, 공유하고, 설정을 재현합니다.

언제 중요한가요?

여러 머신에서 재현 가능한 skill 설정, 단일 명령으로 팀 온보딩, 또는 오픈소스 프로젝트 부트스트랩이 필요할 때 declarative manifest를 사용하세요.

Skill Manifest란?​

skill manifest는 skill 컬렉션의 이식 가능한 선언입니다. skill을 하나씩 수동으로 설치하는 대신, manifest 파일에 나열하고 skillshare install을 실행하면 모든 것을 갖출 수 있습니다.

manifest 위치는 mode에 따라 다릅니다:

ModeManifest 위치커밋 가능?
Project.skillshare/config.yaml (skills: 섹션)예 — 팀과 공유하려면 커밋
Global~/.config/skillshare/skills/.metadata.json아니오 — 개인 머신 상태

Project Mode Manifest​

project mode에서는 skills:가 targets:와 함께 config.yaml에 존재합니다:

# .skillshare/config.yaml
targets:
  - claude
  - cursor

skills:
  - name: react-best-practices
    source: anthropics/skills/skills/react-best-practices
    group: frontend
  - name: _team-skills
    source: my-org/shared-skills
    tracked: true
  - name: commit
    source: anthropics/skills/skills/commit

이 파일은 git에 커밋됩니다 — 팀원이 repo를 clone하고 skillshare install -p를 실행하면 나열된 모든 skill이 설치됩니다.

Global Mode Manifest​

global mode에서는 skill 기록이 .metadata.json(중앙화된 메타데이터 저장소)에 저장됩니다. 이 파일에는 런타임 추적 데이터(해시, 타임스탬프)도 포함되며 자동으로 관리됩니다.

동작 방식​

Manifest로부터 설치하기​

인자 없이 skillshare install을 실행하면 manifest를 읽고 나열된 모든 skill을 설치합니다:

# Global mode — installs all skills from ~/.config/skillshare/skills/.metadata.json
skillshare install

# Project mode — installs all skills from .skillshare/config.yaml skills: section
skillshare install -p

# Preview without installing
skillshare install --dry-run

이미 존재하는 skill은 자동으로 건너뜁니다.

자동 조정(Reconciliation)​

manifest는 실제 skill 컬렉션과 동기화 상태를 유지합니다:

  • skillshare install <source> — 설치된 skill을 manifest에 자동으로 추가
  • skillshare uninstall <name>... — manifest에서 해당 항목을 자동으로 제거

project mode에서는 config.yaml이 업데이트됩니다. global mode에서는 .metadata.json이 업데이트됩니다. manifest를 수동으로 편집할 필요는 없습니다 (물론 할 수는 있습니다).

Skill 항목 필드​

skills: 목록의 각 항목에는 다음 필드가 있습니다:

필드필수설명
name예skill 이름 (source 안의 디렉터리 이름)
source예install 소스 (GitHub shorthand, HTTPS URL, SSH URL)
tracked아니오tracked repository의 경우 true (.git 보존)
group아니오하위 디렉터리 경로 (예: frontend 또는 frontend/vue). install 중 --into에 해당.

사용 사례​

개인 설정​

여러 머신에서 개인 skill 컬렉션을 유지하세요:

# On machine A — skills are already installed and tracked in registry
skillshare push   # backup config + registry to git

# On machine B — fresh machine
skillshare pull   # restore config + registry from git
skillshare install  # install all skills from manifest
skillshare sync   # distribute to all targets

팀 온보딩​

새 팀원이 한 명령으로 동일한 AI 컨텍스트를 얻습니다:

# .skillshare/config.yaml skills: section is committed to the repo
git clone <project-repo>
cd <project-repo>
skillshare install -p   # installs all declared skills
skillshare sync -p      # links to project targets

오픈소스 부트스트랩​

프로젝트 유지관리자가 config.yaml에 권장 skill을 선언합니다:

# .skillshare/config.yaml
targets:
  - claude
  - cursor

skills:
  - name: react-best-practices
    source: anthropics/skills/skills/react-best-practices
    group: frontend
  - name: commit
    source: anthropics/skills/skills/commit
Group 필드와 --into

--into로 설치하면 group이 자동으로 기록됩니다:

skillshare install anthropics/skills/skills/pdf --into frontend -p
# config.yaml will contain: name: pdf, group: frontend

skillshare install -p(인자 없이)를 실행하면 manifest로부터 동일한 디렉터리 구조가 재생성됩니다.

기여자는 clone한 뒤 skillshare install -p를 실행하여 즉시 프로젝트 전용 AI 컨텍스트를 얻습니다.

워크플로우 요약​

Project mode:
1. Install skills normally      →  config.yaml skills: auto-updates
2. Commit config.yaml via git   →  portable across team members
3. Run `skillshare install -p`  →  reproduce on clone
4. Run `skillshare sync`        →  distribute to all targets

Global mode:
1. Install skills normally      →  .metadata.json auto-updates
2. Push/pull config via git     →  portable across machines
3. Run `skillshare install`     →  reproduce on new machine
4. Run `skillshare sync`        →  distribute to all targets

Extras 설정​

skill 외에도, config.yaml은 extras를 선언할 수 있습니다 — 별도 디렉터리로 sync되는 skill이 아닌 리소스(rules, commands, prompts)입니다. Extras는 config.yaml의 extras: 섹션에서 설정됩니다 (global과 project 모두):

extras:
  - name: rules
    targets:
      - path: ~/.claude/rules
      - path: ~/.cursor/rules
        mode: copy

자세한 내용은 sync extras를 참고하세요.

관련 문서​