Skill Forge: Mercado de plugins de Claude Code

Habilidad de activación manual. disable-model-invocation: true evita que el modelo invoque este flujo de trabajo automáticamente durante la tarea. Cuando se instala desde este plugin, invóquelo deliberadamente como /agent-docs:learn al final de una sesión. No agregue hooks, tareas en segundo plano, comportamiento de activación automática, almacenamiento en tiempo de ejecución, bases de datos vectoriales, integración MCP o sistemas de memoria externos.

Revise lo que sucedió en esta sesión y produzca propuestas de memoria verificadas y revisables para el archivo AGENTS.md correspondiente. No edite archivos hasta que el usuario haya visto el diff propuesto y lo haya aprobado explícitamente.

Principio de No Derivabilidad

Registre únicamente la información que NO se pueda derivar del propio código base. Antes de proponer cualquier entrada de Hidden Knowledge, pregúntese:

¿Puede el próximo agente o humano descubrir esto leyendo el código, ejecutando git log o consultando la documentación existente?

Si es así, NO lo registre como conocimiento oculto. El estándar es alto. La mayor parte del conocimiento pertenece al código fuente, los mensajes de commit o la documentación existente, no en AGENTS.md.

Paso 1: Extraer ideas candidatas

Revise la sesión actual y enumere las ideas candidatas. Las ideas suelen provenir de dependencias ocultas, fallos engañosos, soluciones alternativas específicas del proyecto, orden crítico, descubrimiento de comandos o lagunas en la documentación.

No escriba nada todavía. Primero clasifique cada candidato.

Paso 2: Clasificar candidatos

Clasificación	Destino	Regla
Hidden Knowledge	AGENTS.md relevante más cercano bajo ## Hidden Knowledge	Solo para dependencias ocultas no derivables, errores engañosos, soluciones alternativas, peculiaridades o orden crítico
Quick Reference	Tabla de referencia rápida del AGENTS.md raíz	Comandos comunes de compilación, prueba, lint, ejecución, generación de código, limpieza u otros
Rule	Reportar solo el destino sugerido	Convención del equipo o límite estricto; no crear ni modificar docs/rules/ desde /agent-docs:learn
Doc	Reportar solo el destino sugerido	Nota de diseño, solución de problemas, runbook o biblioteca más extensa; no crear ni modificar documentación desde /agent-docs:learn
Skip	Sin escritura	Derivable, puntual, duplicada, desactualizada, genérica o no verificable

Candidatos a Hidden Knowledge

Solo los candidatos que superen la prueba de no derivabilidad pueden convertirse en conocimiento oculto:

1. Dependencias ocultas: Archivos o módulos que deben cambiarse juntos pero no están obviamente conectados.
2. Errores engañosos: Mensajes de error que apuntan a la ubicación o causa equivocada.
3. Soluciones alternativas y peculiaridades: Comportamiento específico del proyecto que difiere del patrón estándar.
4. Orden crítico: Operaciones que deben ocurrir en una secuencia específica.

Criterios de omisión

Omita candidatos que sean:

• Patrones de código, arquitectura o estructura de archivos visibles al leer el código fuente.
• Historial de Git o cambios recientes que git log o git blame ya registran.
• Soluciones de depuración donde la corrección ahora está en el código y el mensaje de commit debería contener el contexto.
• Ya presentes en AGENTS.md, docs/rules/ o README.
• Comportamiento estándar del lenguaje o framework.
• Comandos no obvios que pertenecen a la Referencia Rápida, no a Hidden Knowledge.
• Detalles efímeros de la sesión, incluidos intentos que fallaron temporalmente.
• Afirmaciones no verificadas.

Paso 3: Verificar cada candidato retenido

Cada candidato retenido necesita evidencia explícita antes de poder proponerse:

El candidato menciona	Evidencia de verificación
Ruta de archivo	Confirme que la ruta existe con ls o leyendo el archivo
Función, tipo, comando o símbolo	Confirme que existe con una búsqueda o una consulta que reconozca el lenguaje
Comportamiento o restricción	Ejecute el comando relevante más pequeño, inspeccione el código fuente o explique por qué la ejecución directa no es segura
Contenido existente de AGENTS.md	Lea la sección de destino y verifique si hay entradas desactualizadas o duplicadas

Si la verificación falla, clasifique el candidato como Skip y explique la comprobación fallida. Si la verificación no se puede realizar de forma segura, repórtelo como no verificado y no proponga una escritura.

Paso 4: Elegir el destino

Elija el AGENTS.md más cercano al alcance afectado:

Alcance de la idea	Archivo de destino
Afecta a todo el proyecto	AGENTS.md raíz
Afecta a un paquete específico	<paquete>/AGENTS.md
Afecta a un módulo complejo	<paquete>/<módulo>/AGENTS.md, solo si se cumplen los criterios de subpaquete

Para Hidden Knowledge, añada o cree una sección ## Hidden Knowledge cerca del final del archivo AGENTS.md de destino. Mantenga cada idea en 1-3 líneas.

Para Quick Reference, proponga una actualización de fila en la tabla del AGENTS.md raíz.

Para Rule y Doc, reporte solo el destino sugerido. No cree ni modifique documentos de reglas, documentos de diseño, documentos de solución de problemas, runbooks o documentos de biblioteca desde este comando.

Paso 5: Mostrar primero los cambios propuestos

Antes de editar cualquier archivo, muestre todas las propuestas en este formato:

## Propuestas de Aprendizaje

### 1. `<clasificación>` -> `<archivo de destino>`

**Por qué:** <razón de una línea por la que esto ayuda a futuras sesiones>

**Verificación:** <evidencia de ruta/símbolo/comando/comportamiento>

**Acción:** <añadir/actualizar/omitir/solo-reporte>

```diff
- <línea existente, solo al actualizar una entrada aprobada existente>
+ <añadido o reemplazo exacto propuesto>
```

### Candidatos Omitidos

1. `<candidato>` -> omitido porque <razón>

### Sugerencias Solo de Reporte

1. `<candidato>` -> pertenece a <destino sugerido>, no manejado por `/agent-docs:learn`

No omita el paso de diff y aprobación. Incluso si el usuario solicita aplicar rápidamente, el usuario debe ver los cambios exactos propuestos y aprobarlos primero.

Paso 6: Aplicar solo cambios aprobados

Después de la aprobación:

1. Aplique solo las propuestas que el usuario aprobó.
2. Preserve la estructura existente de AGENTS.md y mantenga las adiciones concisas.
3. No realice limpieza general desde /agent-docs:learn; use /agent-docs:remember para memoria existente desactualizada, duplicada o fuera de lugar.
4. Reporte qué cambió, dónde cambió y qué candidatos se omitieron.

Procedimiento

1. Revise el historial de la conversación en busca de ideas candidatas.
2. Clasifique cada candidato como Hidden Knowledge, Quick Reference, Rule, Doc o Skip.
3. Aplique la prueba de no derivabilidad a los candidatos de Hidden Knowledge.
4. Verifique cada candidato retenido y registre la evidencia.
5. Elija el destino AGENTS.md correcto o el destino de solo reporte.
6. Muestre los diffs propuestos y los candidatos omitidos.
7. Espere la aprobación explícita del usuario.
8. Aplique solo los cambios aprobados en AGENTS.md.
9. Reporte las escrituras finales, omisiones y sugerencias restantes de solo reporte.