mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
0.30.0 changes which addresses the dashboard answers at, which matters to anyone who opens it by a domain name, so the Latest callout leads with that and points to --trusted-origin. Also credits the contributors of #805, #806 and #809.
323 lines
16 KiB
Markdown
323 lines
16 KiB
Markdown
<p align="center" style="margin-bottom: 0;">
|
||
<img src=".github/assets/skillshare-logo-card.png" alt="skillshare" width="280">
|
||
</p>
|
||
|
||
<h1 align="center" style="margin-top: 0.5rem; margin-bottom: 0.5rem;">skillshare</h1>
|
||
|
||
<p align="center">
|
||
<a href="README.md">English</a> · <a href="README-de.md">Deutsch</a> · <a href="README-es.md">Español</a> · <a href="README-fr.md">Français</a> · <a href="README-ja.md">日本語</a> · <a href="README-ko.md">한국어</a> · <a href="README-pt-BR.md">Português</a> · <a href="README-zh-CN.md">简体中文</a> · <a href="README-zh-TW.md">繁體中文</a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="https://skillshare.runkids.cc"><img src="https://img.shields.io/badge/Website-skillshare.runkids.cc-blue?logo=docusaurus" alt="Website"></a>
|
||
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
|
||
<a href="https://github.com/runkids/skillshare/releases"><img src="https://img.shields.io/github/v/release/runkids/skillshare" alt="Release"></a>
|
||
<a href="https://github.com/runkids/skillshare/releases"><img src="https://img.shields.io/github/downloads/runkids/skillshare/total" alt="Downloads"></a>
|
||
<img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue" alt="Platform">
|
||
<a href="https://deepwiki.com/runkids/skillshare"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/runkids/skillshare/stargazers"><img src="https://img.shields.io/github/stars/runkids/skillshare?style=social" alt="Star on GitHub"></a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="https://trendshift.io/repositories/21835" target="_blank"><img src="https://trendshift.io/api/badge/repositories/21835" alt="runkids%2Fskillshare | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
|
||
<a href="https://trendshift.io/repositories/21835?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-21835" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/21835/daily?language=Go" alt="runkids%2Fskillshare | Trendshift" width="250" height="55"/></a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<strong>나의 AI 코딩 환경을, 어디서나.</strong><br>
|
||
skills, agents, rules, MCP 연결과 hooks를 한곳에서 관리하세요.<br>
|
||
Claude Code, Codex, Pi, OpenCode 등에서 사용할 수 있습니다.
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="https://skillshare.runkids.cc">공식 사이트</a> •
|
||
<a href="#설치">설치</a> •
|
||
<a href="#빠른-시작">빠른 시작</a> •
|
||
<a href="#주요-기능">주요 기능</a> •
|
||
<a href="#cli와-ui-미리보기">스크린샷</a> •
|
||
<a href="#desktop-app">데스크톱 앱</a> •
|
||
<a href="https://skillshare.runkids.cc/docs">문서</a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<img src=".github/assets/demo.gif" alt="skillshare demo" width="960">
|
||
</p>
|
||
|
||
> [!NOTE]
|
||
> **최신 버전**: v0.30.0 — 웹 대시보드는 다른 웹사이트가 브라우저를 통해 보내는 변경을 거부하고, `localhost`, IP 주소, 신뢰하는 주소에서만 응답하므로 DNS rebinding 페이지도 접근할 수 없습니다. 리버스 프록시 뒤에서는 [`--trusted-origin`](https://skillshare.runkids.cc/ko/docs/reference/commands/ui#reverse-proxy)으로 시작하면 MCP, Hooks, Plugins를 포함한 모든 페이지가 내 도메인을 통해 동작합니다. 그 밖의 도메인 이름으로 연 대시보드에는 이제 이 설정이 필요합니다. [`skillshare plugin`](https://skillshare.runkids.cc/ko/docs/reference/commands/plugin)은 Claude 매니페스트만 담은 플러그인도 Codex에 제공하며, Codex가 사용할 수 있는 skill과 MCP 서버를 함께 보여 줍니다. [변경 기록](https://skillshare.runkids.cc/changelog)을 확인하세요.
|
||
|
||
## skillshare를 쓰는 이유
|
||
|
||
AI 도구를 바꿀 때마다 환경을 다시 구성할 필요는 없습니다.
|
||
skillshare는 skills와 다른 AI 리소스를 직접 관리할 수 있는 한곳에 모아 줍니다.
|
||
|
||
- **도구를 바꿔도 skills는 그대로** — 한 번 수정하고 Claude Code, Codex, Pi 등 사용하는 도구에 동기화하세요.
|
||
- **다른 컴퓨터에서도 내 환경 그대로** — 소스를 Git으로 관리하고 다른 컴퓨터에서 pull하세요.
|
||
- **팀과 공유** — 프로젝트 리소스를 코드와 함께 관리하고 공용 skills를 tracked repo로 배포하세요.
|
||
|
||
한 팀원은 Claude Code를, 다른 팀원은 Codex를 사용합니다. 공통 코드 리뷰 체크리스트를 프로젝트의 `.skillshare/`에서 관리하세요. 새 팀원은 채팅에서 지침을 복사하는 대신 선언된 skills를 설치하고 설정된 도구에 동기화할 수 있습니다. [팀 온보딩 →](https://skillshare.runkids.cc/docs/how-to/recipes/team-onboarding-recipe)
|
||
|
||
데스크톱 앱이나 CLI로 로컬에서 관리하고, [사용 전에 skills를 감사](https://skillshare.runkids.cc/docs/reference/commands/audit)하며, [각 도구에 전달할 내용을 선택](https://skillshare.runkids.cc/docs/how-to/daily-tasks/filtering-skills)할 수 있습니다.
|
||
|
||
> 다른 도구에서 옮겨 오시나요? [마이그레이션 가이드](https://skillshare.runkids.cc/docs/how-to/advanced/migration) · [비교](https://skillshare.runkids.cc/docs/understand/philosophy/comparison)
|
||
|
||
## CLI와 UI 미리보기
|
||
|
||
| Skill 상세 정보 | 보안 감사 |
|
||
|---|---|
|
||
| <img src=".github/assets/skill-detail-tui.png" alt="Skill 상세 정보" width="480" height="300"> | <img src=".github/assets/audit-tui.png" alt="보안 감사" width="480" height="300"> |
|
||
|
||
| 웹 대시보드 | 웹 Skills 페이지 |
|
||
|---|---|
|
||
| <img src=".github/assets/ui/web-dashboard-demo.png" alt="웹 대시보드" width="480"> | <img src=".github/assets/ui/web-skills-demo.png" alt="웹 Skills 페이지" width="480"> |
|
||
|
||
## 설치
|
||
|
||
> [!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).
|
||
|
||
<a id="desktop-app"></a>
|
||
|
||
### 데스크톱 앱 — 화면으로 설정하고 관리
|
||
|
||
[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`를 실행하면 최신 버전으로 업데이트됩니다. 설치 방식을 자동으로 감지해 나머지를 처리합니다.
|
||
|
||
### CLI: Nix
|
||
|
||
```bash
|
||
nix profile add github:runkids/skillshare
|
||
```
|
||
|
||
업데이트는 `nix profile upgrade skillshare`로 합니다. flakes가 활성화된 Nix 2.30 이상이 필요하며, 이전 Nix나 Lix에서는 `nix profile install`을 사용하세요. NixOS와 Home Manager 설정에서는 flake의 `overlays.default`를 사용할 수 있습니다.
|
||
|
||
### 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 <name> --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, Pi, 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
|
||
```
|
||
|
||
**Herdr 패널** — [Herdr](https://herdr.dev)의 에이전트 옆에 skillshare: 업데이트, sync, 감사를 거친 설치, 소스 저장소를 한 패널에서
|
||
|
||
[Herdr 패널 설정 →](https://skillshare.runkids.cc/docs/learn/with-herdr)
|
||
|
||
[모든 명령과 가이드 →](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
|
||
|
||
<a href="https://star-history.dera.page/runkids/skillshare">
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=runkids/skillshare&theme=dark" />
|
||
<source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=runkids/skillshare" />
|
||
<img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=runkids/skillshare" />
|
||
</picture>
|
||
</a>
|
||
|
||
---
|
||
|
||
## 라이선스
|
||
|
||
MIT
|