skillshare

English · 日本語 · 한국어 · 简体中文 · 繁體中文

AI CLI의 skills, agents, rules, commands 등을 하나의 소스로 관리하세요. 명령 하나로 모든 도구에 동기화되며, 개인부터 조직 전체까지 쓸 수 있습니다.
Codex, Claude Code, OpenClaw, OpenCode 등 60개 이상의 도구를 지원합니다.

공식 사이트 • 설치 • 빠른 시작 • 주요 기능 • 스크린샷 • 문서

skillshare를 쓰는 이유

AI CLI는 저마다 자체 skills 디렉터리를 가지고 있습니다. 하나를 수정하고 다른 곳에 복사하는 것을 잊어버려, 결국 어느 것이 최신인지 알 수 없게 됩니다.

skillshare가 이 문제를 해결합니다.

• 하나의 소스, 모든 agent — skillshare sync로 Claude, Cursor, Codex 등 60개 이상의 도구에 동기화
• Agent 관리 — 커스텀 agent를 skills와 함께 agent를 지원하는 target에 동기화
• skills 그 이상 — extras로 rules, commands, prompts 등 파일 기반 리소스를 관리
• MCP 연결 — 서버는 한 번만 정의하고, sync mcp로 각 Agent 고유의 설정 형식에 기록
• 완전한 plugin — plugin의 skills, hooks, MCP 설정을 한 묶음으로 유지하고, plugin으로 설치할 도구를 선택
• 어디서든 설치 — GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, CNB 또는 자체 호스팅 Git
• 내장 보안 기능 — 사용하기 전에 skills에 prompt injection이나 데이터 유출 위험이 있는지 감사
• 팀에 적합 — 프로젝트 skills는 .skillshare/에, 조직 공용 skills는 tracked repo로 배포
• 로컬, 경량 — 단일 바이너리. registry도 텔레메트리도 없으며 완전히 오프라인으로 동작
• 세밀한 필터링 — .skillignore, SKILL.md의 targets, target별 include/exclude로 어떤 skills가 어떤 target에 전달될지 제어

다른 도구에서 옮겨 오시나요? 마이그레이션 가이드 · 비교

동작 방식

• macOS / Linux: ~/.config/skillshare/
• Windows: %AppData%\skillshare\

┌─────────────────────────────────────────────────────────────┐
│                    Source Directory                         │
│   ~/.config/skillshare/skills/    ← skills (SKILL.md)       │
│   ~/.config/skillshare/agents/    ← agents                  │
│   ~/.config/skillshare/extras/    ← rules, commands, etc.   │
└─────────────────────────────────────────────────────────────┘
                              │ sync
              ┌───────────────┼───────────────┐
              ▼               ▼               ▼
       ┌───────────┐   ┌───────────┐   ┌───────────┐
       │  Claude   │   │  OpenCode │   │ OpenClaw  │   ...
       └───────────┘   └───────────┘   └───────────┘

플랫폼	Skills 소스	Agents 소스	Extras 소스	링크 방식
macOS/Linux	~/.config/skillshare/skills/	~/.config/skillshare/agents/	~/.config/skillshare/extras/	Symlinks
Windows	%AppData%\skillshare\skills\	%AppData%\skillshare\agents\	%AppData%\skillshare\extras\	NTFS Junction (관리자 권한 불필요)

	명령형 (명령마다 설치)	선언형 (skillshare)
단일 소스	skills를 각각 따로 복사	하나의 소스에서 symlink(또는 복사)로 배포
새 컴퓨터 설정	모든 설치를 수동으로 다시 실행	설정을 git clone한 뒤 sync
보안 감사	없음	audit 내장, install과 update 시 자동 스캔
웹 대시보드	없음	skillshare ui
런타임 의존성	Node.js + npm	없음 (단일 Go 바이너리)

전체 비교 →

CLI와 UI 미리보기

Skill 상세 정보	보안 감사

웹 대시보드	웹 Skills 페이지

설치

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex

Homebrew

brew install skillshare

팁: skillshare upgrade를 실행하면 최신 버전으로 업데이트됩니다. 설치 방식을 자동으로 감지해 나머지를 처리합니다.

GitHub Actions

- uses: runkids/setup-skillshare@v1
  with:
    source: ./skills
- run: skillshare sync

모든 옵션(audit, project 모드, 버전 고정)은 setup-skillshare를 참고하세요.

단축 명령 (선택 사항)

셸 설정 파일(~/.zshrc 또는 ~/.bashrc)에 alias를 추가하세요.

alias ss='skillshare'

빠른 시작

skillshare init            # 설정, 소스, 감지된 target 생성
skillshare sync            # skills를 모든 target에 동기화

주요 기능

skills 설치와 업데이트 — GitHub, GitLab 또는 모든 Git 호스트에서

skillshare install github.com/reponame/skills
skillshare update --all
skillshare target claude --mode copy  # symlink를 쓸 수 없는 경우

symlink에 문제가 있나요? — target별로 copy 모드로 전환

skillshare target <name> --mode copy
skillshare sync

보안 감사 — skills가 agent에 전달되기 전에 스캔

skillshare audit

프로젝트 skills — 저장소별로 관리하고 코드와 함께 commit

skillshare init -p && skillshare sync

Agents — 커스텀 agent를 agent를 지원하는 target에 동기화

skillshare sync agents            # agents만 동기화
skillshare sync --all             # skills, agents, extras, MCP를 함께 동기화

Extras — rules, commands, prompts 등을 관리

skillshare extras init rules          # "rules"라는 extra 생성
skillshare sync --all                 # skills, agents, extras, MCP를 함께 동기화
skillshare extras collect rules       # 로컬 파일을 소스로 다시 수집

MCP 연결 — 한 번 설정하면 Claude Code, Codex, Cursor, VS Code, OpenCode 등에 적용

skillshare mcp add                    # 안내형 설정. URL을 입력하거나 JSON을 붙여넣기
skillshare sync mcp --dry-run         # 각 도구의 설정 파일에 생길 변경 사항 미리보기
skillshare sync mcp                   # 연결 설정 적용

정의는 config.yaml에 두거나 별도의 mcp.yaml을 참조할 수 있습니다. 예시, 환경 변수 참조, 기존 연결 가져오기는 MCP 설정을 참고하세요.

Plugins — 완전한 plugin을 설치하고, 설치할 도구를 선택

skillshare plugin add                 # 안내형: 소스, plugin, target, 확인
skillshare plugin add owner/repo --target claude --target codex --no-tui
skillshare sync plugins --dry-run     # plugin 동기화는 sync --all과 별도

도구에 이미 설치된 plugin은 plugin import로 관리 대상에 포함할 수 있습니다. 여러 도구에서 plugin 관리하기를 참고하세요.

셸 자동 완성 — 명령, 플래그, 하위 명령을 Tab으로 완성

skillshare completion bash --install   # zsh, fish, powershell, nushell도 지원

로컬 체크포인트 — 소스 변경 사항을 push 없이 commit

skillshare commit -m "Update review skill"
skillshare commit --dry-run

웹 대시보드 — 시각적인 제어판

skillshare ui

모든 명령과 가이드 →

기여하기

기여를 환영합니다! 먼저 issue를 열고, 테스트가 포함된 draft PR을 보내 주세요. 환경 설정은 CONTRIBUTING.md를 참고하세요.

git clone https://github.com/runkids/skillshare.git && cd skillshare
make check  # format + lint + test

기여자

skillshare를 함께 만들어 주신 모든 분께 감사드립니다. 전체 명단은 영문 README에 있습니다.

---

skillshare가 유용했다면 ⭐를 눌러 주세요

Star History

---

라이선스

MIT