@funtools/skills-manager

CLI tool to manage and install custom AI skills for Antigravity, Gemini, and code IDE agents.

Easily distribute and maintain collections of specialized skills across your system or team workspace repositories.

🌟 Key Features

• Store Multiple Skills in One Place: Manage all your organization's or personal AI skills in a single, well-organized repository.
• Global Installation (Default): Automatically installs skills to ~/.gemini/config/skills/, instantly making them accessible in every IDE session on your machine without reloading.
• Workspace Scoping (--workspace / -w): Install skills into .agents/skills/ at your project root to commit and share with teammates via git.
• Custom Destination (--dest <path> / -d <path>): Install skills into any custom folder of your choice.
• Clean Manifest Tracking: Tracks which skills were installed by @funtools/skills-manager in each location, preventing unwanted deletions of your custom-authored skills during uninstall.
• Easy Extension: Adding a new skill takes seconds — simply add a folder with a SKILL.md file.

🚀 Quick Start

Run instantly with npx:

# List all bundled skills
npx @funtools/skills-manager list

# Install all skills globally
npx @funtools/skills-manager install --all

# Or install specific skills
npx @funtools/skills-manager install code-review git-commit-helper

Or install globally on your system:

npm install -g @funtools/skills-manager

skills-manager list
skills-manager install --all

📖 CLI Usage & Commands

1. list

List all skills packaged in this repository along with their descriptions.

skills-manager list

2. install

Install one or more skills.

# Default: Installs globally (~/.gemini/config/skills/)
skills-manager install --all
skills-manager install hello-world code-review

# Workspace: Installs into current project's .agents/skills/
skills-manager install --workspace --all
skills-manager install -w hello-world

# Custom destination: Installs into user-provided directory
skills-manager install --dest ./custom-skills-dir --all
skills-manager install -d /path/to/my/skills hello-world

3. installed

Inspect installed skills and when they were installed.

# Inspect global installs
skills-manager installed

# Inspect workspace installs
skills-manager installed --workspace

# Inspect custom directory
skills-manager installed --dest ./custom-skills-dir

4. update

Re-install/refresh skills from the latest package version.

skills-manager update --all
skills-manager update --workspace --all

5. uninstall

Safely remove installed skills. Only removes skills tracked by the manifest.

# Remove global skill
skills-manager uninstall hello-world

# Remove workspace skill
skills-manager uninstall --workspace hello-world

# Remove from custom directory
skills-manager uninstall --dest ./custom-skills-dir hello-world

6. info

Display full metadata for a specific skill.

skills-manager info code-review

🛠️ How to Add New Skills to This Repo

1. Create a new directory inside skills/:

   mkdir skills/my-new-skill

2. Create a SKILL.md inside that directory with YAML frontmatter:

   ---
   name: my-new-skill
   description: >-
     Explain what this skill does and when the agent should use it.
   ---
   
   # My New Skill Title
   
   Detailed workflow, steps, and rules for the agent...

3. (Optional) Add auxiliary folders:

   • scripts/: Shell scripts or utilities the agent can run.
   • references/: Detailed reference documentation, API specs, checklists.
   • examples/: Code samples and reference implementations.
   • resources/: Templates or static assets.

4. Verify your skill appears in the registry:

   node bin/skills-manager.js list

5. Publish a new package version or commit to your repository!

📂 Repository Structure

SkillsManager/
├── bin/
│   └── skills-manager.js         # CLI entry point
├── src/
│   ├── cli.js                    # Commander CLI definitions
│   ├── installer.js              # Installation & lifecycle engine
│   ├── registry.js               # Skill scanner & frontmatter parser
│   └── utils.js                  # Path resolution & file system helpers
├── skills/                       # Bundled skills directory
│   ├── hello-world/              # Test & demo skill
│   ├── code-review/              # Structured code review skill
│   ├── git-commit-helper/        # Conventional commit generator
│   └── improve-ui/               # High-craft UI/UX polish & redesign skill
├── package.json
└── README.md

📄 License

MIT © funtools