Skillshare CLI
Skillshare를 사용하여 소스를 유지 관리하고 구성된 대상에 리소스를 배포합니다.
요청된 작업과 관련된 참조만 읽으십시오. 라우팅 테이블은 아래에 있습니다.
설치된 버전이 이 예제와 다른 경우 skillshare <command> --help를 확인하세요.
범위 및 리소스 선택
- 글로벌 구성:
~/.config/skillshare/config.yaml. 프로젝트 구성:.skillshare/config.yaml또는skillshare/config.yaml; 둘 다 존재하는 경우 숨겨진 파일이 우선합니다. 위치가 중요할 때 자동 감지에 의존하지 말고-g또는-p를 명시적으로 사용하세요. - 스킬은
SKILL.md가 포함된 디렉터리입니다. 에이전트는 단일 Markdown 파일입니다. 소스 경로는 사용자 지정할 수 있습니다. 기본값을 가정하지 말고 구성된 소스를 사용하세요. - 추적된
skills/<known-agent>/<skill-path>/SKILL.md복사본은 저장소/접두사/접미사당 하나의 논리적 스킬을 형성합니다. 병합/복사는 정확한 에이전트 변형(별칭 및 계정agent:ID 포함)을 선택합니다. 인식하려면 두 개의 서로 다른 정식 에이전트 아래에 동일한 접미사가 필요합니다. 폴더를 공유하는 호환 대상은 에이전트 ID의 합집합을 선택합니다. 유니버설 전용 대상은 에이전트를 유추하지 않습니다. 상태는 논리적 스킬과 물리적 변형을 계산합니다. 목록 및 동기화 작업은 물리적 이름을 유지합니다. 명시적 대상/재정의 및 물리적 필터도 적용됩니다. 전체 디렉터리 심볼릭 링크 모드는 모든 변형을 노출합니다. sync.md를 참조하세요. - 에이전트에는 네이티브 에이전트 대상을 사용하세요. 확장 기능은 임의의 파일 리소스나 평탄화/내용 변환이 필요할 때 사용합니다.
extension:은 확장 기능 대상에서만 작동합니다. - 공유 메모리 노트는
memory확장 기능에 있습니다. Markdown 노트 및 읽기 지침을 관리하려면extras memory를 사용하세요.wiki/architecture.md와 같은 중첩 경로가 지원됩니다. 범위, 버전 확인 및 에이전트 설정에 대한 자세한 내용은 extras.md를 읽으세요. 세션 회고 또는 저장된 노트에 대한 꿈(Dreaming) 작업을 수행하려면 memory-review.md를 읽으세요. 호스트 에이전트가 검토를 수행합니다. Skillshare는 에이전트를 시작하거나 예약하지 않습니다. - MCP는 자체 수신 대상 및 소스 정의를 사용합니다. MCP 설정을 편집하거나 네이티브 구성을 가져오기 전에 mcp.md를 읽으세요.
해당 에이전트 노트는 Claude Code, Codex, OpenCode 및 Pi에 특화된 내용(범위 및 파일, 거부하는 이름 및 자격 증명, Pi의 내장 MCP 및
piOptions, OMP의 네이티브 MCP 및 보존된 활성화/비활성화 목록, 이식 가능한tools정책, Pi 설정을 0.22에서 업그레이드, 하나의 프로젝트에서 글로벌 서버 끄기, 하나의 구성에서 여러 폴더를 위한mcp.projects, 동기화된 스킬 폴더에 도달할 수 없는 에이전트를 위한mcp serve)를 다룹니다. - 플러그인은 네이티브 구성 요소를 함께 유지합니다. 설치, 가져오기, 동기화 선택, 업데이트 및 Claude, Codex, Cursor, Antigravity, Pi, OMP 및 OpenCode 간의 네이티브 호환성 제한 사항(pi.dev의 Pi 패키지 포함)에 대한 자세한 내용은 plugins.md를 읽으세요. 및 OMP 마켓플레이스 플러그인 및 독립형 확장 기능 선택.
- 훅은 각 에이전트의 네이티브 이벤트 맵 또는 확장/플러그인 코드를 보존합니다. 가져오기, 동기화 또는 복구 전에 hooks.md를 읽으세요.
실행 규칙
- 비대화형 입력을 선택하세요. 특정 명령에서 지원하는 이름 및 선택 플래그를 제공하세요. 일반 출력에는
--no-tui를, 지원되는 경우--json을 사용하세요. 단순히 프롬프트를 피하기 위해--force를 추가하지 마세요. 충돌을 덮어쓰거나 감사를 무시할 수 있습니다. - 미리보기를 쓰기 작업과 분리하세요. 지원되는 경우
--dry-run을 사용하세요. 스킬 또는 에이전트를 변경한 후 의도한 리소스와 범위를 동기화하세요. MCP 및 훅 변형은--sync가 제공되지 않는 한 소스만 저장합니다.sync --all에는 확장 기능, MCP 및 훅도 포함되지만 플러그인은 제외됩니다. - 감사 블록을 검사하세요. 재정의를 선택하기 전에 결과를 검토하세요.
install --json은 덮어쓰기를 허용하고 스킬/에이전트 필터가 제공되지 않으면 모두 선택하지만 감사 게이트는 유지합니다. 단순한 출력 형식이 아닙니다. 자동화에 사용하기 전에 install.md 및 audit.md를 읽으세요. - 일치하는 복구 메커니즘을 사용하세요. 제거된 스킬은 휴지통으로 이동합니다. 네이티브 MCP 항목은 MCP 백업을 사용합니다. CLI 제거를 위해 파일 시스템 삭제를 대체하지 마세요.
- MCP 정의에 자격 증명을 포함하지 마세요.
{fromEnv: VARIABLE}참조를 사용하세요. 설정 관리는 비밀 확인, OAuth 자격 증명 복사, 서버 시작 또는 해당 도구 프로빙을 필요로 하지 않습니다. - 작업 범위를 존중하세요. 로컬 구성 작업이 커밋, 푸시 또는 게시를 암시하지는 않습니다. 사용자 요청에 포함된 경우에만 해당 명령을 실행하세요.
일반적인 워크플로우
검사 및 진단
skillshare status --json
skillshare list --json
skillshare diff --json
skillshare doctor --json
skillshare mcp --json
doctor는 오류를 발견하면 종료 코드 1을 반환합니다. 감사는 --format json을 사용합니다.
JSON 플래그 및 TUI 가용성은 명령에 따라 다릅니다. 동등성을 가정하지 말고 관련 참조를 확인하세요.
업스트림 저장소 추적 또는 선택한 스킬 설치
설치하기 전에 리소스와 범위를 선택하세요. 사용자 전체 리소스에는 -g를, 이 프로젝트에는 -p를 사용하세요. 미리보기, 적용, 업데이트 및 동기화 시 해당 범위를 유지하세요.
| 의도 | 명령 |
|---|---|
| 하나의 Git 체크아웃으로 업스트림 스킬 컬렉션 유지 | skillshare install owner/repo --track --name team -g |
| 소스 메타데이터와 함께 명명된 스킬만 설치 | skillshare install owner/repo -s pdf,commit -g |
| 발견된 모든 스킬을 개별적으로 설치 | skillshare install owner/repo --all -g |
| 훅/MCP를 포함한 완전한 네이티브 플러그인 관리 | plugin discover 및 plugin add 사용; 아래 참조 |
범위별 미리보기 → 적용 → 업데이트 → 동기화 워크플로우에 대한 자세한 내용은 install.md를 읽으세요. 최신 업스트림 브랜치 추적, 거부된 플래그 조합 및 대상 필터를 다룹니다.
프로젝트 설정에는 init -p를 사용한 다음 install -p 및 sync -p를 사용하세요. 구성된 원격 종속성은 소스 없이 install로 다시 수화하세요. 전체 플래그 세부 정보 및 에이전트에 대한 자세한 내용은 install.md 및 sync.md를 읽으세요.
로컬 스킬 체크아웃을 제자리에서 사용하려면 skillshare link <path> --enable를 실행한 다음 sync를 실행하세요. skillshare unlink <name>는 링크만 제거합니다. 이러한 링크가 어떻게 처리되는지에 대한 자세한 내용은 TROUBLESHOOTING.md를 읽으세요.
비활성화 또는 제거
skillshare disable 'draft-*' --dry-run
skillshare disable 'draft-*'
skillshare enable 'draft-*'
skillshare uninstall my-skill
skillshare sync
skillshare trash restore my-skill
skillshare sync
이 전체 예제 시퀀스가 아닌 요청된 작업만 실행하세요. Skillshare가 변경되지 않은 상태로 수신할 수 있도록 글로브 패턴을 따옴표로 묶으세요. 비활성화는 무시 규칙을 사용합니다. 제거는 휴지통을 사용합니다.
스킬을 폴더로 이동
skillshare move my-skill frontend --dry-run
skillshare move my-skill other-skill frontend
skillshare sync
설치된 스킬에는 mv 대신 move를 사용하세요. 설치 기록을 유지하므로 다시 다운로드되지 않습니다.
동기화하지 않습니다. 이후에 sync를 실행하세요. 거부 및 프로젝트 모드에 대한 자세한 내용은 install.md를 읽으세요.
글로벌 구성의 프로젝트 폴더
skillshare project list --json
skillshare project localize ~/work/existing --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --sync
skillshare project edit app --skills-include 'frontend-*'
skillshare project sync app --json
skillshare project remove app --dry-run --json
project는 저장소 내부를 포함하여 항상 글로벌 구성을 사용합니다. -p를 허용하지 않습니다.
새 프로젝트는 config.yaml에 저장되거나 --machine-local 또는 projects_storage: machine-local을 사용하여 이 시스템에만 저장됩니다(--shared가 설정을 재정의함). localize 및 share는 둘 사이를 이동합니다. config.yaml 프로젝트의 로컬 복사본을 제거하면 --shared가 제공되지 않는 한 config.yaml의 버전이 유지됩니다. 편집 필터는 목록을 대체합니다. 제거는 스킬을 분리하고 에이전트 파일을 유지합니다.
JSON 제거는 미리보기가 아닌 경우 --yes가 필요합니다. 저장 후 동기화 실패, 재시도 및 부분 제거 결과에 대한 자세한 내용은 targets.md를 읽으세요.
MCP 설정
skillshare mcp import --from claude --json
skillshare mcp add docs --url https://example.com/mcp --target claude --no-tui
skillshare sync mcp --dry-run --json
skillshare sync mcp
--target은 단수이며 반복 가능합니다. 미리보기는 변경 사항을 적용하지 않습니다. 수정, 편집, 가져오기 충돌, 자격 증명, 백업 및 인간 조작 TUI 명령에 대한 자세한 내용은 mcp.md를 읽으세요.
완전한 플러그인
완전한 네이티브 패키지에는 plugin discover 및 plugin add를 사용하세요. plugin import는 기존 네이티브 설치를 채택합니다. 요청된 작업만 실행하세요. 변경 사항을 적용하기 전에 plugins.md를 읽으세요. 범위별 업스트림 워크플로우, 지원되는 대상 및 소스-참조 규칙을 다룹니다.
plugin check/update는 업스트림 변경 사항을 처리합니다. sync plugins는 대상 선택을 조정합니다. 플러그인은 sync --all에서 제외됩니다.
스킬 허브
skillshare hub add https://example.com/hub.json # 허브 소스 저장
skillshare hub add https://example.com/hub.json --label my-hub # 사용자 지정 레이블 사용
skillshare hub add [email protected]:team/skills.git --label ghe # SSH/비공개/GHE 허브 소스
skillshare hub list # 저장된 허브 나열
skillshare hub default my-hub # 기본 허브 설정
skillshare hub remove my-hub # 허브 제거
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit # 허브 인덱스 구축
활성 follow_source_links 설정은 hub index(--source 포함), 내장 대시보드 검색 및 허브 초안 후보에도 적용됩니다.
참조
명령 플래그, 예제 및 제한 사항에 대해서는 일치하는 파일을 읽으세요. 단일 작업에 대해 모든 참조를 로드하지 마십시오.
| 주제 | 파일 |
|---|---|
| 네이티브 에이전트, 선택, 무시 규칙 및 복구 | native-agents.md |
| MCP 구성, 가져오기, TUI 및 복구 | mcp.md |
| 네이티브 훅, 코드 바인딩, 범위 및 복구 | hooks.md |
| 완전한 플러그인, 네이티브 라이프사이클 및 동기화 선택 | plugins.md |
| 초기화 플래그 | init.md |
| 동기화/수집/커밋/푸시/풀 | sync.md |
| 설치/업데이트/제거/이동/새로 만들기 | install.md |
| 상태/diff/목록/검색/확인 | status.md |
| 보안 감사 | audit.md |
| 설치 전 신뢰할 수 없는 스킬 검토 | audit-review.md |
| 휴지통 | trash.md |
| 작업 로그 | log.md |
| 대상 | targets.md |
| 확장 기능(규칙/명령/프롬프트) | extras.md |
| 세션 회고 및 저장된 노트에 대한 꿈(Dreaming) | memory-review.md |
| 백업/복원 | backup.md |
| 문제 해결 | TROUBLESHOOTING.md |