Content
65%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.
The content is compact and actionable with real gh api commands and concrete output formats, but the workflow lacks any validation or error-recovery steps and its single declared reference file is missing from the bundle. It also leaves key scoring mechanics (fit score, skill-level bars) undefined.
Suggestions
Add validation checkpoints to the workflow: how to handle empty search results, API rate limits, and private/nonexistent profiles before generating a profile.
Fix the dangling 'AGENTS.md' reference — either ship the file (ideally under references/) or remove the Reference Files section.
Define how the 1-10 fit score and the 1-5 skill-level bars in the skills matrix are derived from the gathered data (e.g., weighting rules per criterion).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely efficient — criteria are terse bullet lists and the gh api commands are compact with no padding or explanations of concepts Claude already knows. Minor over-explanation/trimmable material remains ('Use ASCII box art for visual appeal', the 'Example Queries' and 'When to Use' sections partially duplicate the frontmatter description), which fits the 'efficient, minor instances that could be trimmed' anchor rather than the fully lean 5. | 4 / 5 |
Actionability | Provides concrete, mostly executable guidance: real `gh api` commands with `--jq` filters and a concrete output template. Minor gaps remain — commands use an unsubstituted `{username}` placeholder, 'Gather Data via GitHub MCP' names no MCP tool, and neither the 1-10 fit score nor the 1-5 skill-level bars have a defined derivation, keeping it below the fully copy-paste-ready 5. | 4 / 5 |
Workflow Clarity | A clear four-step sequence exists (gather data → analyze repos → check contributions → generate profile), but there are no validation checkpoints or error-recovery loops: no handling for empty search results, rate limits, private/nonexistent profiles, or verification of data before scoring. This matches the 'steps listed but validation gaps, checkpoints missing' anchor, not 4, which requires most checkpoints present. | 3 / 5 |
Progressive Disclosure | The body is reasonably sectioned, but the only reference it declares ('AGENTS.md - Project guidelines and contributor attribution' under 'Reference Files') does not exist in the bundle — no references/, scripts/, or assets/ directories are present, so the reference is dangling. The evaluation criteria and output templates could also live in a reference file for this ~114-line body, matching the 'some structure, references present but not clearly usable' anchor. | 3 / 5 |
Total | 14 / 20 Passed |