Content
40%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 body is a tidy catalog stub that honestly explains its role and how to reach the upstream material, but as a skill it provides almost no executable guidance: the install step has no command, the sole code block is a comment plus an 'open' URL, and all real copywriting content is deferred to an external repo. It reads as an advertisement rather than an operational skill file.
Suggestions
Replace the 'open' URL block with the actual install steps (e.g., a git clone or copy command plus the target skills-directory path) so the setup sequence is executable end-to-end.
Add a verification checkpoint after install, such as confirming the 'copywriting' skill is discoverable or invocable before telling the user to invoke it.
Trim the duplication: drop the verbatim 'What it does' restatement and the 'Source' section's repeat of the frontmatter upstream/category, keeping only the install-and-invoke instructions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and free of concept over-explanation, but it pads with duplication: 'What it does' repeats the frontmatter description verbatim and 'Source' restates the upstream URL and category already in the frontmatter. It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the lean anchor above. | 3 / 5 |
Actionability | Concrete guidance is minimal: the only command is 'open https://github.com/coreyhaines31/marketingskills' plus the comment 'Inspect the upstream README for exact paths', and the key step — 'install the upstream bundle into your active agent's skills directory' — is given with no install command or steps. This matches 'minimal concrete guidance; high-level hints but missing the specific steps to execute' rather than anchor 3, because the actionable core is deferred rather than merely incomplete. | 2 / 5 |
Workflow Clarity | A rough sequence exists (open upstream repo, install the bundle, invoke by name or trigger phrase), but the critical install step is undefined and there are no checkpoints or verification (e.g., confirming the skill is installed and invocable). This fits 'rough sequence present but many gaps; steps poorly defined' rather than anchor 3, where steps would at least all be listed. | 2 / 5 |
Progressive Disclosure | No references/, scripts/, or assets/ directories exist in the bundle, and the body is a short, well-sectioned overview (What it does / Source / How to use) that clearly signals its single one-level-deep pointer to the upstream repo. It earns good structure with a minor gap — the actual workflow content lives entirely outside the skill at an external URL rather than in bundled files — keeping it below the clear-overview-with-local-references ideal. | 4 / 5 |
Total | 11 / 20 Passed |