Content
96%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 exceptionally tight, procedural skill: concrete commands, explicit constraints, skip-and-note error handling, and a terminal validation loop with remediation. The only material weakness is that the referenced scripts (tracker.py, make_pdf.sh) are not present in the skill bundle, so the workflow's referenced paths cannot be verified.
Suggestions
Ship scripts/tracker.py and scripts/make_pdf.sh inside the skill's scripts/ directory (or add a references/ note explaining where they live and how to create them), so the paths referenced in steps 2, 6 and 7 actually resolve.
If tracker.py grows more flags, move its full usage (all subcommands and arguments) into a short reference file and keep only the two canonical invocations in SKILL.md, keeping the main file lean while preserving discoverability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section is a directive with zero concept explanation — no time is spent explaining what a CV or a job tracker is; lines like "under 300 words" and "lowercase, hyphens" pack constraints into minimal tokens. The body assumes Claude's competence throughout (e.g. "Reorder and reword only"), matching the 'lean and efficient; every token earns its place' anchor. Not 4 because there is no identifiable padding to trim. | 5 / 5 |
Actionability | The steps give copy-paste-ready commands with explicit arguments ("python3 scripts/tracker.py exists \"<job_url>\" --company \"<company>\" --title \"<job_title>\"", "bash scripts/make_pdf.sh <folder>", "python3 scripts/tracker.py add --company ... --score <match> --region <region>"), plus concrete file paths, naming conventions, word limits, and NEEDS DAISY markers. Not 4 because the guidance is fully specified for the common cases rather than having executable gaps. | 5 / 5 |
Workflow Clarity | Eight explicitly numbered steps form a clear sequence with inline checkpoints (duplicate check via tracker.py in step 2, region/sponsorship/scam skip rules) and a dedicated Validation section with a remediation loop ("re-read each cv.md and confirm every claim appears in master-resume.md. Remove anything that does not. Check page length, spelling and personal details"), which satisfies the batch-operation validation requirement. Not 4 because validation is explicit with a fix-and-recheck loop rather than a single implicit 'verify' step; not capped at 3 because the batch workflow does include verification. | 5 / 5 |
Progressive Disclosure | The body is well-organized into Role/Inputs/Steps/Output/Rules/Validation with one-level-deep, clearly signaled paths to data files and scripts. However, the referenced scripts (scripts/tracker.py and scripts/make_pdf.sh) are absent from the actual bundle — the skill ships no references/, scripts/, or assets/ files — so the referenced paths do not resolve, which is more than a minor organization gap. Not 5 because the bundle does not contain the files the workflow depends on; not 3 because the in-file structure itself is clean with nothing that should be split out at this size. | 4 / 5 |
Total | 19 / 20 Passed |