skillshare

English · Deutsch · Español · Français · 日本語 · 한국어 · Português · 简体中文 · 繁體中文

나의 AI 코딩 환경을, 어디서나.
skills, agents, rules, MCP 연결과 hooks를 한곳에서 관리하세요.
Claude Code, Codex, Pi, OpenCode 등에서 사용할 수 있습니다.

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

[!NOTE] 최신 버전: v0.28.0 — agent별로 skill 사본을 따로 제공하는 tracked 저장소(skills/claude/<skill>, skills/codex/<skill>)는 이제 merge·copy 모드에서 각 사본을 해당 agent에만 동기화하고, 요약에서는 하나의 skill로 집계합니다. skillshare plugin update --all로 tracked plugin을 한 번에 업데이트할 수 있고, shallow partial clone에서도 update가 다시 동작합니다. 변경 기록을 확인하세요.

skillshare를 쓰는 이유

AI 도구를 바꿀 때마다 환경을 다시 구성할 필요는 없습니다. skillshare는 skills와 다른 AI 리소스를 직접 관리할 수 있는 한곳에 모아 줍니다.

• 도구를 바꿔도 skills는 그대로 — 한 번 수정하고 Claude Code, Codex, Pi 등 사용하는 도구에 동기화하세요.
• 다른 컴퓨터에서도 내 환경 그대로 — 소스를 Git으로 관리하고 다른 컴퓨터에서 pull하세요.
• 팀과 공유 — 프로젝트 리소스를 코드와 함께 관리하고 공용 skills를 tracked repo로 배포하세요.

한 팀원은 Claude Code를, 다른 팀원은 Codex를 사용합니다. 공통 코드 리뷰 체크리스트를 프로젝트의 .skillshare/에서 관리하세요. 새 팀원은 채팅에서 지침을 복사하는 대신 선언된 skills를 설치하고 설정된 도구에 동기화할 수 있습니다. 팀 온보딩 →

데스크톱 앱이나 CLI로 로컬에서 관리하고, 사용 전에 skills를 감사하며, 각 도구에 전달할 내용을 선택할 수 있습니다.

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

CLI와 UI 미리보기

Skill 상세 정보	보안 감사

웹 대시보드	웹 Skills 페이지

설치

[!TIP] 데스크톱에서 skillshare를 관리하세요. macOS(Apple Silicon), Windows, Linux용 Skillshare App 다운로드. 첫 실행에서 CLI 설치 또는 기존 CLI 선택, AI 도구 선택, 첫 동기화를 안내합니다. 설치 가이드.

데스크톱 앱 — 화면으로 설정하고 관리

Skillshare App에서 스킬, 에이전트, MCP, hooks를 데스크톱 창으로 관리할 수 있습니다. 앱을 설치하고 연 다음 첫 실행 안내에 따라 설정하세요.

macOS(Apple Silicon)에서는 Homebrew 사용:

brew tap runkids/tap
brew install --cask skillshare-app

Windows／Linux 또는 macOS 수동 설치: 최신 앱 설치 파일 다운로드. 플랫폼별 자세한 내용은 데스크톱 앱 가이드를 참고하세요.

CLI: macOS / Linux

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

스크립트는 기본적으로 ~/.local/bin에 설치하므로 일반적인 설치와 업데이트에는 sudo가 필요하지 않습니다. 설치 프로그램이 PATH 설정 안내를 표시할 때만 안내에 따라 설정한 후 skillshare를 실행하세요. 이후 터미널에서도 사용할 수 있도록 안내된 명령을 shell 설정 파일(예: ~/.zshrc 또는 ~/.bashrc)에 추가할 수 있습니다. 다른 설치 위치는 INSTALL_DIR로 지정할 수 있습니다.

Windows PowerShell

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

CLI: 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에 동기화

동작 방식

• 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 바이너리)

전체 비교 →

주요 기능

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, hooks를 함께 동기화

Extras — rules, commands, prompts 등을 관리

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 등에 적용

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

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

hook을 실행하지 않고 네이티브 hooks 관리:

skillshare hooks add check --file ./check.yaml
skillshare hooks sync --dry-run
skillshare hooks sync

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

[!TIP] 어디서 시작할지 모르겠다면 open issues를 살펴보거나, 설정 없이 바로 쓰는 개발 환경 Playground를 사용해 보세요.

기여자

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

---

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

Star History

---

라이선스

MIT