Arnie016/codex-prompt-templates / skills/auto-skill-build-agent-run-ledger-dashboard
auto-skill-build-agent-run-ledger-dashboard
VerifiedAppend and summarize a lightweight local `.agent-runs/runs.jsonl` ledger (claudetop-inspired) so Codex sessions build durable observability over time. Use at the end of a significant task, after running tests, or when you want a quick “what did we do lately?” dashboard. Skip when the user only wants a one-off fix and does not care about tracking runs.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.9 KB |
SKILL.md
View on GitHub---
name: auto-skill-build-agent-run-ledger-dashboard
description: >
Append and summarize a lightweight local `.agent-runs/runs.jsonl` ledger
(claudetop-inspired) so Codex sessions build durable observability over time.
Use at the end of a significant task, after running tests, or when you want
a quick “what did we do lately?” dashboard. Skip when the user only wants a
one-off fix and does not care about tracking runs.
---
# Agent Run Ledger Dashboard
Generated by: Codex Supercharge maintenance automation.
Goal: cheap, append-only run tracking without relying on proprietary telemetry.
## Append a run entry
Run from the repo you worked in:
```bash
python3 plugins/codex-supercharge/scripts/agent_runs_append.py \
--task "Fix flaky auth tests" \
--model "${CODEX_MODEL:-}" \
--status ok \
--command "pytest -q" \
--notes "Root cause: clock mocking"
```
Notes:
- `--model` defaults to `$CODEX_MODEL` when set.
- The script records current git branch/head + uncommitted diff stats when available.
## View a dashboard summary
```bash
python3 plugins/codex-supercharge/scripts/agent_runs_report.py --days 7 --last 20
```
## Recommended workflow
1. After completing a task, run the append command once.
2. When starting work, run the report command to see recent context.
3. If you want richer fields (tokens/cost), add them as new keys; keep JSONL append-only.
## Skip when
- The repo is sensitive and you cannot persist local logs.
- The task is a trivial one-liner and you are not doing longitudinal tracking.
## References
- `plugins/codex-supercharge/references/agent-run-ledger.md`
- Pattern inspiration only (do not run blindly): `sources/claudetop`
## Validation
- Appending creates exactly one JSONL record for the run.
- Reports summarize the requested window without rewriting the ledger.
- Sensitive task notes are summarized or omitted before persistence.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |