borghei/Claude-Skills / workflow/session-retro
session-retro
VerifiedReview a coding-agent session and turn its failures and waste into ranked fixes to the agent's environment. Use when a session went slow or wrong, after a messy agent run, or to tune CLAUDE.md or AGENTS.md.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.9 KB |
| assets/retro_template.md | markdown | 1.5 KB |
| assets/sample_action_items.json | config | 1.9 KB |
| assets/sample_session.jsonl | other | 34.7 KB |
| references/finding-categories.md | markdown | 9.0 KB |
| references/fix-placement-and-steering-style.md | markdown | 6.3 KB |
| references/transcript-sources.md | markdown | 3.5 KB |
| scripts/action_item_linter.py | script | 8.4 KB |
| scripts/session_log_analyzer.py | script | 11.9 KB |
assets/sample_action_items.json
View on GitHub{
"session": "assets/sample_session.jsonl",
"note": "Items 1-4 pass. Items 5-6 are deliberately flawed so the linter exits 1 on this sample.",
"items": [
{
"rank": 1,
"category": "missing-check",
"change": "Add a `test` entry to the steering file: run `make test` (sets PYTHONPATH=src); bare `pytest` fails on import",
"file": "AGENTS.md",
"evidence": "calls #8-#12: three pytest variants failed with ModuleNotFoundError before the Makefile was read",
"severity": "high"
},
{
"rank": 2,
"category": "navigation",
"change": "Add a pointer: CLI flags for the exporter live in src/exporter/main.py (build_parser); config defaults in config.py",
"file": "CLAUDE.md",
"evidence": "calls #1-#3: three empty searches for dry_run/dryRun/cli*.py",
"severity": "high"
},
{
"rank": 3,
"category": "missing-check",
"change": "Wire `ruff check src` into the pre-commit hook so unused imports fail before the agent reports done",
"file": ".pre-commit-config.yaml",
"evidence": "call #22: ruff F401 found only at the very end of the session",
"severity": "medium"
},
{
"rank": 4,
"category": "permission-friction",
"change": "Allowlist `make clean` and remove the need for `rm -rf build` by adding a clean target",
"file": ".claude/settings.json",
"evidence": "calls #15-#16: rm -rf build denied twice, retried unchanged",
"severity": "medium"
},
{
"rank": 5,
"category": "tool-economy",
"change": "Be more careful with large git commands",
"file": "",
"evidence": "call #17",
"severity": "low"
},
{
"rank": 6,
"category": "process",
"change": "Remember to use the tdd skill next time",
"file": "CLAUDE.md",
"evidence": "",
"severity": "medium"
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |