yibie/skills-manager

Skills Manager – macOS UI for organising LLM‑coding‑agent skills

What it is

• macOS (Sonoma +) 전용 앱으로 SwiftUI/Swift 6로 작성되었으며, Claude Code, Cursor, Gemini CLI, OpenHands 등 수십 가지 코드 생성 에이전트용 skills (프롬프트 기반 확장)의 탐색, 설치, 테스트, 정리 기능을 통합합니다.
• 로컬 파일 시스템을 유일한 신뢰할 수 있는 소스로 간주합니다: Library에는 원본 스킬 패키지가 저장되며, Collections는 프로젝트나 워크플로우용으로 그룹화하고, Mounts는 에이전트의 자체 스킬 디렉터리에 필요 시 심볼릭 링크를 생성합니다.

Key concepts

Layer	Role
Library	모든 다운로드된 스킬 패키지가 저장되는 중앙 읽기 전용 저장소입니다.
Collection	Library의 스킬을 재사용 가능한 이름이 지정된 그룹(예: Web‑dev, Data‑Science)으로 묶습니다.
Mount	한 개 이상의 에이전트 내부에 컬렉션을 복사하지 않고 심볼릭 링크로 노출하는 링크 세트입니다.

Main features

• Discover – 공개된 skills.sh 카탈로그에서 스킬 목록을 가져와 로컬에 캐시하고, 온라인 시 전체 사이트 검색을 지원합니다.
• Try – 설치 전에 로컬에 구성된 LLM(Claude, OpenAI, OpenRouter, Ollama, LM Studio)에서 스킬을 실행하여 테스트할 수 있습니다.
• Install / Uninstall – 지원되는 에이전트의 임의의 하위 집합에 한 번의 클릭으로 설치 가능. 언마운트는 심볼릭 링크만 제거하며 Library는 그대로 유지됩니다.
• Conflict & state view – 에이전트 간에 누락, 공유, 부분 적용, 차이가 나는 복사본을 표시하여 수동으로 해결할 수 있습니다.
• Translation – 스킬 설명용 내장 8개 언어 카탈로그와 새 항목에 대한 온디맨드 LLM 후속 조치 기능이 있습니다.
• Terminal UI – tui/에 구현된 빌드된 TUI로 macOS 앱의 기능을 완전히 반영하며, 롤백을 위한 로컬 Git 기록을 유지합니다.
• Automatic monitoring – 에이전트의 스킬 폴더를 감시하고 디스크 파일 변경 시 UI를 자동으로 새로 고칩니다.

Supported agents (내부 AgentRegistry로 감지). README에는 40개 이상의 에이전트가 목록화되어 있으며, Install target으로 표시된 것은 다중 설치 선택기에서 선택 가능하고, 나머지는 여전히 충돌 검사를 위해 스캔됩니다.

Installation

1. GitHub 릴리스 페이지에서 서명된 zip 파일을 다운로드하여 Applications 폴더로 드래그(맥OS 14+ 필요).
2. Xcode로 소스에서 빌드(open SkillsManager.xcodeproj).
3. TUI의 경우 cd tui && npm exec skills-manager (또는 글로벌 skills-manager 명령어를 위해 npm link).

Architecture & offline stance

• 순수하게 로컬 우선: 원격 백엔드 없음. 카탈로그 갱신, 설명 번역, Try 시 LLM 호출을 제외하고는 데이터가 기계를 벗어나지 않습니다.
• 앱은 각 에이전트의 구성 파일에 직접 쓰며, 설치 기록을 로컬 Git 로그로 유지하여 차이 비교 및 롤백을 가능하게 합니다.
• 탐색 데이터는 ~/.skills-manager/cache/discover-directory.json에 캐시됩니다. 네트워크는 카탈로그 갱신, 전체 사이트 검색, 번역 후속 조치, LLM Try 호출 시에만 사용됩니다.

Roadmap (as of the README)

• 탐색된 스킬의 자동 업데이트 감지(계획 중)
• 스킬 세트 내보내기/가져오기(계획 중)
• 공유 리포지토리를 통한 팀 전체 동기화(계획 중)

License – MIT.

---

Skills Manager는 여러 LLM 기반 코딩 어시스턴트를 사용하는 개발자들이 에이전트별 프롬프트 확장 기능의 성장하는 생태계를 통합적으로 관리할 수 있는 실제 생산성 도구입니다.