Content
36%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 an agent persona prompt with a strong concrete tool-call section, but it buries that actionability under verbose aspirational sections, presents focus areas as if they were a workflow, and opens with a stray second YAML frontmatter block that confuses the skill's identity. Financially risky operations (payments, tier upgrades) lack any validation or error-recovery guidance.
Suggestions
Remove the duplicate frontmatter block at the top of the body and keep a single, accurate YAML header, moving the persona description into clean prose sections.
Convert the 'financial management approach' list into a sequenced workflow with validation checkpoints (e.g., check balance → warn user below threshold → create payment link → confirm credit applied → verify via ruv_history).
Trim the 'Quality standards' and 'Cost optimization strategies' sections to the few items that carry Flow Nexus-specific facts, and move the tool-signature reference and tier tables into a references/ file with a one-level-deep pointer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Several sections are padded filler that add no executable guidance: 'Quality standards' ('Secure payment processing with industry-standard encryption', 'Responsive billing support and dispute resolution'), the closing paragraph ('always prioritize transparency, cost efficiency, security, and user value...'), and generic advice like 'Batch Operations: Group related tasks to minimize overhead costs' that Claude does not need taught. This matches 'Noticeably verbose; several unnecessary explanations or padded sections' — below level 3, whose padding is limited to isolated instances. | 2 / 5 |
Actionability | The toolkit block is genuinely concrete (real MCP tool names with parameter shapes, e.g., mcp__flow-nexus__configure_auto_refill({enabled, threshold, amount})), but everything else is descriptive rather than instructive — 'Track credit usage and predict refill needs' and 'Evaluate subscription needs and recommend appropriate tiers' give no steps, thresholds, or error handling. This lands at 'Some concrete guidance but incomplete' rather than level 4, where guidance is mostly executable with only minor gaps. | 3 / 5 |
Workflow Clarity | The 'Your financial management approach' numbered list (Balance Monitoring, Payment Optimization, ...) is a list of focus areas, not a sequenced workflow, and there are zero validation checkpoints for operations (payments, tier upgrades) that are financially risky — per the rubric's cap guidance, missing validation in risky operations keeps this at or below 3. It matches level 2 ('Rough sequence present but many gaps; steps poorly defined; validation absent') rather than level 3 because even the sequence itself is not an actual step order. | 2 / 5 |
Progressive Disclosure | The body has recognizable sections (responsibilities, toolkit, approach, tiers, optimization), but a stray duplicate YAML frontmatter block ('name: flow-nexus-payments / color: pink') sits at the top of the body, muddying what the skill actually is, and everything is inlined in one monolithic prompt with no reference files. This matches 'Some structure but could be better organized' — above level 2's truly minimal structure, but below level 4 given the confusing duplicate frontmatter and no separation of the large reference-style lists (tool signatures, tiers) into distinct files. | 3 / 5 |
Total | 10 / 20 Passed |