Content
92%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.
This is a tight, executable process skill: a phased, numbered workflow with an explicit approval gate, runnable commands at every operational step, an exact output template, and a built-in validate/repair/re-run loop in Phase 3. It assumes Claude's competence, wastes no tokens on background theory, and its external pointers are clearly signaled one level deep. The only soft spots are unspecified details around flow-id derivation and what 'approval' concretely looks like, which keep actionability just below maximum.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive throughout — e.g., "one numbered paragraph per frame, 4–8 frames for most features... never implementation" and "Only numbered paragraphs become frames" — with zero padding and no explanation of concepts Claude already knows (git worktrees, PRs, and scaffolding are used, not taught). Matches the 'every token earns its place' anchor; a 4 would require trimmable over-explanation, which is absent. | 5 / 5 |
Actionability | Concrete, executable commands dominate the operational phases — `git worktree add ../_worktrees/ipollowork-<flow-id> -b feat/<flow-id> origin/dev`, `pnpm fraimz scaffold <flow-id>`, `gh pr create --base dev --fill`, `pnpm fraimz --flow <flow-id> --pr` — plus an exact file path (`evals/voiceovers/<flow-id>.md`) and a copy-paste script-format template. Not 5 due to minor gaps: how `<flow-id>` is derived, what constitutes user approval, and which questions to ask in Phase 1 are left open. Not 3 because the guidance given is genuinely executable, not pseudocode. | 4 / 5 |
Workflow Clarity | A clear four-phase sequence with continuously numbered steps (1–7), an explicit gating checkpoint ("The contract: no code until the script is approved", "Do not renumber or reword paragraphs after this without re-approval"), and explicit validation with a feedback loop: "drive the demo against the real app, repair, and re-run until every frame passes" and "the runner fails any flow whose narration drifts from it". Matches the top anchor's sequence + explicit validation + error-recovery loop. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and nothing inlined belongs in a separate file — the body is a compact process overview with clear section headers. The "Source of truth" section provides well-signaled, one-level-deep pointers (`evals/runner/voiceover.mjs`, the reference script, the `fraimz` skill) with no nesting. Navigation is trivial; matches the top anchor for a self-contained, well-organized skill. | 5 / 5 |
Total | 19 / 20 Passed |