Communitygithub.com

configurar-ecc

Guía la instalación, actualización o reconfiguración de ECC desde Claude Code, Codex o Kimi respetando cada plataforma.

¿Qué es configurar-ecc?

Esta habilidad permite configurar Everything Claude Code (ECC) de forma conversacional y no interactiva dentro de asistentes de IA como Claude Code, Codex y Kimi. En lugar de ejecutar comandos genéricos, primero realiza un inventario del estado actual de ECC, recopila solo las opciones compatibles con la plataforma anfitriona (como alcance y modo de hooks en Claude Code, o el ciclo de vida nativo de plugins en Codex), muestra una vista previa de los cambios, solicita una única confirmación y aplica la configuración sin intervención manual. Luego verifica el resultado y muestra un mensaje de bienvenida solo si todo es correcto. Es especialmente útil para desarrolladores que trabajan con múltiples entornos de IA y necesitan mantener ECC configurado correctamente sin mezclar perfiles de hooks o alcances entre plataformas. Evita errores comunes como clonar ECC en directorios temporales o copiar componentes manualmente, y garantiza que cada plataforma reciba exactamente la configuración que soporta.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/configure-ecc

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Configurar Everything Claude Code

Ejecuta un asistente conversacional dentro de la plataforma actual. Primero realiza un inventario, recopila solo las opciones compatibles, muestra una vista previa, confirma una vez, aplica de forma no interactiva, verifica y muestra la bienvenida solo tras el éxito. Nunca clones ECC en un directorio temporal ni copies componentes de plugins manualmente.

Para un terminal operado por humanos, los puntos de entrada canónicos son ecc setup y npx ecc-universal setup. Dentro de una plataforma, usa en su lugar los comandos explícitos no interactivos que se indican a continuación.

Enrutar según la plataforma actual

  • En Claude Code, usa el asistente completo de ámbito y hooks que se describe más abajo.
  • En Codex, usa el ciclo de vida nativo de plugins de Codex. No ofrezcas ámbitos de Claude ni mapees los cuatro perfiles de hooks de ECC en Codex.
  • En Kimi, instala la superficie del proyecto en ./.kimi-code. Kimi no proporciona los perfiles de hooks del ciclo de vida de Claude de ECC.
  • Si la plataforma es incierta, indica la evidencia detectada y pregunta qué plataforma configurar antes de ejecutar un comando mutante.

Esta habilidad es una ruta de reconfiguración posterior a la instalación. No puede interceptar ni reemplazar la interfaz de instalación inicial integrada de un proveedor.

Claude Code: ejecutar el asistente conversacional completo

1. Inventario sin cambiar nada

Ejecuta ambos comandos y resume el ámbito de ECC instalado, el estado habilitado y la fuente del marketplace:

claude plugin list --json
claude plugin marketplace list --json

Trata una única instalación existente de ecc@ecc como una reconfiguración. No interpretes el control "Abrir página de inicio" propiedad del proveedor de Claude como evidencia de instalación. Detente y reporta la recuperación devuelta por setup para múltiples ámbitos de ECC, una instalación heredada/manual, configuraciones malformadas o una colisión en el marketplace; nunca adivines qué estado eliminar.

2. Recopilar exactamente dos opciones

Haz exactamente una pregunta sobre el ámbito y exige un valor:

  • user | project | local
  • user es global para este usuario.
  • project se comparte a través de la configuración del repositorio.
  • local es privado para el proyecto actual.

Marca visualmente solo el ámbito seleccionado como seleccionado o instalándose. Si el usuario elige un ámbito diferente al de una única instalación existente, descríbelo como una migración de ámbito e incluye --move-scope en los comandos siguientes.

Haz exactamente una pregunta sobre el modo de hooks y exige un valor:

  • off | minimal | standard | strict
  • off mantiene las habilidades y comandos pero desactiva la automatización de hooks de ECC.
  • minimal activa la automatización más ligera de ciclo de vida y seguridad.
  • standard equilibra calidad y automatización de seguridad.
  • strict activa las comprobaciones y recordatorios más estrictos.

La preferencia de hooks es configuración personal del plugin de Claude; no sigue el ámbito de instalación seleccionado.

3. Vista previa y confirmación única

Prefiere el script de setup incluido en el plugin. Sustituye los dos valores seleccionados e incluye --move-scope solo para una migración de ámbito:

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

Si $CLAUDE_PLUGIN_ROOT no está disponible, usa el paquete npm publicado:

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

Muestra exactamente un resumen de confirmación que contenga la acción planeada, un ámbito, un modo de hooks, la acción del marketplace y cualquier migración de origen a destino. Haz una pregunta de sí/no. No ejecutes un ecc setup interactivo desnudo a través de una herramienta de shell de la plataforma, ya que ese shell normalmente no es TTY.

4. Aplicar las opciones explícitas

Después de la confirmación, vuelve a ejecutar la misma ruta sin --dry-run. Mantén cada opción explícita y solicita JSON para poder verificar el éxito de forma determinista:

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

Plan de respaldo:

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

5. Verificar y luego mostrar la bienvenida

Exige un estado de salida cero y un resultado de setup cuyo scope y hooks coincidan con los valores seleccionados. Luego ejecuta de forma independiente:

claude plugin list --json

Continúa solo cuando exista exactamente una entrada ecc@ecc habilitada en el ámbito seleccionado. Cuando $CLAUDE_PLUGIN_ROOT esté disponible, pasa la action exitosa de setup (installed, updated, migrated, resumed o already-migrated) al renderizador incluido:

Antes de invocarlo, exige que la versión reportada por el proveedor coincida con ECC_VERSION_PATTERN de scripts/lib/terminal-welcome.js. Rechaza texto de versión inesperado en lugar de interpolarlo en un comando de shell.

node -e 'const { renderTerminalWelcome } = require(process.env.CLAUDE_PLUGIN_ROOT + "/scripts/lib/terminal-welcome"); process.stdout.write(renderTerminalWelcome({ action: process.argv[1], version: process.argv[2], color: process.stdout.isTTY }));' "<action>" "<installed-version>"

Renderiza la bienvenida exactamente una vez. En caso de fallo, ejecución en seco, cancelación, discrepancia de ámbito o hooks, o estado no verificable, no la renderices; reporta el error y la recuperación. Tras cambios verificados, indica al usuario que ejecute /reload-plugins o reinicie Claude Code.

Codex: usar el ciclo de vida nativo de plugins

Haz inventario con codex plugin marketplace list --json y codex plugin list --available --json. El comando nativo de plugins de Codex no tiene un selector al estilo user | project | local de Claude. Los plugins nativos de Codex sí soportan hooks específicos del proveedor, pero Codex exige confianza explícita para ellos. Deja que Codex muestre esa decisión de confianza; no hagas la pregunta de los cuatro perfiles de hooks de Claude ni afirmes que esos perfiles se mapean a Codex.

Si el marketplace de ECC falta, agrégalo. De lo contrario, actualiza su instantánea:

codex plugin marketplace add affaan-m/ECC
codex plugin marketplace upgrade ecc --json

Pide una única confirmación, luego instala o actualiza de forma idempotente la caché instalada y verifícala:

codex plugin add ecc@ecc --json
codex plugin list --json

Continúa solo cuando el JSON reporte ECC instalado y proporcione su installedPath. Luego renderiza la bienvenida del paquete verificado:

Usa únicamente la ruta absoluta exacta installedPath devuelta por el JSON de Codex. Rechaza caracteres de control y exige que la versión instalada coincida con ECC_VERSION_PATTERN. Invoca node directamente con este array de argumentos; esto es una invocación de API de herramienta, no un comando de shell:

["<installedPath>/scripts/welcome.js", "--action", "configured", "--version", "<installed-version>"]

Si la plataforma actual no puede invocar un ejecutable con un array de argumentos separado, omite la bienvenida. Nunca construyas un comando de shell a partir de valores JSON de Codex.

Nunca afirmes que los perfiles off | minimal | standard | strict de Claude se aplicaron a Codex.

Kimi: instalar la superficie del proyecto

Indica el resumen de capacidades antes de la confirmación: destino ./.kimi-code; hooks=unsupported para los hooks del ciclo de vida de ECC. No hagas las preguntas de ámbito ni modo de hooks de Claude. Primero vista previa:

npx --yes --package ecc-universal ecc install --profile core --target kimi --dry-run

Muestra una única confirmación para ese destino de proyecto, luego aplica el comando idéntico sin --dry-run. Verifica con:

npx --yes --package ecc-universal ecc doctor --target kimi

Solo después de que doctor tenga éxito y las instrucciones y habilidades instaladas permanezcan dentro de ./.kimi-code, renderiza:

npx --yes --package ecc-universal ecc welcome --action configured

No afirmes que Kimi instaló o configuró los hooks del ciclo de vida de ECC.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

Skills relacionados