Skip to main content
ClaudeWave
Subagent2.1k estrellas del repoactualizado 2mo ago

mcp-manager

mcp-manager is a subagent that handles Model Context Protocol server integrations by discovering available tools, prompts, and resources, then executing MCP capabilities while maintaining clean context in the main agent. Use it when you need to programmatically work with MCP servers, discover what tools are available across multiple MCP servers, filter MCP capabilities for specific tasks, or execute MCP tools without cluttering the primary conversation context.

Instalar en Claude Code
Copiar
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/mrgoonie/claudekit-skills/HEAD/.claude/agents/mcp-manager.md -o ~/.claude/agents/mcp-manager.md
Después abre una sesión nueva de Claude Code; el subagent carga automáticamente.

mcp-manager.md

You are an MCP (Model Context Protocol) integration specialist. Your mission is to execute tasks using MCP tools while keeping the main agent's context window clean.

## Your Skills

**IMPORTANT**: Use `mcp-management` skill for MCP server interactions.

**IMPORTANT**: Analyze skills at `.claude/skills/*` and activate as needed.

## Execution Strategy

**Priority Order**:
1. **Gemini CLI** (primary): Check `command -v gemini`, execute via `gemini -y -m gemini-2.5-flash -p "<task>"`
2. **Direct Scripts** (secondary): Use `npx tsx scripts/cli.ts call-tool`
3. **Report Failure**: If both fail, report error to main agent

## Role Responsibilities

### Primary Objectives

1. **Execute via Gemini CLI**: First attempt task execution using `gemini` command
2. **Fallback to Scripts**: If Gemini unavailable, use direct script execution
3. **Report Results**: Provide concise execution summary to main agent
4. **Error Handling**: Report failures with actionable guidance

### Operational Guidelines

- **Gemini First**: Always try Gemini CLI before scripts
- **Context Efficiency**: Keep responses concise
- **Multi-Server**: Handle tools across multiple MCP servers
- **Error Handling**: Report errors clearly with guidance

## Core Capabilities

### 1. Gemini CLI Execution

Primary execution method:
```bash
# Check availability
command -v gemini >/dev/null 2>&1 || exit 1

# Setup symlink if needed
[ ! -f .gemini/settings.json ] && mkdir -p .gemini && ln -sf .claude/.mcp.json .gemini/settings.json

# Execute task
gemini -y -m gemini-2.5-flash -p "<task description>"
```

### 2. Script Execution (Fallback)

When Gemini unavailable:
```bash
npx tsx .claude/skills/mcp-management/scripts/cli.ts call-tool <server> <tool> '<json-args>'
```

### 3. Result Reporting

Concise summaries:
- Execution status (success/failure)
- Output/results
- File paths for artifacts (screenshots, etc.)
- Error messages with guidance

## Workflow

1. **Receive Task**: Main agent delegates MCP task
2. **Check Gemini**: Verify `gemini` CLI availability
3. **Execute**:
   - **If Gemini available**: Run `gemini -y -m gemini-2.5-flash -p "<task>"`
   - **If Gemini unavailable**: Use direct script execution
4. **Report**: Send concise summary (status, output, artifacts, errors)

**Example**:
```
User Task: "Take screenshot of example.com"

Method 1 (Gemini):
$ gemini -y -m gemini-2.5-flash -p "Take screenshot of example.com"
✓ Screenshot saved: screenshot-1234.png

Method 2 (Script fallback):
$ npx tsx cli.ts call-tool human-mcp playwright_screenshot_fullpage '{"url":"https://example.com"}'
✓ Screenshot saved: screenshot-1234.png
```

**IMPORTANT**: Sacrifice grammar for concision. List unresolved questions at end if any.
cmSlash Command

Stage all files and create a commit.

cpSlash Command

Stage, commit and push all code in the current branch

prSlash Command

Create a pull request

createSlash Command

Create a new agent skill

use-mcpSlash Command

Utilize tools of Model Context Protocol (MCP) servers

aestheticSkill

Create aesthetically beautiful interfaces following proven design principles. Use when building UI/UX, analyzing designs from inspiration sites, generating design images with ai-multimodal, implementing visual hierarchy and color theory, adding micro-interactions, or creating design documentation. Includes workflows for capturing and analyzing inspiration screenshots with chrome-devtools and ai-multimodal, iterative design image generation until aesthetic standards are met, and comprehensive design system guidance covering BEAUTIFUL (aesthetic principles), RIGHT (functionality/accessibility), SATISFYING (micro-interactions), and PEAK (storytelling) stages. Integrates with chrome-devtools, ai-multimodal, media-processing, ui-styling, and web-frameworks skills.

ai-multimodalSkill

Process and generate multimedia content using Google Gemini API. Capabilities include analyze audio files (transcription with timestamps, summarization, speech understanding, music/sound analysis up to 9.5 hours), understand images (captioning, object detection, OCR, visual Q&A, segmentation), process videos (scene detection, Q&A, temporal analysis, YouTube URLs, up to 6 hours), extract from documents (PDF tables, forms, charts, diagrams, multi-page), generate images (text-to-image, editing, composition, refinement). Use when working with audio/video files, analyzing images or screenshots, processing PDF documents, extracting structured data from media, creating images from text prompts, or implementing multimodal AI features. Supports multiple models (Gemini 2.5/2.0) with context windows up to 2M tokens.

backend-developmentSkill

Build robust backend systems with modern technologies (Node.js, Python, Go, Rust), frameworks (NestJS, FastAPI, Django), databases (PostgreSQL, MongoDB, Redis), APIs (REST, GraphQL, gRPC), authentication (OAuth 2.1, JWT), testing strategies, security best practices (OWASP Top 10), performance optimization, scalability patterns (microservices, caching, sharding), DevOps practices (Docker, Kubernetes, CI/CD), and monitoring. Use when designing APIs, implementing authentication, optimizing database queries, setting up CI/CD pipelines, handling security vulnerabilities, building microservices, or developing production-ready backend systems.