promote

Descripción general de promote skill

Qué hace promote

La skill promote convierte un comportamiento repetido y ya comprobado de Claude, registrado en la memoria automática, en una regla explícita del proyecto. En lugar de dejar un patrón útil enterrado en MEMORY.md, promote ayuda a moverlo a CLAUDE.md, .claude/rules/<topic>.md o a un archivo global de instrucciones de Claude, para que ese comportamiento se aplique de forma consistente en sesiones futuras.

Mejor encaje para flujos de Claude que se auto-mejoran

Usa promote cuando tu equipo ya permite que Claude aprenda de correcciones, preferencias y convenciones repetidas del proyecto, pero ahora necesita que uno de esos aprendizajes sea duradero. Es especialmente útil en configuraciones de Context Engineering donde MEMORY.md captura observaciones y los archivos de reglas definen lo que el agente debe seguir de manera fiable.

Buenos ejemplos serían “usar siempre pnpm en este repo”, “los handlers de API deben validar la entrada” o “las pruebas del código de facturación requieren estos fixtures”. Malos ejemplos serían preferencias puntuales, debates no resueltos o reglas que aún no has visto funcionar en la práctica.

Por qué esta skill promote resulta útil

La skill no es solo un recordatorio para copiar y pegar. Ofrece un flujo de decisión: aclarar el patrón, localizar entradas de memoria que lo respalden, elegir el archivo de destino correcto, redactar una regla aplicable y conservar la memoria original con una nota de promoción. Eso importa porque lo difícil no es editar markdown; lo difícil es decidir si una memoria merece convertirse en una instrucción permanente y dónde debe vivir esa regla.

Cómo usar promote skill

Instalación de promote y ruta de lectura del repositorio

Instala la skill desde la colección de skills de GitHub con:

npx skills add alirezarezvani/claude-skills --skill promote

Después, lee primero SKILL.md. En esta ruta del repositorio, el flujo de promote está expuesto actualmente en un único archivo, así que no hay scripts auxiliares, referencias ni plantillas de reglas que revisar. Eso simplifica la adopción, pero también significa que conviene revisar con cuidado los ejemplos de comandos y la tabla de selección de destino antes de usarla en un repo importante.

Cómo invocar promote en la práctica

El disparador previsto es /si:promote, seguido del patrón que quieres hacer permanente:

• /si:promote use pnpm instead of npm
• /si:promote API handlers need validation --target rules/api.md
• /si:promote tests for auth changes must include session expiry cases --target rules/testing.md --paths "src/auth/**/*.ts"

La skill primero comprueba a qué comportamiento te refieres. Si tu solicitud es vaga, debería hacer una sola pregunta aclaratoria, por ejemplo si la regla aplica de forma global o solo a determinadas rutas. Luego busca entradas relacionadas en el archivo de memoria automática de Claude del proyecto, ubicado bajo ~/.claude/projects/.../memory/MEMORY.md, muestra las coincidencias y confirma que la memoria respalda la promoción.

Convertir un objetivo impreciso en un buen prompt para promote

Un prompt débil dice: “promote our testing preference”. Un uso más sólido de promote incluye el comportamiento, la evidencia, el alcance y el destino si ya se conoce:

/si:promote "When changing billing code, add regression tests for failed payment and retry paths" --target rules/testing.md --paths "src/billing/**/*.ts"

Esto funciona mejor porque la skill puede redactar una regla aplicable en lugar de una preferencia vaga. Incluye:

• el comportamiento exacto que Claude debe seguir
• si aplica a todo el proyecto, a tipos de archivo concretos o a todos los proyectos
• rutas de ejemplo si la regla tiene un alcance limitado
• la frase de memoria o el incidente que demostró que el patrón era útil

Flujo recomendado antes de fusionar la regla

Después de que promote redacte o edite la regla, revísala como si fuera configuración de producción. Comprueba que la instrucción sea breve, verificable y no más amplia de lo que la evidencia justifica. Para comportamientos de todo el proyecto, CLAUDE.md suele ser adecuado. Para comportamientos acotados, prefiere .claude/rules/<topic>.md con alcance por rutas. Para una convención personal entre repositorios, usa un archivo global de instrucciones de Claude solo si el patrón es realmente universal.

Preguntas frecuentes sobre promote skill

¿promote es para Context Engineering o para prompting general?

Promote aporta más valor en Context Engineering porque formaliza el paso de un comportamiento observado a una instrucción persistente. Los prompts generales pueden pedirle a Claude que recuerde algo durante una sesión; promote ayuda a decidir si ese aprendizaje debe pasar a formar parte del contexto operativo del repo.

¿Cuándo no debería usar promote?

No uses promote para ideas no probadas, soluciones temporales, gustos personales que entren en conflicto con las normas del equipo ni instrucciones que deberían estar en el código de la aplicación, las pruebas, los linters o CI. Una regla es útil cuando guía el comportamiento del agente; se vuelve arriesgada cuando sustituye controles ejecutables.

¿En qué se diferencia de editar CLAUDE.md manualmente?

Editar a mano puede funcionar, pero a menudo se salta la evidencia y el alcance. La skill promote añade un proceso repetible: encontrar la memoria, confirmar el comportamiento previsto, elegir el destino correcto y dejar constancia de que esa memoria fue promovida. Eso reduce la proliferación de reglas y ayuda a que quienes mantengan el proyecto en el futuro entiendan por qué existe la instrucción.

¿promote es apta para principiantes?

Sí, si la persona ya entiende dónde viven la memoria del proyecto de Claude y sus archivos de reglas. Quienes estén empezando deberían comenzar con un único patrón claro de alcance general para el proyecto, usar --target claude.md y evitar reglas con rutas acotadas hasta sentirse cómodos con las convenciones de .claude/rules/.

Cómo mejorar promote skill

Mejora los resultados de promote con mejor evidencia

La skill promote funciona mejor cuando la memoria de origen es específica. Antes de invocarla, recopila la entrada exacta de memoria, la corrección o el fallo repetido que demuestra que la regla es necesaria. “Claude keeps using npm” es más débil que “In three sessions Claude ran npm commands, but this repo uses pnpm and has no package-lock.json.”

Evita errores comunes al promocionar reglas

El error más común es promocionar de más: convertir una observación limitada en un mandato global. Otro es escribir reglas que suenan bien pero no son accionables, como “write better tests.” Una regla mejor nombra el disparador, la acción requerida y el alcance: “For src/api/**/*.ts, validate request bodies before calling service functions.”

Itera después de la primera regla generada

Después de la primera salida de promote, pregunta si la regla es demasiado amplia, demasiado vaga o si ya está duplicada en otro lugar. Luego ajústala. Algunos prompts de seguimiento útiles son:

• “Make this rule enforceable in one paragraph.”
• “Narrow this to only API route files.”
• “Add one example and one non-example.”
• “Check whether this belongs in CLAUDE.md or .claude/rules/testing.md.”

Mantén sano el sistema de reglas

Una buena guía de promote debería proteger la capa de reglas para que no se vuelva ruidosa. Revisa periódicamente las reglas promocionadas en busca de conflictos, convenciones obsoletas e instrucciones que deberían trasladarse a herramientas. El mejor resultado de promote no es tener más markdown; es reducir las correcciones repetidas porque Claude recibe ahora el contexto duradero correcto, con el alcance adecuado.