Skills Manager MCP Server & CLI (skills-manager-mcp)

A production-ready CLI tool and Model Context Protocol (MCP) server for Antigravity Desktop that acts as your personal AI development environment manager.

It features zero-config automatic first-run initialization, workspace detection, headless skill & bundle installation, global skill caching, personal skill collection merging, schema version migrations, and health diagnostics.

Installation

Install globally using standard npm or pnpm (no extra security flags or install script approvals required):

npm install -g skills-manager-mcp

Automatic First-Run Initialization

skills-manager-mcp does not rely on npm postinstall lifecycle scripts (which npm security policies often block).

Instead, the very first time you run any command:

skills-manager-mcp status

(or when Antigravity Desktop invokes any MCP tool), the tool automatically detects first-time usage and configures itself:

Skills Manager MCP first-time setup detected...

✓ Global storage initialized: C:\Users\<username>\.ai-skills
✓ Skills cache ready: C:\Users\<username>\.ai-skills\cache
✓ Antigravity MCP registered: C:\Users\<username>\.gemini\antigravity-ide\mcp.json
✓ Server executable path: C:\Users\<username>\AppData\Roaming\npm\node_modules\skills-manager-mcp\dist\index.js

Initialization complete.

Subsequent executions skip initialization instantly because all configurations are already verified and active!

CLI Commands

1. skills-manager-mcp status

Displays the status dashboard (global config presence, cache statistics, Antigravity MCP registration status, detected workspace, and installed skills). Triggers auto-initialization on first run.

2. skills-manager-mcp doctor

Runs diagnostic health checks on your installation, configuration, global cache, and MCP registration.

skills-manager-mcp doctor

Example Output:

Skills Manager Doctor

✓ dist/index.js exists
✓ Antigravity configuration exists
✓ MCP path valid
✓ Global cache available
✓ skills.config.json valid

Everything is healthy.

3. skills-manager-mcp bootstrap

Prepares the current project workspace automatically.

• Detects active workspace

• Creates .agents/skills/

• Merges personal (~/.ai-skills/skills.config.json) and project skills

• Installs skills/bundles headlessly from global cache or remote Git repositories

• Updates version metadata tracker (.agents/skills-manager.json)

4. skills-manager-mcp sync

Synchronizes current workspace skills with your global personal collection (~/.ai-skills/skills.config.json).

5. skills-manager-mcp remove <skill1> [skill2]

Removes one or an array of specified skills or bundles from the project workspace .agents/skills.

• Option --from-config also removes them from skills.config.json to prevent auto-reinstallation.

# Remove single skill
skills-manager-mcp remove find-skills

# Batch remove multiple skills & bundles
skills-manager-mcp remove find-skills frontend-design mattpocock-skills --from-config

6. skills-manager-mcp setup

Re-run setup & Antigravity MCP registration manually anytime.

Configuration (~/.ai-skills/skills.config.json)

You can manage your master list of skills and bundles globally at C:\Users\<username>\.ai-skills\skills.config.json:

{
  "skills": [
    {
      "type": "skill",
      "name": "find-skills",
      "repository": "https://github.com/vercel-labs/skills",
      "skill": "find-skills"
    },
    {
      "type": "skill",
      "name": "frontend-design",
      "repository": "https://github.com/anthropics/skills",
      "skill": "frontend-design"
    },
    {
      "type": "bundle",
      "name": "mattpocock-skills",
      "repository": "https://github.com/mattpocock/skills"
    }
  ]
}

MCP Server Tools Reference

When running inside Antigravity Desktop, the following MCP tools are available:

• bootstrap_project: Prepares active workspace with skills and bundles.

• sync_skills: Synchronizes workspace skills with personal collection.

• install_skills: Installs missing skills and bundles.

• remove_skills: Removes one or an array of specified skills/bundles from workspace.

• list_installed_skills: Lists installed skills and bundle details.

• check_missing_skills: Checks status of skills/bundles.

• get_workspace_info: Debugging tool for inspecting workspace resolution.

Development & Testing Commands

# Install dependencies
pnpm install

# Run unit tests
pnpm test

# Compile TypeScript (generates dist/index.js and dist/cli.js)
pnpm run build

# Create npm distribution tarball
npm pack

# Link locally for testing
npm link