English · Deutsch · Español · Français · 日本語 · 한국어 · Português · 简体中文 · 繁體中文
나의 AI 코딩 환경을, 어디서나.
skills, agents, rules, MCP 연결과 hooks를 한곳에서 관리하세요.
Claude Code, Codex, Pi, OpenCode 등에서 사용할 수 있습니다.
공식 사이트 • 설치 • 빠른 시작 • 주요 기능 • 스크린샷 • 데스크톱 앱 • 문서
|
|
| 웹 대시보드 | 웹 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에 동기화
```
## 동작 방식
- 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)
## 주요 기능
**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