Content
93%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exemplary lean skill: executable commands, one-line flag docs, explicit clustering criteria, and hard safety rules with rationale ('Never commit the transcript dump. It contains prompts, paths, and user content.'). The only gap is the absence of edge-case guidance (empty results, choosing the lookback window), which keeps workflow clarity just short of the top anchor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | '--corrections narrows to user turns that look like a correction. --full keeps long messages intact.' — every flag documented in a single line, commands given bare, no explanations of concepts Claude already knows (no preamble on OpenCode or git rev-parse). The two framing sentences ('Past corrections are a materialized process.') establish the skill's premise in two lines; every token earns its place. | 5 / 5 |
Actionability | Two copy-paste-ready commands ('python3 .agents/skills/mine-agent-transcripts/scan.py --days 30'), a documented env var ('Set OPENCODE_DB to read another OpenCode database'), a specified output format ('Write one line per cluster with links'), and a concrete handoff target ('Pass the cluster list to harden-environment'). Not 4 because the commands cover the common cases fully as written. | 5 / 5 |
Workflow Clarity | Clear three-step sequence (read history, cluster, hand off) with an explicit quality gate ('A cluster needs at least two turns and the same underlying shape') and a fallback branch ('If no constraint is possible, the cluster is a judgment call'). Not 5 because there is no error-recovery or edge-case guidance (e.g. what to do when the scan returns nothing, or how to choose --days 30 vs 90); the read-only scan means the destructive/batch validation cap does not apply. | 4 / 5 |
Progressive Disclosure | No bundle files exist in references/, scripts/, or assets/, so the score reflects the body itself: a ~50-line, cleanly sectioned document (Read the history / Cluster, do not fix / Hand off the clusters / Rules) whose single external dependency (scan.py) is referenced by full path, one level deep, inside a code block — well-signaled and easy to navigate. | 5 / 5 |
Total | 19 / 20 Passed |