skillshare

skillshare

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

Website License: MIT Release Platform Go Report Card Ask DeepWiki

Star on GitHub

runkids%2Fskillshare | Trendshift

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

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

> [!NOTE] > **최신 버전**: v0.23.0 — global과 project 범위의 **네이티브 hooks**를 관리·동기화하고, `tools.allow`와 `tools.deny`로 모델이 사용할 **MCP tools**를 선택할 수 있습니다. dashboard에 추가된 **Hooks 페이지**와 **MCP 도구 선택 화면**에서도 설정할 수 있습니다. 전체 새 기능과 수정 사항은 [Releases](https://github.com/runkids/skillshare/releases)와 [변경 내역](https://skillshare.runkids.cc/changelog)에서 확인하세요. ## skillshare를 쓰는 이유 AI CLI는 저마다 자체 skills 디렉터리를 가지고 있습니다. 하나를 수정하고 다른 곳에 복사하는 것을 잊어버려, 결국 어느 것이 최신인지 알 수 없게 됩니다. skillshare가 이 문제를 해결합니다. - **하나의 소스, 모든 agent** — `skillshare sync`로 Claude, Cursor, Codex 등 60개 이상의 도구에 동기화 - **Agent 관리** — 커스텀 agent를 skills와 함께 agent를 지원하는 target에 동기화 - **skills 그 이상** — [extras](https://skillshare.runkids.cc/docs/reference/targets/configuration#extras)로 rules, commands, prompts 등 파일 기반 리소스를 관리 - **MCP 연결** — 서버는 한 번만 정의하고, [`sync mcp`](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-mcp)로 각 Agent 고유의 설정 형식에 기록 - **완전한 plugin** — plugin의 skills, hooks, MCP 설정을 한 묶음으로 유지하고, [`plugin`](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-plugins)으로 설치할 도구를 선택 - **네이티브 hooks** — Agent별 event 설정과 extension 코드를 관리하고 미리보기, 활성화/비활성화, 복원을 지원합니다. [hooks](https://skillshare.runkids.cc/docs/reference/commands/hooks) - **어디서든 설치** — GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, CNB 또는 자체 호스팅 Git - **내장 보안 기능** — 사용하기 전에 skills에 prompt injection이나 데이터 유출 위험이 있는지 감사 - **팀에 적합** — 프로젝트 skills는 `.skillshare/`에, 조직 공용 skills는 tracked repo로 배포 - **로컬, 경량** — 단일 바이너리. registry도 텔레메트리도 없으며 완전히 오프라인으로 동작 - **세밀한 필터링** — [`.skillignore`](https://skillshare.runkids.cc/docs/how-to/daily-tasks/filtering-skills), SKILL.md의 `targets`, target별 include/exclude로 어떤 skills가 어떤 target에 전달될지 제어 > 다른 도구에서 옮겨 오시나요? [마이그레이션 가이드](https://skillshare.runkids.cc/docs/how-to/advanced/migration) · [비교](https://skillshare.runkids.cc/docs/understand/philosophy/comparison) ## 동작 방식 - 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 (관리자 권한 불필요), 파일 symlink는 Developer Mode 필요 (없으면 복사) | | | 명령형 (명령마다 설치) | 선언형 (skillshare) | |---|---|---| | **단일 소스** | skills를 각각 따로 복사 | 하나의 소스에서 symlink(또는 복사)로 배포 | | **새 컴퓨터 설정** | 모든 설치를 수동으로 다시 실행 | 설정을 `git clone`한 뒤 `sync` | | **보안 감사** | 없음 | `audit` 내장, install과 update 시 자동 스캔 | | **웹 대시보드** | 없음 | `skillshare ui` | | **런타임 의존성** | Node.js + npm | 없음 (단일 Go 바이너리) | > [전체 비교 →](https://skillshare.runkids.cc/docs/understand/philosophy/comparison) ## CLI와 UI 미리보기

skillshare demo

| Skill 상세 정보 | 보안 감사 | |---|---| | Skill 상세 정보 | 보안 감사 | | 웹 대시보드 | 웹 Skills 페이지 | |---|---| | 웹 대시보드 | 웹 Skills 페이지 | ## 설치 > [!TIP] > **데스크톱에서 skillshare를 관리하세요.** macOS(Apple Silicon), Windows, Linux용 [Skillshare App 다운로드](https://github.com/runkids/skillshare-app/releases/latest). 첫 실행에서 CLI 설치 또는 기존 CLI 선택, AI 도구 선택, 첫 동기화를 안내합니다. [설치 가이드](https://skillshare.runkids.cc/ko/docs/getting-started/desktop-app). ### 데스크톱 앱 — 화면으로 설정하고 관리 [Skillshare App](https://github.com/runkids/skillshare-app)에서 스킬, 에이전트, MCP, hooks를 데스크톱 창으로 관리할 수 있습니다. 앱을 설치하고 연 다음 첫 실행 안내에 따라 설정하세요. macOS(Apple Silicon)에서는 Homebrew 사용: ```bash brew tap runkids/tap brew install --cask skillshare-app ``` **Windows/Linux 또는 macOS 수동 설치:** [최신 앱 설치 파일 다운로드](https://github.com/runkids/skillshare-app/releases/latest). 플랫폼별 자세한 내용은 [데스크톱 앱 가이드](https://skillshare.runkids.cc/ko/docs/getting-started/desktop-app)를 참고하세요. ### CLI: macOS / Linux ```bash curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh ``` 스크립트는 기본적으로 `~/.local/bin`에 설치하므로 일반적인 설치와 업데이트에는 `sudo`가 필요하지 않습니다. 설치 프로그램이 PATH 설정 안내를 표시할 때만 안내에 따라 설정한 후 `skillshare`를 실행하세요. 이후 터미널에서도 사용할 수 있도록 안내된 명령을 shell 설정 파일(예: `~/.zshrc` 또는 `~/.bashrc`)에 추가할 수 있습니다. 다른 설치 위치는 `INSTALL_DIR`로 지정할 수 있습니다. ### Windows PowerShell ```powershell irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex ``` ### CLI: Homebrew ```bash brew install skillshare ``` > **팁:** `skillshare upgrade`를 실행하면 최신 버전으로 업데이트됩니다. 설치 방식을 자동으로 감지해 나머지를 처리합니다. ### GitHub Actions ```yaml - uses: runkids/setup-skillshare@v1 with: source: ./skills - run: skillshare sync ``` 모든 옵션(audit, project 모드, 버전 고정)은 [`setup-skillshare`](https://github.com/marketplace/actions/setup-skillshare)를 참고하세요. ### 단축 명령 (선택 사항) 셸 설정 파일(`~/.zshrc` 또는 `~/.bashrc`)에 alias를 추가하세요. ```bash alias ss='skillshare' ``` ## 빠른 시작 ```bash skillshare init # 설정, 소스, 감지된 target 생성 skillshare sync # skills를 모든 target에 동기화 ``` ## 주요 기능 **skills 설치와 업데이트** — GitHub, GitLab 또는 모든 Git 호스트에서 ```bash skillshare install github.com/reponame/skills skillshare update --all skillshare target claude --mode copy # symlink를 쓸 수 없는 경우 ``` **symlink에 문제가 있나요?** — target별로 copy 모드로 전환 ```bash skillshare target --mode copy skillshare sync ``` **보안 감사** — skills가 agent에 전달되기 전에 스캔 ```bash skillshare audit ``` **프로젝트 skills** — 저장소별로 관리하고 코드와 함께 commit ```bash skillshare init -p && skillshare sync ``` **Agents** — 커스텀 agent를 agent를 지원하는 target에 동기화 ```bash skillshare sync agents # agents만 동기화 skillshare sync --all # skills, agents, extras, MCP, hooks를 함께 동기화 ``` **Extras** — rules, commands, prompts 등을 관리 ```bash skillshare extras init rules # "rules"라는 extra 생성 skillshare sync --all # skills, agents, extras, MCP, hooks를 함께 동기화 skillshare extras collect rules # 로컬 파일을 소스로 다시 수집 ``` **MCP 연결** — 한 번 설정하면 Claude Code, Codex, Cursor, VS Code, OpenCode 등에 적용 ```bash skillshare mcp add # 안내형 설정. URL을 입력하거나 JSON을 붙여넣기 skillshare sync mcp --dry-run # 각 도구의 설정 파일에 생길 변경 사항 미리보기 skillshare sync mcp # 연결 설정 적용 ``` 정의는 `config.yaml`에 두거나 별도의 `mcp.yaml`을 참조할 수 있습니다. 예시, 환경 변수 참조, 기존 연결 가져오기는 [MCP 설정](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-mcp)을 참고하세요. hook을 실행하지 않고 네이티브 hooks 관리: ```bash skillshare hooks add check --file ./check.yaml skillshare hooks sync --dry-run skillshare hooks sync ``` **Plugins** — 완전한 plugin을 설치하고, 설치할 도구를 선택 ```bash 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 관리하기](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-plugins)를 참고하세요. **셸 자동 완성** — 명령, 플래그, 하위 명령을 Tab으로 완성 ```bash skillshare completion bash --install # zsh, fish, powershell, nushell도 지원 ``` **로컬 체크포인트** — 소스 변경 사항을 push 없이 commit ```bash skillshare commit -m "Update review skill" skillshare commit --dry-run ``` **웹 대시보드** — 시각적인 제어판 ```bash skillshare ui ``` [모든 명령과 가이드 →](https://skillshare.runkids.cc/docs/reference/commands) ## 기여하기 기여를 환영합니다! 먼저 issue를 열고, 테스트가 포함된 draft PR을 보내 주세요. 환경 설정은 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요. ```bash git clone https://github.com/runkids/skillshare.git && cd skillshare make check # format + lint + test ``` > [!TIP] > 어디서 시작할지 모르겠다면 [open issues](https://github.com/runkids/skillshare/issues)를 살펴보거나, 설정 없이 바로 쓰는 개발 환경 [Playground](https://skillshare.runkids.cc/docs/learn/with-playground)를 사용해 보세요. ## 기여자 skillshare를 함께 만들어 주신 모든 분께 감사드립니다. 전체 명단은 [영문 README](README.md#contributors)에 있습니다. --- skillshare가 유용했다면 ⭐를 눌러 주세요 ## Star History [![Star History Chart](https://star-history.dera.page/svg?repos=runkids/skillshare&type=date&legend=top-left)](https://star-history.dera.page/#runkids/skillshare&type=date&legend=top-left) --- ## 라이선스 MIT