Content
82%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, dense instruction-only skill: highly actionable decision frameworks with numeric thresholds, clear escalation and performance-indicator tables, and well-verified one-level reference files. The main improvements are trimming duplicated content (the double 'When to Use' section and repeated figures) and moving a couple of long knowledge subsections into references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious domain specifics (PLC/capacity tag mechanics, ratchet percentages, ERCOT Uri pricing, VPPA settlement terms) that assume domain ignorance rather than Claude's intelligence, so most tokens earn their place. Minor over-explanations of concepts Claude already knows (GHG Protocol dual reporting, REC basics, 'Dollar-cost averaging for energy') plus a duplicated 'When to Use' section and figures repeated verbatim between Core Knowledge and Edge Cases keep it below anchor 5. | 4 / 5 |
Actionability | For an instruction-only skill, the guidance is fully actionable: explicit numeric decision thresholds ('If simple payback < 5 years... justified'), a concrete formula ('Load factor = (Total kWh) / (Peak kW × Hours in period)'), verbatim negotiation scripts, and a specific RFP recipe ('Issue RFPs to 5–8 qualified REPs. Include 36 months of interval data, your load factor...'). Specific examples cover the common cases (contract renewal, PPA evaluation, demand charge ROI). | 5 / 5 |
Workflow Clarity | Each decision framework is a numbered sequence with explicit branch checkpoints ('If energy cost variance >5% of budget triggers a management review, lean fixed'), and the escalation table pairs triggers with actions and timelines. It falls short of anchor 5 because there are no verification or feedback loops (e.g., validating a forecast or re-checking assumptions before recommending), though the skill involves no destructive or batch operations, so no cap applies. | 4 / 5 |
Progressive Disclosure | Three one-level-deep references are clearly signaled with markdown links and all exist in references/; the Edge Cases section deliberately summarizes and defers ('Brief summaries here — see edge-cases.md for full analysis'), and Additional Resources consolidates navigation. Minor gap: some Core Knowledge subsections (Market Structures, Sustainability Reporting) are long enough that they could themselves live in reference files, leaving SKILL.md as a leaner overview. | 4 / 5 |
Total | 17 / 20 Passed |