Content
86%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.
A strong, executable skill body: concrete commands throughout, a clear step sequence, and a well-signaled two-file reference bundle. The only meaningful weaknesses are minor redundancy with the frontmatter description and the absence of response-validation guidance for mutating POST calls.
Suggestions
Add a checkpoint after mutating calls (e.g. 'After -m post, inspect the response body/status with --verbose before assuming success') to close the workflow_clarity validation gap for the mutation-capable POST workflows.
Trim the 'When to use' trigger lists and 'When not to use' section — they substantially duplicate the frontmatter description's USE FOR / DO NOT USE clauses — and drop noise like '(existing command)'.
De-duplicate content shared with references/command-reference.md (environments table, --verbose/--no-cache notes, PIM safety note) so each fact lives in exactly one place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-first and dense — e.g. 'fdev rest <serviceKey> \'<path>\'' with concrete examples — with almost no explanation of concepts Claude already knows. Minor over-trimming candidates remain: the 12-bullet typical/implicit trigger lists and the 'When not to use' section largely duplicate the frontmatter description, and the aside '(existing command)' adds noise. | 4 / 5 |
Actionability | Every workflow gives copy-paste-ready commands with concrete service keys, paths, and api-versions (e.g. "fdev rest people '/persons/me?api-version=3.0' -e ci"), plus the token JSON output format, the options line, and a need→command decision table. This covers the common cases fully. | 5 / 5 |
Workflow Clarity | The Instructions section is clearly sequenced (Step 1 'fdev --version' install check with fallback guidance, Step 2 command-choice table, Step 3 --verbose debugging, Step 4 --no-cache bypass). Minor validation gap: POST/mutating examples like "fdev rest context '/contexts?api-version=1.0' -m post -b '{\"query\":\"test\"}'" include no response-verification checkpoint despite the skill stating 'This skill is mutation-capable.' | 4 / 5 |
Progressive Disclosure | Clean split: SKILL.md holds overview workflows and safety, while 'command-reference.md — compact command cheat sheet with all options' and 'agentic-patterns.md — common agentic workflow recipes' are both verified to exist, one level deep, with descriptive one-liners and no nested references inside them. | 5 / 5 |
Total | 18 / 20 Passed |