yibie/skills-manager

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

What it is

• A native macOS (Sonoma +) application, written in SwiftUI/Swift 6, that lets you discover, install, test and organise skills (prompt‑oriented extensions) for a large list of code‑generation agents such as Claude Code, Cursor, Gemini CLI, OpenHands, etc.
• It treats the local filesystem as the single source of truth: a Library holds the original skill packages, Collections group them for a project or workflow, and Mounts create symlinks into each agent’s own skill directory on demand.

Key concepts

Layer	Role
Library	Central, read‑only store of every downloaded skill package.
Collection	Re‑usable named groups of Library skills (e.g., Web‑dev, Data‑Science).
Mount	A set of symlinks that expose a Collection inside one or more agents without copying files.

Main features

• Discover – pulls skill listings from the public skills.sh catalogue, caches them locally, and supports full‑site search when online.
• Try – run a skill against a locally‑configured LLM (Claude, OpenAI, OpenRouter, Ollama, LM Studio) before committing it.
• Install / Uninstall – one‑click installation to any subset of supported agents; unmounting only removes the symlinks, leaving the Library untouched.
• Conflict & state view – shows missing, shared, partially‑applied or diverged copies across agents, letting you resolve them manually.
• Translation – built‑in 8‑language catalog for skill descriptions plus on‑demand LLM fallback for new entries.
• Terminal UI – a blessed‑style TUI (tui/) that mirrors the macOS app’s functionality and keeps a local Git history for roll‑backs.
• Automatic monitoring – watches agent skill folders and refreshes the UI when files change on disk.

Supported agents (detected via an internal AgentRegistry). The table in the README lists over 40 agents; those marked Install target can be selected in the multi‑install picker, while the rest are still scanned for conflicts.

Installation

1. Download the signed zip from the GitHub releases page and drag the app into Applications (macOS 14+ required).
2. Or build from source with Xcode (open SkillsManager.xcodeproj).
3. For the TUI, cd tui && npm exec skills-manager (or npm link for a global skills-manager command).

Architecture & offline stance

• Purely local‑first: no remote backend, no data leaves the machine except when you explicitly refresh the catalogue, translate a description, or call an LLM for a Try.
• The app writes directly into each agent’s configuration files and maintains a local Git log of skill installs for diff/rollback.
• Discovery data is cached at ~/.skills-manager/cache/discover-directory.json; network is only used for catalogue refresh, full‑site search, translation fallback, and LLM Try calls.

Roadmap (as of the README)

• Auto‑update detection for discovered skills (planned)
• Export / import of skill sets (planned)
• Team‑wide sync via a shared repository (planned)

License – MIT.

---

Skills Manager is a genuine, production‑grade tool for developers who work with multiple LLM‑based coding assistants and need a unified way to manage the growing ecosystem of agent‑specific prompt extensions.