Clutch Skills

Universal Skills Loader for AI Coding Agents - Manage skills across multiple AI platforms with ease.

Overview

Clutch Skills is a powerful CLI tool that helps you manage AI coding agent skills using the Anthropic SKILL.md format. It supports 16 different AI agent platforms, making it easy to install, organize, and sync skills across your development workflow.

Supported AI Agents

• Amp • Auggie CLI • Claude Code • CodeBuddy CLI
• Codex CLI • Cursor • Gemini CLI • GitHub Copilot
• IBM Bob • Jules • Kilo Code • opencode
• Qwen Code • Roo Code • SHAI (OVHcloud) • Windsurf

Note: Amazon Q Developer CLI is not supported due to lack of custom argument support.

Features

✨ Agent-Specific Configuration - One agent per project with clear isolation
📦 Git Repository Support - Install skills from any Git repository
🏪 Marketplace System - Register and discover skills from marketplace repositories
🔌 Plugin Discovery - Browse and install skills from registered marketplaces
🔄 Easy Synchronization - Update AGENTS.md with XML-formatted skill listings
🎨 Beautiful CLI - Modern, interactive prompts powered by Clack
🛡️ Validation - Automatic SKILL.md format and frontmatter validation
🗑️ Smart Management - Interactive skill removal with multi-select support

Installation

# Using npm
npm install -g clutch-skills

# Using yarn
yarn global add clutch-skills

# Using pnpm
pnpm add -g clutch-skills

# Using bun
bun add -g clutch-skills

Updating

To update clutch to the latest version:

# Using npm
npm install -g clutch-skills@latest

# Using yarn
yarn global add clutch-skills@latest

# Using pnpm
pnpm add -g clutch-skills@latest

# Using bun
bun add -g clutch-skills@latest

Check your current version:

clutch --version

Quick Start

# 1. Initialize with your AI agent
clutch init

# 2. Add a marketplace
clutch marketplace add https://github.com/user/marketplace-repo

# 3. Browse available plugins
clutch search

# 4. Install a plugin
clutch install plugin-id

# 5. Or install from Git repository
clutch install https://github.com/user/skills-repo

# 6. List installed skills
clutch list

# 7. Sync skills to AGENTS.md
clutch sync

Commands

init

Initialize agent configuration for your project.

clutch init

This command:

• Prompts you to select your AI agent platform
• Creates .clutchrc.json configuration file
• Sets up the skills directory for your chosen agent

Example:

$ clutch init
? Select your AI agent platform:
  ○ Cursor
  ○ Claude Code
  ○ Windsurf
  ...

list

List all installed skills for the configured agent.

clutch list

Output:

📦 Installed Skills

Agent: Cursor

  ✓ Python Testing - Automated testing utilities
  ✓ API Documentation - API doc generation
  ✓ Code Review - Code review assistant

Total: 3 skill(s)

install <source>

Install skills from a Git repository or plugin ID.

clutch install <source> [options]

Options:

• --skip-prompt - Skip interactive prompts and install all skills

Sources:

• Git repository: https://github.com/user/repo
• Plugin ID: plugin-id (from registered marketplaces)

Examples:

# Install from GitHub
clutch install https://github.com/anthropics/skills-repo

# Install from marketplace
clutch install python-testing

# Install without prompts
clutch install https://github.com/user/repo --skip-prompt

Interactive Flow:

$ clutch install https://github.com/user/skills-repo
📥 Install Skills
Agent: Cursor

⠋ Cloning repository...
✓ Found 3 skill(s)

? Select skills to install:
  ☑ Python Testing
  ☑ API Documentation
  ☐ Code Review

✓ Installed 2 skill(s)

✨ Installation complete!

sync

Sync selected skills to AGENTS.md with XML formatting.

clutch sync

This command:

• Discovers all installed skills
• Allows interactive selection of skills to sync
• Generates XML-formatted skills list
• Updates or creates AGENTS.md in your agent directory

Example:

$ clutch sync
🔄 Sync Skills to AGENTS.md

✓ Found 3 skill(s)

? Select skills to sync to AGENTS.md:
  ☑ Python Testing
  ☑ API Documentation

✓ AGENTS.md updated

✨ Successfully synced 2 skill(s) to AGENTS.md

remove [skill-name]

Remove a specific skill or manage skills interactively.

clutch remove [skill-name]

Examples:

# Interactive mode (multi-select removal)
$ clutch remove
🗑️  Manage Skills

✓ Found 3 skill(s)

? Select skills to remove:
  ☐ Python Testing
  ☑ API Documentation
  ☐ Code Review

? Remove 1 skill(s)? yes

✓ Removed 1 skill(s)

# Direct removal
$ clutch remove python-testing
✓ Removed skill: python-testing

uninstall

Completely remove Clutch Skills and all associated data.

clutch uninstall

This command removes:

• The .clutchrc.json configuration file
• The configured skills directory
• The AGENTS.md file

Example:

$ clutch uninstall
🗑️  Uninstall Clutch Skills
Current agent: Cursor

? This will completely remove clutch and all data. Continue? yes
✓ Uninstallation complete

✨ Successfully uninstalled clutch!

marketplace add <repo-url>

Add a marketplace repository for plugin discovery.

clutch marketplace add <repo-url>

This command:

• Clones the marketplace repository
• Validates the .clutch/marketplace.json manifest
• Registers the marketplace in your configuration
• Makes plugins available for discovery and installation

Example:

clutch marketplace add https://github.com/user/clutch-marketplace
✓ Marketplace added: Community Skills

marketplace list

List all registered marketplaces.

clutch marketplace list

Output:

📦 Registered Marketplaces

  ✓ Community Skills
    A collection of community-contributed skills
    URL: https://github.com/user/clutch-marketplace
    Plugins: 15
    Last updated: 12/1/2025

Total: 1 marketplace(s)

marketplace remove <name>

Remove a registered marketplace.

clutch marketplace remove <name>

Example:

clutch marketplace remove "Community Skills"
? Remove marketplace "Community Skills"? yes
? Also delete cached repository? yes
✓ Marketplace removed

marketplace update [name]

Update marketplace(s) to fetch latest plugins.

clutch marketplace update [name]

If name is not specified, updates all marketplaces.

Example:

clutch marketplace update
✓ Updated 1 marketplace(s)

search

Search for plugins in registered marketplaces.

clutch search [options]

Options:

• --marketplace <name> - Filter by marketplace
• --tag <tag> - Filter by tag

Example:

$ clutch search

📦 Community Skills

  • Python Testing
    Automated testing utilities for Python projects
    ID: python-testing
    Version: 1.0.0
    Tags: python, testing

  • API Documentation
    API doc generation tool
    ID: api-docs
    Tags: documentation, api

Total: 2 plugin(s)

Install a plugin:
  clutch install <plugin-id>

Configuration

Clutch Skills stores configuration in .clutchrc.json in your project root:

{
  "agent": "cursor",
  "skillsDirectory": ".cursor/skills",
  "marketplaces": [
    {
      "name": "Community Skills",
      "url": "https://github.com/user/marketplace-repo",
      "addedAt": "2025-12-01T12:00:00.000Z"
    }
  ]
}

You can manually edit this file or run clutch init to reconfigure.

Skill Repository Format

Skills should follow the Anthropic SKILL.md format with YAML frontmatter:

---
name: Python Testing
description: Automated testing utilities for Python projects
version: 1.0.0
author: Your Name
tags:
  - python
  - testing
  - automation
---

# Python Testing Skill

[Skill content goes here...]

Directory Structure

your-skills-repo/
├── python-testing/
│   ├── SKILL.md
│   └── [optional bundled resources]
├── api-docs/
│   ├── SKILL.md
│   └── templates/
└── code-review/
    └── SKILL.md

Marketplace Repository Format

To create a marketplace repository, add a .clutch/marketplace.json manifest file:

{
  "name": "Community Skills",
  "description": "A collection of community-contributed skills",
  "author": "Community Contributors",
  "version": "1.0.0",
  "plugins": [
    {
      "id": "python-testing",
      "name": "Python Testing",
      "description": "Automated testing utilities for Python projects",
      "path": "skills/python-testing",
      "version": "1.0.0",
      "author": "Your Name",
      "tags": ["python", "testing"]
    },
    {
      "id": "api-docs",
      "name": "API Documentation",
      "description": "API doc generation tool",
      "path": "skills/api-docs",
      "version": "1.0.0",
      "tags": ["documentation", "api"]
    }
  ]
}

Marketplace Structure

marketplace-repo/
├── .clutch/
│   └── marketplace.json
└── skills/
    ├── python-testing/
    │   └── SKILL.md
    └── api-docs/
        └── SKILL.md

Security Considerations

🔒 Install from Trusted Sources Only

• Only install skills from repositories you trust
• Only add marketplaces from trusted sources
• Review SKILL.md content before installation
• Be cautious with skills that include bundled resources

🛡️ Validation

• Clutch Skills validates SKILL.md format and frontmatter
• Marketplace manifests are validated before registration
• Invalid skills are rejected during installation
• Temporary files are cleaned up after installation

Development

# Clone the repository
git clone https://github.com/uuhnaut69/clutch.git
cd clutch

# Install dependencies
bun install

# Build the project
bun run build

# Run tests
bun run test

# Type check
bun run typecheck

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Roadmap

• [x] Marketplace repository system
• [x] Plugin discovery and browsing
• [ ] Skill templates and scaffolding
• [ ] Skill versioning and updates
• [ ] Multi-agent skill sharing
• [ ] Skill dependency management
• [ ] Custom skill validators

License

MIT © uuhnaut69

Acknowledgments

• Built with Commander.js
• Interactive prompts by Clack
• Powered by TypeScript
• Inspired by the Anthropic SKILL.md format

Made with ❤️ for the AI coding community