Agent Reverse

npm MCP License: MIT

Extract tools, skills, and plugins from any source — GitHub repos, local configs, articles — and install only what you need. No cloning entire repositories for one function.

> /agent-reverse analyze https://github.com/anthropics/claude-code-plugins

Scanning repo... found 12 capabilities:

  SKILLS (5)
    code-review        Review PRs for bugs, security, performance     [/command]
    test-runner        Run and report test suites                      [/command]
    feature-dev        Guided feature development                     [/command]
    explanatory-style  Educational output mode                        [agent-only]
    learning-style     Quiz-based learning mode                       [agent-only]

  MCP SERVERS (2)
    typescript-lsp     TypeScript language intelligence
    pyright-lsp        Python type checking

  Security scan: all clear (0 critical, 0 medium)

  Which capabilities would you like to install?

Table of Contents

• Features
• Install
• Quick Start
• Commands
• Security Scanning
• Agent Portability
• Backup and Restore
• MCP Tools Reference
• Documentation
• Contributing

Features

• Analyze anything — GitHub repos, local files, Cursor configs, web articles, your own Claude Code setup
• Security scanning — 6-category pattern matching on every install (remote exec, data exfil, secret access, persistence, destructive ops, obfuscation)
• Manifest tracking — agent-reverse.json pins every installed capability to a source and commit, like package-lock.json for skills
• Cross-agent restore — back up from Claude Code, restore into Cursor or Antigravity (and vice versa)
• Subagent delegation — heavy operations (repo cloning, AST parsing, manifest diffing) run in an isolated agent-reverse-engine subagent
• Local introspection — analyze local inventories your environment, finds dead skills, deprecated settings, unreachable MCP servers
• Changelog awareness — detects Claude Code version bumps, auto-applies safe migrations, flags breaking changes

Install

As a Claude Code plugin (recommended)

/plugin marketplace add shihwesley/shihwesley-plugins
/plugin install agent-reverse@shihwesley-plugins

This installs the MCP server, skills, agents, and hooks automatically.

Via npx (standalone)

# Add MCP server
claude mcp add agent-reverse -- npx -y @shihwesley/agent-reverse agent-reverse-server

# Install skills and agents
npx -y @shihwesley/agent-reverse setup

Restart Claude Code after setup.

npm install -g @shihwesley/agent-reverse
claude mcp add agent-reverse -- agent-reverse-server
agent-reverse setup

git clone https://github.com/shihwesley/agent-reverse.git
cd agent-reverse
npm install && npm run build
claude mcp add agent-reverse -- node dist/server.js
node dist/cli.js setup

Requirements: Node.js >= 20.0.0

Quick Start

Analyze a repo and install one capability:

# 1. Point at any source
/agent-reverse analyze https://github.com/cool-user/search-plugin

# 2. Install what you need
/agent-reverse install search-lite

# 3. Check your setup
/agent-reverse audit

Health-check your local environment:

/agent-reverse analyze local

Returns: installed skills count, dead skills, deprecated settings, MCP server health, and optimization suggestions.

Commands

Source types for analyze: GitHub URL, local file path, local (your environment), article URL.

Security Scanning

Every install runs 6 checks before writing files:

Critical findings block the install. Use --force to override after reviewing the code.

Agent Portability

Backup from one, restore to another:

/agent-reverse backup --gist
/agent-reverse restore <gist-url> --target cursor

Backup and Restore

# Local backup
/agent-reverse backup

# GitHub Gist (private)
/agent-reverse backup --gist

# Restore with merge
/agent-reverse restore backup.json --merge

# Cross-agent dry run
/agent-reverse restore backup.json --target cursor --dry-run

What gets backed up: manifest, skills, commands, rules, CLAUDE.md, and caches.

MCP Tools Reference

30 tools organized by function:

Documentation

• PRD — vision and roadmap
• Tech spec — architecture and JSON schemas
• Test cases — real-world usage scenarios

Contributing

PRs for new agent adapters or language parsers welcome. See the tech spec for architecture details.

git clone https://github.com/shihwesley/agent-reverse.git
cd agent-reverse
npm install && npm run build
npm test

License

MIT