Files
Willie f9f59b432b docs(readme): link directly to GitHub contributors
Remove the GitRanks promotion, keep community acknowledgments, and restore the previous star history chart.
2026-11-19 01:12:00 +08:00

16 KiB
Raw Permalink Blame History

skillshare

skillshare

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

Website License: MIT Release Downloads Platform Ask DeepWiki

Star on GitHub

runkids%2Fskillshare | Trendshift runkids%2Fskillshare | Trendshift

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

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

skillshare demo

Note

최신 버전: v0.30.11 — 대시보드에서 Pi 패키지를 공유하세요. Plugins 페이지의 「공유」는 이제 플러그인 다음에 Pi가 npm에서 설치한 패키지도 나열하고, skillshare plugin add npm:<package> --target pi -g --no-tui처럼 모두 추가하는 명령 하나를 복사합니다. 「대상에 있는 hook」 대화상자는 Antigravity와 Copilot hook도 가져오지 않고 편집하거나 제거할 수 있습니다. 플러그인 가이드 → · 변경 기록 →

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 상세 정보 보안 감사
Skill 상세 정보 보안 감사
웹 대시보드 웹 Skills 페이지
웹 대시보드 웹 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를 실행하면 최신 버전으로 업데이트됩니다. 설치 방식을 자동으로 감지해 나머지를 처리합니다.

CLI: Nix

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

- 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

Herdr 패널 — Herdr의 에이전트 옆에 skillshare: 업데이트, sync, 감사를 거친 설치, 소스 저장소를 한 패널에서

Herdr 패널 설정 →

모든 명령과 가이드 →

기여하기

기여를 환영합니다! 먼저 issue를 열고, 테스트가 포함된 draft PR을 보내 주세요. 환경 설정은 CONTRIBUTING.md를 참고하세요.

git clone https://github.com/runkids/skillshare.git && cd skillshare
make check  # format + lint + test

Tip

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

기여자

GitHub에서 기여자 보기

커뮤니티에 보내는 감사

버그를 제보하고 개선을 제안하고 수정 사항을 테스트해 주신 모든 분께 감사드립니다. 영문 README에 있습니다.


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

Star History

Star History Chart

라이선스

MIT