Run History Skill Builder

Trasforma un'esecuzione completata o un workflow ripetuto in un pacchetto skill riutilizzabile e validato.

di dongshuyan · dongshuyan/compass-skills

Promosso ★ 9.2/10

Run History Skill Builder — Trasforma un'esecuzione completata o un workflow ripetuto in un pacchetto skill riutilizzabile e validato.

Cosa fa

Una meta-skill che converte la cronologia di esecuzione reale (un compito finito, un flusso del browser, una traccia di log o un workflow ripetutamente raffinato) in un nuovo pacchetto skill riutilizzabile o un design di skill solo per la pianificazione. Si attiva quando l'utente chiede di creare una nuova skill da una conversazione o da log, estrarre un workflow riutilizzabile o produrre un piano di design prima di scrivere file; rimanda esplicitamente l'aggiornamento di una skill esistente a un upgrader separato e rifiuta di eseguire il workflow aziendale sottostante. Fornisce un validatore Python funzionante che applica la forma del frontmatter, i riferimenti ai file, la scansione dei percorsi di privacy e lo schema di valutazione.

Rapporto di test

Clonata la repo e confermato che tutti i file di riferimento nel corpo esistono (5 riferimenti, scripts/validate_skill_package.py, evals/evals.json; controllati a campione 3 tramite HTTP raw, tutti 200). Eseguito il validatore incluso sul pacchetto della skill stessa: "validation passed", exit 0. Per il test di output ho costruito due pacchetti per un compito (skill di miniatura immagine + rimozione EXIF): una BASELINE in buona fede che ignorava il corpo, e uno che seguiva le Design Rules/Validation gates del corpo. Il validatore ha segnalato la baseline con 4 errori (README per skill, chiavi frontmatter extra author/version, nome non kebab, mancata corrispondenza nome/dir) più un avviso di perdita di percorso macchina (/Users/...), mentre il pacchetto che seguiva la skill è passato pulito, exit 0 — le regole di design mappano direttamente a controlli applicabili. Il frontmatter è esattamente name+description; nessun curl|sh, base64 o problemi di esfiltrazione (il validatore stesso scansiona i percorsi privati). Categoria corretta da "design" a "coding": è un meta-strumento per sviluppatori che emette pacchetti skill.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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).

Comandi e prompt di esempio

  • /run-history-skill-builderTrasforma un'esecuzione completata o un workflow ripetuto in un pacchetto skill riutilizzabile e validato.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • 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