codebase-health

Somepulp Agents

A plugin marketplace for Claude Code providing specialized agents for code auditing, research, and multi-model consultation.

What Are These Plugins?

Claude Code plugins extend functionality through custom slash commands, specialized agents, and skills. Each plugin in this marketplace can be installed independently, letting you pick the tools that fit your workflow.

Available Plugins

Plugin	Description	Contents
codebase-health	Comprehensive codebase health tools: code audits, dead code detection, and documentation maintenance	Commands: /deep-audit, /dead-code, /update-docs Agents: deep-audit, dead-code-cleanup, update-docs Skills: code-auditing, docs-maintenance
second-opinion	Get second opinions from Codex CLI and Gemini CLI	Commands: /codex-opinion, /gemini-opinion Agents: codex-consultant, gemini-consultant Skill: ai-consultation
research-assistant	Research libraries and APIs using official documentation	Commands: /research, /official-docs Agents: research-assistant, official-docs MCP: Context7, Fetch

Installation

From GitHub

1. Add the marketplace to Claude Code:

   /plugin marketplace add jeffrigby/somepulp-agents
   

2. Install the plugins you want:

   /plugin install codebase-health@somepulp-agents
   /plugin install second-opinion@somepulp-agents
   /plugin install research-assistant@somepulp-agents
   

Or use the interactive /plugin command to browse and install.

Manual Installation (for development)

# Clone the repository
git clone https://github.com/jeffrigby/somepulp-agents.git

# In Claude Code, add as local marketplace
/plugin marketplace add /path/to/somepulp-agents

# Then install the plugins you want
/plugin install codebase-health@somepulp-agents

Requirements

Plugin	Requirements
research-assistant	Recommended: Context7 and Fetch MCP servers (install separately). Falls back to WebSearch/WebFetch if unavailable.
second-opinion	OpenAI Codex CLI + OPENAI_API_KEY or CODEX_API_KEY for Codex; Google Gemini CLI + Google OAuth or GEMINI_API_KEY for Gemini

Plugin Structure

Each plugin follows the standard Claude Code plugin structure:

plugin-name/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata
├── commands/                # Slash commands (optional)
├── agents/                  # Specialized agents (optional)
├── skills/                  # Agent skills (optional)
├── scripts/                 # Helper scripts (optional)
├── .mcp.json                # MCP server configuration (optional)
└── README.md                # Plugin documentation

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

MIT License - see LICENSE for details.

Learn More

• Claude Code Documentation
• Plugin System Documentation