Skill diff-skill
Compara dos versiones de las instrucciones de un SKILL para detectar degradaciones de instrucciones y regresiones de complejidad.
- Estrellas en GitHub
- 155
- Archivos
- 14
- Último commit
- 10 nov 2026
- Licencia
- —
- Herramientas permitidas
- —
¿Qué hace la skill diff-skill?
diff-skill es una agent skill. Compara dos versiones de las instrucciones de un SKILL para detectar degradaciones de instrucciones y regresiones de complejidad.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill diff-skill
Los desarrolladores que revisan cambios en las instrucciones de un SKILL pueden usar esta herramienta para identificar degradaciones de instrucciones o regresiones de complejidad. Funciona como una comprobación asimétrica, lo que significa que ignora las adiciones o aclaraciones beneficiosas y se centra únicamente en cambios negativos, como la eliminación de restricciones, el debilitamiento de los pasos de verificación o las referencias rotas. Un agente debe cargar este SKILL cuando un usuario solicite hacer un diff, comparar o revisar cambios en las instrucciones en markdown de un SKILL.
La herramienta compara la versión HEAD contra el working tree de forma predeterminada, recorriendo todo el conjunto de archivos alcanzables a través de enlaces markdown comenzando desde el archivo SKILL.md. Genera un archivo de informe detallado ubicado en docs/reviews/diff-skill/ y proporciona un resumen en línea que contiene el veredicto y el recuento de hallazgos. Si la herramienta detecta cualquier degradación o regresión de complejidad, indexa los hallazgos bajo kk:review-findings. Se apoya en el archivo diff-process.md para guiar sus fases de ejecución secuencial.
Lo que un agente puede hacer con ella
- 1Detectar la degradación de instruccionesComprobar si una edición en las instrucciones markdown de un SKILL eliminó accidentalmente una instrucción fundamental o debilitó una restricción.
- 2Identificar regresiones de complejidadDeterminar si los cambios recientes han hecho que un SKILL sea más difícil de seguir para un modelo de lenguaje extenso.
- 3Generar informes de revisión automatizadosCrear un informe en markdown que documente las diferencias entre dos versiones de la documentación de un SKILL.
- 4Auditar cambios en las instrucciones del SKILLRevisar las diferencias entre el HEAD actual y el working tree para un SKILL específico.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill diff-skill
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill diff-skill en Plugin
/plugin marketplace add serpro69/claude-toolbox /plugin install kk@claude-toolbox
Instalar la skill diff-skill en Claude Code
~/.claude/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.claude/skills/diff-skillInstalar la skill diff-skill en Claude Code (project)
.claude/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill .claude/skills/diff-skillInstalar la skill diff-skill en Codex
~/.agents/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.agents/skills/diff-skillInstalar la skill diff-skill en Gemini CLI
~/.gemini/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.gemini/skills/diff-skillInstalar la skill diff-skill en Claude.ai
npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill diff-skill && zip -r diff-skill.zip diff-skill # claude.ai → Customize → Skills → + → Create skill → Upload a skill → diff-skill.zip
SKILL.md
Ver en GitHubDiff Skill Instructions
Goal: Detect whether an edit to a skill's markdown instructions introduced degradations or made the skill harder for an LLM to follow.
Two judgment axes:
- Degradation (asymmetric) — load-bearing instruction dropped, constraint weakened, verification step removed, scope narrowed, required output dropped, or reference broken. Content relocated but preserved is neutral.
- Complexity — split into regressions (introduced or worsened by the edit, affects verdict) and pre-existing advisories (exist regardless of the edit, surfaced as improvement opportunities, does NOT affect verdict).
Conventions
- Read capy knowledge base conventions at shared-capy-knowledge-protocol.md.
Required Outputs
- Report written to
docs/reviews/diff-skill/<slug>-<sha-a>-<sha-b>.md - Inline summary presented (under 10 lines: verdict, finding counts, report path)
- Capy indexed under
kk:review-findingsif any degradation or complexity regression findings exist (skip on clean results and pre-existing advisories)
Invocation
/kk:diff-skill <skill-name>
Convenience shortcut: resolves klaude-plugin/skills/<skill-name>/SKILL.md. If not found, asks the user for the skill directory path.
Defaults: HEAD (before) → working tree (after). User can specify different refs in the prompt.
Workflow
Mandatory order — load instructions before acting on subject matter. The phases below are strictly sequential. Do not read skill content, build file sets, or produce judgments until you have loaded and internalized the full process file. The only early contact with the target skill is its name and SKILL.md path — enough to validate, not enough to judge.
See diff-process.md for the detailed step-by-step process.
Archivos de esta skill
14Preguntas sobre la skill diff-skill
¿Cómo instalo la skill diff-skill en Claude Code?
Ejecuta npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.claude/skills/diff-skill. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill diff-skill?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Qué considera el SKILL como una degradación?
Una degradación se define como la eliminación de una instrucción fundamental, el debilitamiento de una restricción, la eliminación de un paso de verificación, la reducción del alcance, la omisión de un resultado requerido o una referencia rota.
¿Cómo se tratan las adiciones y aclaraciones durante una comparación?
Las adiciones, aclaraciones y refuerzos no se consideran degradaciones.
¿Dónde se guarda el informe de comparación?
El informe se escribe en el directorio docs/reviews/diff-skill/.