Skip to content

v5.0 — Three new skills + session health check

Choose a tag to compare

View all tags
@AlexZio00 AlexZio00 released this 28 May 02:58
· 7 commits to master since this release
v5.0
d0352bd

New Skills (3)

/freeze — Scope lock before implementation

  • Parses your input to classify files as editable, frozen, or read-only
  • Emits a FROZEN SCOPE block and stops — no code generation, no agents
  • Ambiguous scope → one clarifying question; still vague → freeze the broader scope
  • Adapted from garrytan/gstack freeze pattern (task-scoped, no session state)

/retro — Milestone retrospective

  • 6-phase pipeline: scope → friction points (root cause) → wins → pattern extract → lessons write → summary
  • Duplicate check before writing — updates obs/seen on existing lessons.md matches
  • Complements session-checkpoint Reflexion (session-scoped); retro is milestone-scoped and goes deeper

/token-audit — Token overhead measurement

  • Measures actual overhead from your session JSONL — not estimates
  • Turn-weighted averaging across 8 categories (config baseline, memory re-reads, skill loading, agent overhead, etc.)
  • Optional dark-theme infographic with 6 panels (pip install matplotlib)
  • Benchmark: standard setups 35–50% overhead, heavy agent systems 50–65%

Enhancements

/session-start — Phase 0.5: Environment Health Check (runs every session)

  • Checks ~/.claude/settings.json model ID against known-valid Claude identifiers
  • Counts permissions.allow entries — warns if > 5 (silent permission surface growth)

/project-check — Safety Layers + Error Recovery

  • Explicit table of blocked actions mapped to Invariants — read-only guarantee is now auditable
  • Failure classification table: partial scans report as partial, never as complete

Usability fixes across the suite:

  • /pre-push: perl prerequisites documented (Strawberry Perl for Windows)
  • /session-checkpoint, /retro: auto-create tasks/lessons.md with header if missing
  • /harness-init: mkdir -p tasks/ guard before lessons.md write
  • /brief: trigger collision with /freeze resolved ("scope lock" moved to freeze)

Installation

SKILLS_DIR=~/.claude/skills
mkdir -p $SKILLS_DIR/{brief,adr,project-check,project-init,harness-init,team-init,pre-push/scripts,collab-audit,session-start,session-checkpoint,freeze,retro,token-audit}
# copy each skill directory's SKILL.md — see README for full commands

Full install commands: README → Installation

13 skills total. MIT.

Assets 2
Loading