Skip to content

New skill: /curate-sandbox — Extract reusable scripts from sessions into a curated sandbox #3

@bytecodeguru

Description

@bytecodeguru

Summary

Skill che incentiva l'accumulo deterministico di script ad-hoc generati durante le sessioni Claude Code, in una sandbox locale, per permettere successiva revisione e promozione a skill tematiche riutilizzabili.

Motivazione

Oggi Claude genera script ad-hoc (Python con python-docx/openpyxl, bash multi-step, ecc.) ogni volta che serve interagire con formati/task senza tool dedicato. Spesso lo stesso pattern si ripresenta in sessioni diverse e viene rigenerato da zero, sprecando contesto e tempo.

L'idea è: zero attrito durante la sessione (heredoc, Write, qualsiasi cosa), curation esplicita a posteriori invocando questa skill.

Come funziona

  1. Invocazione utente: /curate-sandbox (sessione corrente) con opzioni:
    • --since <duration> (es. 7d, 24h) per estendere a sessioni recenti
    • --sessions <N> per le ultime N sessioni
  2. Extraction: parse dei transcript JSONL in `~/.claude/projects//` per individuare script candidati dentro tool_use di `Bash` (heredoc Python/bash/ecc.) e `Write` (file script)
  3. Filtri base per eliminare rumore:
    • Skip one-liner banali
    • Skip comandi read-only (ls/cat/grep/find puri)
    • Skip duplicati esatti (hash del contenuto)
  4. Dedup contro sandbox esistente: confronto per hash del contenuto + similarità di naming. Se già presente o molto simile, segnala ma non riproporre
  5. Report analitico (stile `/insights`) in markdown:
    • Summary: N candidati trovati, M già in sandbox, K nuovi
    • Candidati nuovi raggruppati per tema inferito (docx, xlsx, git, formato X, ecc.)
    • Per ciascuno: snippet, sessione/timestamp d'origine, contesto (messaggio utente che l'ha originato), dipendenze rilevate, nome proposto per la sandbox
    • Scartati con motivo
  6. Approvazione esplicita dell'utente: indica quali candidati salvare (es. "1, 3, 5" o "tutti tranne 2"). Nessun save automatico
  7. Save in `~/.claude/scripts-sandbox/` con naming `YYYYMMDD-HHMM-.` e header con data/sessione/contesto/dipendenze

Modalità aggiuntiva (review)

Sub-command `/curate-sandbox review` (o skill separata `/review-sandbox`) che scansiona la sandbox e propone estrazione di pattern ricorrenti in skill tematiche proper (es. se trova 5 script `docx` simili, suggerisce di creare una skill `edit-docx-from-template`).

Caratteristiche chiave

  • Zero attrito in sessione: nessun hook PreToolUse, nessun cambio di workflow, niente CLAUDE.md rule
  • Retrospettivo: può analizzare sessioni passate, non solo quella corrente
  • User-controlled: ogni save passa da approvazione esplicita
  • Dedup smart: evita di accumulare rumore nella sandbox

Decisioni aperte

  • Nome finale: `curate-sandbox`, `sandbox-curate`, `curate-scripts-sandbox`, o altro
  • Approvazione UX: `AskUserQuestion` checkbox-style (più strutturato ma forse pesante con tanti candidati) vs testo libero ("salva 1,3,5")
  • Similarità semantica: fermarci a hash+nome per MVP o includere già una similarità più fine (diff, tokenization)
  • Review come sub-command o skill a sé: decidere prima di implementare

Posizione

`plugins/bytecodeguru/skills//` come sibling delle skill attuali (vision/tech-stack/architecture/roadmap/bugfix).

Output atteso

`skill` user-invocable `/curate-sandbox` nel plugin bytecodeguru, più (opzionale) `/review-sandbox` separata.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions