Content
76%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.
A highly actionable, command-dense operational playbook with clear sequencing and one well-placed reference. The main gaps are a missing post-change validation/feedback loop for destructive operations (capping workflow clarity) and some repeated playbook content that could be trimmed.
Suggestions
Add an explicit verify-after-change step for destructive/batch commands (e.g., after `migrate` run `schema-version` to confirm, after `cancel-task`/`retry-task` re-run `dump-task` to confirm the new state) to form a validate -> fix -> retry feedback loop.
Collapse the "Good copy-paste playbooks" section or mark it as condensed cross-references to the commands already detailed above, to remove repetition and tighten token use.
Consider moving the schema/migration setup into the authoring-and-recovery reference (or a dedicated ops reference) and keeping SKILL.md focused on the debug/inspection flow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense with executable commands and a lean mental model that earns its place with Absurd-specific definitions, but the "Good copy-paste playbooks" section repeats commands already shown in "Default debugging workflow" and "Common actions" — minor trimmable repetition that keeps it just below fully lean. | 4 / 5 |
Actionability | Extensive copy-paste-ready `uvx absurdctl` commands with concrete flags (-P key=value, -P key:=json, --params, --payload, --spawn-new) plus executable rg patterns, covering the common inspection and mutation cases fully. | 5 / 5 |
Workflow Clarity | Debugging flows are clearly numbered (1-2-3-4) and there is a safe-operating-rules section, but the destructive/batch operations (init, migrate, drop-queue, cancel, retry, spawn, emit) lack an explicit validate-after-change feedback loop, so the destructive-operation cap at 3 applies. | 3 / 5 |
Progressive Disclosure | One clearly-signaled one-level-deep reference ("read [authoring and recovery](references/authoring-and-recovery.md) before editing") pointing to a real file, with a well-sectioned overview body; the inlined operational playbook is justified by the skill's command-heavy nature but keeps it just short of a fully split structure. | 4 / 5 |
Total | 16 / 20 Passed |