Content
100%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 instruction-style skill: every step is a concrete command, validation and failure paths are explicit, and the scope-control guidelines prevent drift. It assumes Claude's competence and adds only project-specific knowledge.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative ('Always fetch origin before creating a worktree — never branch from local develop', 'Do not open a PR with known failures') with concrete commands instead of explanation. The few rationale asides ('this prevents another agent or engineer from picking up the same task concurrently', 'do not use gh pr create, which fails with a Projects Classic deprecation warning') convey non-obvious project-specific context rather than padding, so every token earns its place. | 5 / 5 |
Actionability | Guidance is copy-paste ready: exact git worktree add/remove commands, './gradlew spotlessApply' / 'spotlessCheck' / ':<affected-module>:testDebugUnitTest', 'gh api repos/duckduckgo/Android/pulls --method POST', and full workflow-dispatch commands with REST API fallbacks. Placeholders like <short-desc> and <branch-name> are obvious and appropriate. | 5 / 5 |
Workflow Clarity | The workflow is explicitly sequenced (Before you start → Implement → Verify → Open the draft PR → If stuck → Guidelines) with a validation feedback loop ('If any check fails due to your changes, fix it and re-run before proceeding') and a complete blocked-path (comment, move task back to Ready, clean up, do NOT open a partial PR). This is not a batch/destructive skill without validation, so no cap applies. | 5 / 5 |
Progressive Disclosure | A single ~90-line instruction file with clear section headers and no bundle files; external references (CLAUDE.md commit rules, .github/PULL_REQUEST_TEMPLATE.md, the ddg-asana skill) are clearly signaled and one level deep. Nothing inlined here belongs in a separate reference file, and navigation is trivial. | 5 / 5 |
Total | 20 / 20 Passed |