Content
78%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-organized, concise instruction skill whose key operations (reading the project plan, configuring git author identity) are given as executable commands. The main gaps are in the workflow: the memory-marking and @mention reporting steps lack concrete examples, and there is no guidance for failure or dependency-checking before starting a task.
Suggestions
Make workflow step 1 concrete — show the exact command or memory-file format used to mark a task as started, instead of 'mark it as started in your memory'.
Add a one-line example of the completion @mention (e.g., '@coordinator task-{id} complete — result at {path}') so step 3 is copy-paste ready like the git commands.
Add a checkpoint before execution: verify the task's dependencies are completed in plan.md before starting, and state what to do if a task fails or is blocked.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, assumes competence (no explanation of what git or a project plan is), and every section carries information. However, the Gotchas section repeats information that appears again later — 'Project plan is auto-synced' restates the Project Context intro, and the @mention and git-author points each appear twice — so minor trimming is possible, matching anchor 4 rather than anchor 5's 'every token earns its place'. | 4 / 5 |
Actionability | The core operations are copy-paste ready: 'cat /home/openhuman/.openhuman/shared/projects/{project-id}/plan.md' and the two 'git config' commands. Not anchor 5 because workflow steps 1 and 3 are abstract — 'mark it as started in your memory' and 'Report completion via @mention to your coordinator' give no concrete example of how to do either; not anchor 3 because the provided commands are fully executable, not pseudocode or high-level hints. | 4 / 5 |
Workflow Clarity | The three-step workflow (mark started → execute → report via @mention) is clearly sequenced, and this is not a destructive or batch operation so no validation cap applies. Missing anchor 5 because there are no checkpoints or error paths — nothing about verifying dependencies before starting (despite the plan listing them) or what to do if the task fails; beyond anchor 3 because each step is discrete and the completion-reporting step is explicit about its purpose ('so the project can advance'). | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references, and per the rubric's simple-skill guideline it qualifies for 5 with well-organized sections alone. The four sections (Gotchas, Project Context, Workflow, Git Config) each hold a distinct concern, and the plan-reading detail is kept inline at the right altitude with no reference sprawl. | 5 / 5 |
Total | 17 / 20 Passed |