English · 日本語 · 한국어 · 简体中文 · 繁體中文
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 미리보기
|
|
| 웹 대시보드 | 웹 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