Saltar a contenido

CC-Toolkit

Plugin de utilidades para desarrollo y calidad de componentes Claude Code. Ofrece 3 herramientas independientes: auditoria de CLAUDE.md, wizard guiado para crear componentes, y auditoria de plugins contra las best practices oficiales de Anthropic. Dirigido a cualquier desarrollador que construya o mantenga skills, plugins, hooks o subagentes para Claude Code.

Prerequisitos

  • Claude Code instalado
  • Para plugin-auditor: acceso de lectura al plugin a auditar
  • Para claude-builder: permisos de escritura en el directorio destino
  • No requiere GitHub CLI, Engram ni dependencias externas
# Plugin individual
claude --plugin-dir ./plugins/cc-toolkit

Skills

CC-Toolkit tiene 3 skills independientes entre si — no comparten estado ni tienen orden de ejecucion. Cada uno opera en context: fork para no contaminar la conversacion principal. Dos son de uso general (audit-claude-md y claude-builder) y uno esta especializado en plugins del marketplace Inteliside (plugin-auditor).

Skill Descripcion Invocacion Tools permitidos
audit-claude-md Evalua un CLAUDE.md contra 10 reglas de best practices de Anthropic. Genera score 0-100 y recomendaciones accionables. Ofrece correccion automatica. /cc-toolkit:audit-claude-md [ruta] Read, Glob, Grep, Bash
claude-builder Wizard guiado para crear Skills, Subagentes, MCP Servers, Hooks, Plugins o Marketplaces. Carga referencias oficiales de Anthropic antes de generar. /cc-toolkit:claude-builder [tipo] Read, Glob, Grep, Write, Edit, Bash, Agent, WebFetch
plugin-auditor Auditoria completa de un plugin: skills, hooks, subagentes, contratos y context engineering. Reporte por severidad (CRITICO, IMPORTANTE, MEJORA). /cc-toolkit:plugin-auditor [plugin-path] Read, Glob, Grep, Bash

Notas: - plugin-auditor tiene disable-model-invocation: true — solo se activa por invocacion directa. - audit-claude-md y claude-builder pueden activarse por lenguaje natural (ej: "audita mi CLAUDE.md", "crear un skill").

Flujo de trabajo

Cada skill de CC-Toolkit tiene su propio flujo independiente:

audit-claude-md

  1. Localizar archivo: Busca CLAUDE.md en la ruta indicada o en el directorio actual. Tambien detecta .claude/rules/*.md y CLAUDE.local.md.
  2. Evaluar 10 reglas: Longitud adecuada (max 200 lineas), 5 secciones esenciales, sin contenido descubrible, sin obviedades, comandos especificos, reglas accionables, sin info volatil, uso de @imports, organizacion con rules/, sin contradicciones.
  3. Calcular score: PASS=10, WARN=5, FAIL=0 por regla. Total sobre 100.
  4. Generar reporte: Tabla de resultados, hallazgos detallados, recomendaciones ordenadas por impacto.
  5. Ofrecer correccion: El usuario puede elegir correccion automatica (todo, solo FAILs, o solo reporte).

claude-builder

  1. Determinar tipo: Si no se especifica, presenta menu de 6 opciones (Skill, Subagente, MCP Server, Hook, Plugin, Marketplace).
  2. Cargar referencia: Lee el archivo de referencia oficial correspondiente al tipo + best-practices.md.
  3. Entrevista rapida: 3-5 preguntas (nombre, proposito, alcance, herramientas, extras).
  4. Generar componente: Crea archivos siguiendo las reglas de la referencia oficial. Maximo 500 lineas para SKILL.md.
  5. Verificar: Confirma existencia de archivos, valida limites, informa como probar.

plugin-auditor

  1. Descubrir estructura: Mapea plugin.json, skills, agents, hooks, docs, references.
  2. Auditar plugin.json: Campos requeridos, description con triggers.
  3. Auditar cada SKILL.md: Frontmatter (name, description, allowed-tools, context, argument-hint), tamano (<500 lineas), estructura (prerequisitos, flujo, errores, ejemplos), referencias validas, variables correctas.
  4. Auditar subagentes: Frontmatter, modelo, herramientas restrictivas.
  5. Auditar hooks: Formato JSON, eventos validos, matchers regex, timeouts, scripts ejecutables.
  6. Auditar contratos: Engram (schemas, topic keys), GitHub (labels, comandos gh).
  7. Auditar dependencias cross-skill: Prerequisitos, orden, trazabilidad Engram.
  8. Auditar context engineering: context:fork, progressive disclosure, sin duplicacion.
  9. Generar reporte: Por severidad (CRITICO/IMPORTANTE/MEJORA), detalle por skill, contratos.

Contratos de datos

Engram

Sin contrato formal documentado. CC-Toolkit no persiste datos en Engram — cada skill es stateless y produce output directamente en consola o en archivos locales.

GitHub

Sin contrato formal documentado. CC-Toolkit no interactua con GitHub.

Configuracion para proyectos

CC-Toolkit no requiere configuracion en el CLAUDE.md del proyecto. El plugin no tiene examples/CLAUDE.md.

Para usar los skills:

# Auditar el CLAUDE.md del proyecto actual
/cc-toolkit:audit-claude-md

# Auditar un CLAUDE.md especifico
/cc-toolkit:audit-claude-md ./mi-proyecto/CLAUDE.md

# Crear un componente nuevo
/cc-toolkit:claude-builder skill
/cc-toolkit:claude-builder subagent
/cc-toolkit:claude-builder hook
/cc-toolkit:claude-builder plugin
/cc-toolkit:claude-builder marketplace
/cc-toolkit:claude-builder mcp

# Auditar un plugin
/cc-toolkit:plugin-auditor ./plugins/mi-plugin

Integración con Doc-Gen

Después de crear un nuevo plugin, skill o hook con claude-builder, se recomienda correr doc-gen para mantener la documentación del proyecto actualizada.

Cuándo Comando
Después de crear un nuevo plugin, skill o hook con claude-builder /doc-gen:doc-modulo {path-del-plugin-creado}
Verificación periódica /doc-gen:doc-sync

Limitaciones conocidas

  1. audit-claude-md evalua semanticamente: Busca contenido equivalente, no headers exactos. Esto significa que proyectos con estructura no convencional pueden recibir evaluaciones imprecisas.

  2. plugin-auditor depende de referencias de claude-builder: El skill referencia archivos en ../claude-builder/references/ — si la estructura del plugin cambia, los paths se rompen.

  3. No hay correccion automatica en plugin-auditor: A diferencia de audit-claude-md que ofrece correccion, plugin-auditor solo genera reporte. Las correcciones son manuales.

  4. claude-builder necesita WebFetch: El skill incluye WebFetch en sus tools permitidos, lo que requiere que el usuario permita acceso a red si el wizard necesita consultar documentacion externa.

  5. Sin persistencia: Ningun skill guarda resultados entre sesiones. Cada auditoria se ejecuta desde cero.

Inventario de archivos de referencia

El skill claude-builder incluye 7 archivos de referencia con documentacion oficial de Anthropic:

  • references/best-practices.md — Best practices generales para componentes Claude Code
  • references/skill-reference.md — Reglas y esquema para crear Skills
  • references/subagent-reference.md — Reglas y esquema para crear Subagentes
  • references/hook-reference.md — Reglas y esquema para crear Hooks
  • references/plugin-reference.md — Reglas y esquema para crear Plugins
  • references/marketplace-reference.md — Reglas y esquema para crear Marketplaces
  • references/mcp-reference.md — Reglas y esquema para crear MCP Servers

Estos archivos son tambien consumidos por plugin-auditor como fuente de verdad para las reglas de auditoria.