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-only skill body: lean, non-generic, and fully actionable, with a clear multi-step workflow that branches on connector availability, photo accessibility, and rate limits, and with detail correctly pushed into three one-level reference files. No dimension falls short of its top anchor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~44-line body is all directive with zero concept explanation Claude already knows — no 'what a dating app is' padding, no library tours. Every line carries task-specific constraints ("never upload a local photo anywhere on the user's behalf", "do not state an app's policy from memory as fact"). Matches the 5 anchor 'every token earns its place'; nothing to trim toward the 4 anchor. | 5 / 5 |
Actionability | Fully executable guidance: exact tool names (`get_dating_app_photo_rules`, `check_ai_photo_policy`, `audit_dating_photo` with param constraints 'JPEG/PNG/WebP, max 10 MB'), a copy-paste setup command (`claude mcp add --transport http datephotos https://datephotos.ai/api/mcp`), and concrete lead-photo criteria (one person, face visible, well lit, natural expression, uncluttered background). All common cases — connector present/absent, local-only files, >5 photos — are covered, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | A clear sequence (context → rules → photos → AI-photo policy → bio/openers → deliver) with explicit checkpoints and recovery branches throughout: 'If the app is unknown, ask once; otherwise state the assumption and continue', the stale-rules check ('if lastReviewed more than 90 days old, say the rules may have changed'), the 5-audit rate warning, and fallback paths for missing connector and local-only photos. Not a destructive/batch skill, so the validation cap does not apply; this fits the 5 anchor's 'feedback loops for error recovery' plus the referenced checklist. | 5 / 5 |
Progressive Disclosure | The body is a lean overview that delegates detail to three real, one-level-deep references, each well-signaled at its point of use: 'Read references/photo-checklist.md before scoring', 'Read references/bio-and-openers.md', 'Use references/report-template.md'. All three files exist in references/ and are each referenced exactly once with no orphan or nested files — matching the 5 anchor 'easy navigation'. | 5 / 5 |
Total | 20 / 20 Passed |