Run History Skill Builder

Convierte una ejecución completada o un flujo de trabajo repetido en un paquete de habilidad reutilizable validado.

Por dongshuyan · dongshuyan/compass-skills

Probado · Funciona ★ 9.2/10

Run History Skill Builder — Convierte una ejecución completada o un flujo de trabajo repetido en un paquete de habilidad reutilizable validado.

Qué hace

Una meta-habilidad que convierte el historial de ejecución real (una tarea terminada, browser flow, log trace o workflow repetidamente refinado) en un nuevo reusable skill package o un plan-only skill design. Se activa cuando el usuario pide crear una nueva habilidad a partir de una conversación o logs, extraer un reusable workflow o producir un design plan antes de escribir archivos; explícitamente difiere la actualización de una habilidad existente a un upgrader separado y se niega a ejecutar el business workflow subyacente. Incluye un Python validator funcional que aplica frontmatter shape, file references, privacy-path scanning y eval schema.

Informe de la prueba

Se clonó el repo y se confirmó que todos los archivos referenciados en el cuerpo existen (5 referencias, scripts/validate_skill_package.py, evals/evals.json; se verificaron 3 a través de raw HTTP, todos 200). Se ejecutó el validator incluido en el propio paquete de la habilidad: "validation passed", exit 0. Para la prueba de salida, construí dos paquetes para una tarea (image thumbnail + EXIF-strip skill): una LÍNEA BASE de buena fe ignorando el cuerpo, y una siguiendo las Design Rules/Validation gates del cuerpo. El validator marcó la línea base con 4 errores (per-skill README, extra frontmatter keys author/version, non-kebab name, name/dir mismatch) más una advertencia de machine-path leak (/Users/...), mientras que el paquete que seguía la habilidad pasó limpio, exit 0 — las design rules se mapean directamente a checks aplicables. El frontmatter es exactamente name+description; sin curl|sh, base64 o exfiltration smells (el propio validator escanea en busca de private paths). Categoría corregida de "design" a "coding": es una meta-herramienta de desarrollador que emite skill packages.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/dongshuyan/compass-skills.git /tmp/run-history-skill-builder-src
mkdir -p ~/.claude/skills
cp -R /tmp/run-history-skill-builder-src/skills/run-history-skill-builder ~/.claude/skills/run-history-skill-builder
# No external deps. Bundled validator needs Python 3 (python3/python/py -3):
#   python3 ~/.claude/skills/run-history-skill-builder/scripts/validate_skill_package.py <target-skill-dir>
# Companion skill in same repo: skills/run-history-skill-upgrader (for upgrading existing skills).

Comandos y prompts de ejemplo

/run-history-skill-builderConvierte una ejecución completada o un flujo de trabajo repetido en un paquete de habilidad reutilizable validado.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

Turn this browser flow into a reusable skill
Extract a skill from my recent conversation logs
Build a skill-design plan from this run history

Informe completo →