claude-reflect (Claude Skill) — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Detecta correcciones implícitas («en realidad, hazlo así») y señales positivas
Redacta adiciones de reglas; tú apruebas antes de que lleguen a CLAUDE.md
Las mismas reglas aparecen en AGENTS.md para herramientas que no son Claude
Consolidación periódica elimina reglas contradictorias u obsoletas
Actualizaciones basadas en diff mantienen el historial de git legible

Demo en vivo

Cómo se ve en la práctica

listo

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-reflect-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-reflect-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/BayramAnnakov/claude-reflect",
          "~/.claude/skills/claude-reflect"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add claude-reflect-skill -- git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: claude-reflect

Evolucionar CLAUDE.md sin curación manual

👤 Devs en solitario que odian mantener archivos de documentación ⏱ ~5 min beginner

Cuándo usarlo: Quieres que CLAUDE.md se mantenga al día con tus preferencias sin que sea una tarea de escritura.

Requisitos previos

Skill instalada — git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect
Reflexión activada — Añade use claude-reflect al preámbulo de CLAUDE.md de tu proyecto

Flujo

Trabajar normalmente

Just code with Claude as usual. Correct it when wrong, praise it when right.✓ Copiado

→ La skill captura en silencio — no lo notas
Revisión al final del día

Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ Copiado

→ 5–10 reglas candidatas con procedencia (qué sesión, qué prompt)
Hacer commit del diff

Apply approved rules and commit CLAUDE.md.✓ Copiado

→ Diff limpio de git; reglas ahora en vigor

Resultado: CLAUDE.md que crece contigo, sin costo de mantenimiento manual.

Errores comunes

La skill captura contexto de una sola vez como reglas duraderas — Revisa siempre los candidatos diarios; rechaza cualquier cosa situacional

Combinar con: filesystem

Construir convenciones de IA para todo el equipo a partir de correcciones colectivas

👤 Tech leads estandarizando flujos de trabajo con IA ⏱ ~60 min intermediate

Cuándo usarlo: Múltiples devs corrigen a Claude en cosas similares; quieres un conjunto de reglas compartidas.

Flujo

Recopilar borradores por desarrollador

Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ Copiado

→ Rama con N borradores pendientes
Fusionar sesiones

Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ Copiado

→ Conjunto de reglas comunes
Desplegar

Merge to main. New AGENTS.md applies to everyone.✓ Copiado

→ El equipo usa el mismo baseline; las reglas locales por dev permanecen

Resultado: Estandarización de abajo hacia arriba sin un comité de proceso.

Errores comunes

Los devs más vocales dominan; se pierden los patrones de los más callados — Asegúrate de que todos ejecuten la skill; pondera por eventos de reflexión, no por ediciones de archivos

Combinar con: github

Auditar y podar reglas obsoletas en CLAUDE.md

👤 Usuarios de CLAUDE.md desde hace tiempo ⏱ ~25 min intermediate

Cuándo usarlo: Tu CLAUDE.md tiene ahora 600 líneas y el contexto de Claude está sobrecargado.

Flujo

Puntuar la relevancia

Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ Copiado

→ Puntuación por regla
Proponer eliminaciones

Suggest 30 rules to remove (stale or obsolete).✓ Copiado

→ Lista de eliminaciones con justificación
Diff + commit

Apply approved removals; commit with message 'reflect: prune stale rules'.✓ Copiado

→ CLAUDE.md más delgado

Resultado: CLAUDE.md que se lee realmente, no que se hojea.

Errores comunes

Podar una regla que no se aplicó porque Claude la estaba respetando — En caso de duda, conserva — pero márcala con 'última verificación' para revisarla el próximo trimestre

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

claude-reflect-skill + pro-workflow-skill

pro-workflow para captura explícita, claude-reflect para la pasiva — aprendizaje de dos canales

Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ Copiado

claude-reflect-skill + github

Cambios de reglas revisables mediante PR

Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
watch_session	—	Proceso en segundo plano siempre activo
review_candidates	since?	Bucle de aprobación diario / semanal
consolidate	scope?	Deduplicación periódica / resolución de contradicciones
score_rules	—	Auditoría pre-poda
apply_to_files	approved_ids[], files[]	Aterrizar candidatos aprobados en CLAUDE.md / AGENTS.md

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguna — local
Tokens por llamada: La captura en segundo plano es gratuita; la revisión/consolidación usa LLM local si está configurado
Monetario: Gratuito
Consejo: Aprueba candidatos de forma conservadora — calidad sobre cantidad

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: filesystem-write

Almacenamiento de credenciales: Estado de la skill en .claude/reflect/; haz commit al repositorio si quieres compartirlo

Salida de datos: Ninguna por defecto

Los logs de reflexión pueden incluir fragmentos de código sensibles — agrega el log sin procesar al gitignore; haz commit solo de las reglas destiladas

Resolución de problemas

Errores comunes y soluciones

No se capturan candidatos

Verifica que la skill está invocada en el preámbulo de CLAUDE.md; revisa .claude/reflect/log para ver entradas

Los candidatos son ruido

Ajusta la sensibilidad del disparador; captura solo de correcciones explícitas, no del chat genérico

AGENTS.md diverge de CLAUDE.md

Ejecuta consolidate periódicamente; la herramienta está diseñada para mantenerlos sincronizados pero las ediciones manuales los separan

El prompt de aprobación es abrumador

Ejecuta review con --limit 5 diariamente; crea un hábito en lugar de hacer 50 a la vez

Alternativas

claude-reflect vs otros

Alternativa	Cuándo usarla	Contrapartida
pro-workflow-skill	Prefieres captura explícita y orquestación de worktrees	Más manual; más potente para trabajo en paralelo
Manual CLAUDE.md curation	Eres lo suficientemente disciplinado como para escribir reglas tú mismo	Frecuentemente descuidado; depende de la fuerza de voluntad

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills