{"_id":"@daviabreu/skills-mgr","_rev":"4-fdc0d707ca591c1b9ea5a81434bd1af5","name":"@daviabreu/skills-mgr","dist-tags":{"latest":"2.2.1"},"versions":{"1.0.0":{"name":"@daviabreu/skills-mgr","version":"1.0.0","keywords":["claude","claude-code","skills","manager","tui","cli"],"author":{"name":"daviiabreu"},"license":"MIT","_id":"@daviabreu/skills-mgr@1.0.0","maintainers":[{"name":"daviabreu","email":"daviabreudasilveira@gmail.com"}],"homepage":"https://github.com/daviiabreu/skills-mgr","bugs":{"url":"https://github.com/daviiabreu/skills-mgr/issues"},"os":["darwin","linux"],"bin":{"skills-mgr":"skills-mgr"},"dist":{"shasum":"ae0a1a2c3edd124443ba35219a0c0b83c6f29df2","tarball":"https://registry.npmjs.org/@daviabreu/skills-mgr/-/skills-mgr-1.0.0.tgz","fileCount":4,"integrity":"sha512-MyIGal7iANPDUMWYVK8Y1n1Sgy4ISQ3G2N/MaqEjGQYKfO4qkSNQrRucpvkqtbkiVRngFJFnctNQFSRkIWtXKw==","signatures":[{"sig":"MEQCIBeEizcVLBBA+fx82o6tvPa0iDJt/L0uN1Ix69kNALZ+AiBGAOJVorhVor1hsRu1j+XojYhM9wjei/W4GiNfAhzrYg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57158},"engines":{"node":">=14"},"gitHead":"2ba062e8583972519cef9ac14d166434f998a149","_npmUser":{"name":"daviabreu","email":"daviabreudasilveira@gmail.com"},"repository":{"url":"git+https://github.com/daviiabreu/skills-mgr.git","type":"git"},"_npmVersion":"11.11.1","description":"Interactive TUI and CLI for managing Claude Code skills globally and per-project","directories":{},"_nodeVersion":"25.8.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/skills-mgr_1.0.0_1774498708694_0.4517795728401275","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@daviabreu/skills-mgr","version":"2.0.0","keywords":["claude","claude-code","gemini-cli","codex","opencode","skills","manager","tui","cli","ai-tools"],"author":{"name":"daviiabreu"},"license":"MIT","_id":"@daviabreu/skills-mgr@2.0.0","maintainers":[{"name":"daviabreu","email":"daviabreudasilveira@gmail.com"}],"homepage":"https://github.com/daviiabreu/skills-mgr","bugs":{"url":"https://github.com/daviiabreu/skills-mgr/issues"},"os":["darwin","linux"],"bin":{"skills-mgr":"skills-mgr"},"dist":{"shasum":"8dd8a64bdce7945584d95614fa87b470e19c968a","tarball":"https://registry.npmjs.org/@daviabreu/skills-mgr/-/skills-mgr-2.0.0.tgz","fileCount":5,"integrity":"sha512-mRRshrebNqboOjKpkoB5MzFqsfbh+61NJ7sSPQmKw9t1DKYeG0NMaFExDR+gujDNkag7tYK5JpNfpEMXc5n3Og==","signatures":[{"sig":"MEUCIQDSswOg5Q6MOWY6Pd/ls1HmiDko0wyfYx2YiHSnKpnuYQIgJ4ORQBnVP8PLbF55+UHjPXZw5Biyye7DzPdOl/ARwcs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":66548},"engines":{"node":">=14"},"gitHead":"ed6dc7007908cb40619b16d96b8ca9c8ee17b052","_npmUser":{"name":"daviabreu","email":"daviabreudasilveira@gmail.com"},"repository":{"url":"git+https://github.com/daviiabreu/skills-mgr.git","type":"git"},"_npmVersion":"11.11.1","description":"Universal TUI and CLI for managing AI coding tool skills (Claude Code, Gemini CLI, Codex, OpenCode)","directories":{},"_nodeVersion":"25.8.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/skills-mgr_2.0.0_1774791985466_0.2874135494611698","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"@daviabreu/skills-mgr","version":"2.2.0","keywords":["claude-code","gemini-cli","codex","opencode","cursor","windsurf","copilot","cline","roo","augment","kilo","skills","manager","tui","cli","ai-tools"],"author":{"name":"daviiabreu"},"license":"MIT","_id":"@daviabreu/skills-mgr@2.2.0","maintainers":[{"name":"daviabreu","email":"daviabreudasilveira@gmail.com"}],"homepage":"https://github.com/daviiabreu/skills-mgr","bugs":{"url":"https://github.com/daviiabreu/skills-mgr/issues"},"os":["darwin","linux"],"bin":{"skills-mgr":"skills-mgr"},"dist":{"shasum":"c63b1990cfec04b79320dcf509b8d0f74d42fbb4","tarball":"https://registry.npmjs.org/@daviabreu/skills-mgr/-/skills-mgr-2.2.0.tgz","fileCount":5,"integrity":"sha512-yC8W3SyOUU08Yifw6QfBGS7tHz85SI0dVNI9mqz6+Yzl7YkGe/iRdBDn+7cBlzQL8wO1mrn8RuI3Z4XW5mZPCA==","signatures":[{"sig":"MEYCIQDo3+L1aunYytf5zYFHuErAvrNO2iObUKdN2dhcfW5gnwIhANh9AOXmHYQLVxyGITRxtL0ywz8Mw9dHzNnpCLM+W4LT","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":78616},"engines":{"node":">=14"},"gitHead":"08f5c5ac21efdc64549a1f38001a0a27fe44f6ab","_npmUser":{"name":"daviabreu","email":"daviabreudasilveira@gmail.com"},"repository":{"url":"git+https://github.com/daviiabreu/skills-mgr.git","type":"git"},"_npmVersion":"11.11.1","description":"Universal TUI and CLI for managing AI coding tool skills across 19 agents","directories":{},"_nodeVersion":"25.8.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/skills-mgr_2.2.0_1774974844935_0.13125115821582645","host":"s3://npm-registry-packages-npm-production"}},"2.2.1":{"name":"@daviabreu/skills-mgr","version":"2.2.1","description":"Universal TUI and CLI for managing AI coding tool skills across 19 agents","bin":{"skills-mgr":"skills-mgr"},"keywords":["claude-code","gemini-cli","codex","opencode","cursor","windsurf","copilot","cline","roo","augment","kilo","skills","manager","tui","cli","ai-tools"],"author":{"name":"daviiabreu"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/daviiabreu/skills-mgr.git"},"homepage":"https://github.com/daviiabreu/skills-mgr","os":["darwin","linux"],"engines":{"node":">=14"},"gitHead":"0c1dcd4dce5652227f25980fcce2678040d30002","_id":"@daviabreu/skills-mgr@2.2.1","bugs":{"url":"https://github.com/daviiabreu/skills-mgr/issues"},"_nodeVersion":"25.8.2","_npmVersion":"11.11.1","dist":{"integrity":"sha512-vvePXfQSN87tW6KkC1ntGTw9r13eYP0j0so1N/gteSemox/Z9FJPuyavkKymPjLmPJmZIHFWozmLT0GR4mbmig==","shasum":"7d7e5615589fae80ec9c00b04542bb7a23c079c9","tarball":"https://registry.npmjs.org/@daviabreu/skills-mgr/-/skills-mgr-2.2.1.tgz","fileCount":5,"unpackedSize":80330,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIG0q93pJ53j8hWhIzvye4Rs5WYekKjIUPlNL7bPGTrFLAiBx47JoUDXXVQ3kQjkqbmzVEPFA2Bl4gEXIakA8f47Ucg=="}]},"_npmUser":{"name":"daviabreu","email":"daviabreudasilveira@gmail.com"},"directories":{},"maintainers":[{"name":"daviabreu","email":"daviabreudasilveira@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/skills-mgr_2.2.1_1774975907543_0.7199059426908536"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-26T04:18:28.600Z","modified":"2026-03-31T16:51:47.835Z","1.0.0":"2026-03-26T04:18:28.836Z","2.0.0":"2026-03-29T13:46:25.648Z","2.2.0":"2026-03-31T16:34:05.075Z","2.2.1":"2026-03-31T16:51:47.737Z"},"bugs":{"url":"https://github.com/daviiabreu/skills-mgr/issues"},"author":{"name":"daviiabreu"},"license":"MIT","homepage":"https://github.com/daviiabreu/skills-mgr","keywords":["claude-code","gemini-cli","codex","opencode","cursor","windsurf","copilot","cline","roo","augment","kilo","skills","manager","tui","cli","ai-tools"],"repository":{"type":"git","url":"git+https://github.com/daviiabreu/skills-mgr.git"},"description":"Universal TUI and CLI for managing AI coding tool skills across 19 agents","maintainers":[{"name":"daviabreu","email":"daviabreudasilveira@gmail.com"}],"readme":"<p align=\"center\">\n  <h1 align=\"center\">skills-mgr</h1>\n  <p align=\"center\">\n    Manage AI coding tool skills from the terminal.\n    <br />\n    One source of truth. Any tool. Global or per-project.\n  </p>\n  <p align=\"center\">\n    <a href=\"#install\">Install</a> &middot;\n    <a href=\"#quick-start\">Quick Start</a> &middot;\n    <a href=\"#supported-tools\">Supported Tools</a> &middot;\n    <a href=\"#cli-reference\">CLI Reference</a>\n  </p>\n</p>\n\n<br />\n\n```\n┌────────────────────────────────────────────────────────────────┐\n│ Skills Manager  ·  Claude Code  ·  12/47 global  ·  3 projects │\n└────────────────────────────────────────────────────────────────┘\n\n  📌  my-project (5 skills)\n  🔧  Manage global skills\n  📁  Manage by project\n  🔍  Search skill\n  📊  Full status\n  ⚙️  Target tool\n  🌐  Language\n  ❌  Exit\n```\n\n## Why\n\nAI coding tools ship with 100+ skills. Most are noise for any given project. `skills-mgr` lets you toggle skills on/off globally or per-project — across 19 AI coding agents — from a single place.\n\n## Supported Tools\n\n| Tool               | Global Skills                | Project Skills                |\n| ------------------ | ---------------------------- | ----------------------------- |\n| **AMP**            | `~/.amp/skills/`             | `<project>/.amp/skills/`      |\n| **Augment Code**   | `~/.augment/skills/`         | `<project>/.augment/skills/`  |\n| **Claude Code**    | `~/.claude/skills/`          | `<project>/.claude/skills/`   |\n| **Cline**          | `~/.cline/skills/`           | `<project>/.cline/skills/`    |\n| **Codex**          | `~/.agents/skills/`\\*        | `<project>/.agents/skills/`   |\n| **Continue**       | `~/.continue/skills/`        | `<project>/.continue/skills/` |\n| **Cursor**         | `~/.cursor/skills/`          | `<project>/.cursor/skills/`   |\n| **Factory/Droid**  | `~/.factory/skills/`         | `<project>/.factory/skills/`  |\n| **Gemini CLI**     | `~/.gemini/skills/`          | `<project>/.gemini/skills/`   |\n| **GitHub Copilot** | `~/.copilot/skills/`         | `<project>/.github/skills/`   |\n| **Goose**          | `~/.config/goose/skills/`    | `<project>/.goose/skills/`    |\n| **Kilo Code**      | `~/.kilo/skills/`            | `<project>/.kilo/skills/`     |\n| **Kiro**           | `~/.kiro/skills/`            | `<project>/.kiro/skills/`     |\n| **OpenCode**       | `~/.config/opencode/skills/` | `<project>/.opencode/skills/` |\n| **Roo Code**       | `~/.roo/skills/`             | `<project>/.roo/skills/`      |\n| **Trae**           | `~/.trae/skills/`            | `<project>/.trae/skills/`     |\n| **VS Code**        | `~/.vscode/skills/`          | `<project>/.vscode/skills/`   |\n| **Windsurf**       | `~/.agents/skills/`\\*        | `<project>/.agents/skills/`   |\n| **Zed**            | `~/.zed/skills/`             | `<project>/.zed/skills/`      |\n\n> \\* Codex and Windsurf read directly from source — all skills are always visible globally. Per-project scoping still works.\n\nAll tools use the same `SKILL.md` format. Switch targets anytime with `skills-mgr tool <name>`.\n\n## Install\n\n### Homebrew (coming soon)\n\n```bash\nbrew install daviabreu/tap/skills-mgr\n```\n\n### npm\n\n```bash\nnpm i -g @daviabreu/skills-mgr\n```\n\n### Manual\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/daviiabreu/skills-mgr/main/skills-mgr \\\n  -o ~/.local/bin/skills-mgr && chmod +x ~/.local/bin/skills-mgr\n```\n\n### Dependencies\n\n- [gum](https://github.com/charmbracelet/gum) — `brew install gum`\n\n## Quick Start\n\n```bash\n# Launch interactive TUI\nskills-mgr\n\n# Or use CLI directly\nskills-mgr tool gemini          # target Gemini CLI\nskills-mgr on find-skills       # enable a skill globally\nskills-mgr off @recipe          # disable an entire category\nskills-mgr project add          # register current dir\nskills-mgr project enable . @gws  # enable GWS skills in this project\n```\n\nOn first run, you'll be asked to choose a language (English or Portuguese).\n\n## How It Works\n\n```\n~/.agents/skills/              ← source of truth (all installed skills)\n  ├── gws-gmail/SKILL.md\n  ├── find-skills/SKILL.md\n  └── ...\n\n~/.claude/skills/              ← Claude Code (symlinks to source)\n  ├── find-skills → ~/.agents/skills/find-skills\n  └── ...\n\n~/.gemini/skills/              ← Gemini CLI (symlinks to source)\n  └── ...\n\n~/my-project/.claude/skills/   ← project-scoped (symlinks to source)\n  ├── gws-gmail → ~/.agents/skills/gws-gmail\n  └── ...\n```\n\nSkills are never copied — only symlinked. Enable/disable is instant. Global skills are inherited by all projects. Project skills add on top.\n\n## npm Sync\n\nInstall npm packages that ship skills and keep them synced:\n\n```bash\n# Install a package and auto-discover its skills\nskills-mgr install @some-org/agent-skills\n\n# Sync all global npm packages (discover new, remove orphans)\nskills-mgr sync\n\n# Uninstall a package and clean up its skills\nskills-mgr uninstall @some-org/agent-skills\n```\n\nnpm skills are symlinked (not copied). When a package is uninstalled, `sync` detects broken symlinks and removes them. Manual skills (real directories) are never touched.\n\nA manifest is saved at `~/.config/skills-mgr/npm-manifest.json` tracking which skills came from npm.\n\n### Shipping skills in your npm package\n\nAdd a `skills/` directory to your package with subdirectories containing `SKILL.md`:\n\n```\nmy-package/\n  ├── package.json\n  └── skills/\n      ├── my-skill-a/\n      │   └── SKILL.md\n      └── my-skill-b/\n          └── SKILL.md\n```\n\n## TUI Features\n\n- **Fuzzy search** across all skills with descriptions\n- **Multi-select** enable/disable (space to select, enter to confirm)\n- **Category toggles** — enable/disable `@gws`, `@recipe`, `@persona` etc. in one shot\n- **Project management** — register projects, scope skills, compare with global\n- **Tool switching** — change target tool without leaving the TUI\n- **i18n** — English and Portuguese\n\n## CLI Reference\n\n```\nskills-mgr                                 Interactive TUI\nskills-mgr tool [name]                         Get/set target tool\nskills-mgr status [category]               Show skill status\nskills-mgr on|enable <skill|@cat>          Enable globally\nskills-mgr off|disable <skill|@cat>        Disable globally\nskills-mgr info <skill>                    Skill details\nskills-mgr cats                            List categories\nskills-mgr ps                              List registered projects\nskills-mgr sync                            Sync skills from npm packages\nskills-mgr install <package>               npm install + sync\nskills-mgr uninstall <package>             npm uninstall + sync\nskills-mgr project add [path]              Register project (default: .)\nskills-mgr project rm <path>               Unregister project\nskills-mgr project status [path]           Show project skills\nskills-mgr project enable [path] <skill|@cat>   Enable in project\nskills-mgr project disable [path] <skill|@cat>  Disable in project\nskills-mgr lang <en|pt>                    Set language\n```\n\n## Categories\n\nBatch operations with `@category`:\n\n| Category   | Prefix          | Example                 |\n| ---------- | --------------- | ----------------------- |\n| `@gws`     | `gws-*`         | `skills-mgr off @gws`   |\n| `@recipe`  | `recipe-*`      | `skills-mgr on @recipe` |\n| `@persona` | `persona-*`     |                         |\n| `@plugin`  | `plugin-*`      |                         |\n| `@writing` | `writing-*`     |                         |\n| `@other`   | everything else |                         |\n\n## Config\n\nStored in `~/.config/skills-mgr/`:\n\n| File            | Purpose                  |\n| --------------- | ------------------------ |\n| `tool.conf`     | Active target tool       |\n| `lang.conf`     | Language (en/pt)         |\n| `projects.conf` | Registered project paths |\n\n> Migrates automatically from `~/.claude/skills-mgr/` on first run.\n\n## Skill Advisor\n\nIncluded skill that analyzes your project and recommends what to enable:\n\n```bash\n# Inside Claude Code\n/skill-advisor\n```\n\nDetects `package.json`, `Cargo.toml`, `go.mod`, etc. and outputs ready-to-run `skills-mgr` commands.\n\n## Requirements\n\n- bash 3.2+\n- [gum](https://github.com/charmbracelet/gum)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}