Content
70%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 well-sequenced, highly actionable instruction body with explicit validation checkpoints and a strong error-recovery protocol. Its weaknesses are redundancy (file-location and session-catchup rules each stated multiple times) and bundle-level navigation: four of the body's file references (all templates plus plan-inventory.md) point to files that are not shipped.
Suggestions
Ship the referenced bundle files — templates/task_plan.md, templates/findings.md, templates/progress.md, and plan-inventory.md — or remove/inline those links, since four references in the body currently dangle in a bundle that contains only SKILL.md and scripts/.
State the file-location rule once (in the "Dateispeicherort" section) and drop its repetition in the Schnellstart note and the Anti-Münstler table row to reduce token cost.
Consolidate the session-catchup security boundary explanation, currently given in full both in Schritt 1 and the Skripte section, into a single location.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is operational throughout (no explanations of concepts Claude already knows), but it is ~280 lines with repeated guidance: file-location rules appear three times (the "Dateispeicherort" section, the Schnellstart note "Planungsdateien kommen in das ausgewählte Aufgabenverzeichnis deines Projekts", and the Anti-Muster row "Dateien im Skill-Verzeichnis erstellen → Dateien im Projekt erstellen"), and the session-catchup boundary policy is fully stated both in Schritt 1 and again in the Skripte section. Mostly efficient but could be tightened — matches the score-3 anchor. | 3 / 5 |
Actionability | Concrete, mostly copy-paste-ready commands cover the main cases: "scripts/init-session.sh \"Task Name\"", "sh \"$PWF_SKILL_DIR/scripts/check-complete.sh\" --validate path/to/task_plan.md", the full bash and PowerShell invocations of "session-catchup.py --metadata/--replay", and "set-active-plan.sh --list / --archive / --yes / --restore" — all referencing scripts that exist in the bundle. Not 5 because of minor gaps: the set-active-plan command uses a "<skill-dir>" placeholder requiring substitution, and PLAN_ID/PWF_PLAN_ROOT pinning is described but never shown as a command. | 4 / 5 |
Workflow Clarity | The sequence is explicit with validation checkpoints and error-recovery feedback loops: restore state (Schritt 1 through resolve-plan-dir and "git diff --stat") → init/adapt plan → "Die Prüfung muss vor der Umsetzung und nach Änderungen an der Phasenstruktur bestehen" (validate before and after) → per-phase status updates → the Drei-Versuche-Protokoll escalation loop ending in asking the user, plus checklists (Fünf-Fragen-Neustarttest, decision matrix). This matches the score-5 anchor: clear sequence, explicit validation, feedback loops, checklists. | 5 / 5 |
Progressive Disclosure | Sections are well-organized and script references are real, but scored against the actual bundle (SKILL.md + scripts/ only, no templates/ or references/ directories), several referenced paths are dangling: "[templates/task_plan.md](templates/task_plan.md)", "[templates/findings.md](templates/findings.md)", "[templates/progress.md](templates/progress.md)", and "[plan-inventory.md](plan-inventory.md)" point to files absent from the bundle, making the "Kopiere diese Vorlagen" instruction non-actionable from the shipped skill. Not 4 because broken references are more than a minor organization gap; not 2 because the body itself is structured and navigable, and the majority of references (all scripts) resolve. | 3 / 5 |
Total | 15 / 20 Passed |