CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

energy-procurement

Codified expertise for electricity and gas procurement, tariff optimisation, demand charge management, renewable PPA evaluation, and multi-facility energy cost management.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/energy-procurement/SKILL.md

The canonical home for this skill is energy-procurement in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A specific, well-scoped description for a distinct domain, weakened by the complete absence of a 'when to use' trigger clause. Adding an explicit 'Use when...' sentence with concrete trigger phrases would lift it to the top tier.

Suggestions

Add an explicit trigger clause, e.g., 'Use when evaluating electricity or gas supply contracts, preparing energy RFPs, assessing PPAs or VPPAs, or reducing demand charges and capacity tags across multiple facilities.'

Broaden natural keyword coverage: include 'power purchase agreement' spelled out, 'utility bills', 'energy suppliers', and the US spelling 'optimization' alongside 'optimisation'.

Enumerate the full lifecycle the skill covers (RFPs, supplier negotiation, hedging, budget forecasting, sustainability reporting) to close the remaining specificity gap.

DimensionReasoningScore

Specificity

The description lists several specific capability areas ('tariff optimisation, demand charge management, renewable PPA evaluation, and multi-facility energy cost management') with only minor gaps. It falls short of anchor 5 because it is not a comprehensive list of concrete actions — RFPs, supplier negotiation, hedging, and sustainability reporting are all absent — and phrasing is nominal ('expertise for...') rather than action-based.

4 / 5

Completeness

The 'what' is clear (codified expertise for the enumerated procurement tasks), but there is no 'Use when...' clause or any equivalent explicit trigger guidance in the description, which caps completeness at 3 per the judging guidelines. It is above anchor 2 because the 'what' is specific and multi-part, not vague.

3 / 5

Trigger Term Quality

Good coverage of natural domain keywords ('electricity and gas procurement', 'tariff', 'demand charge', 'PPA', 'energy cost management') that users would plausibly say. A few natural terms are missing: 'power purchase agreement' spelled out, 'utility bills', 'supplier contracts', 'hedging', and the US spelling 'optimization'.

4 / 5

Distinctiveness Conflict Risk

A clear niche (C&I electricity and gas procurement) with distinct trigger terms like 'demand charge management' and 'renewable PPA evaluation' that would not naturally route users to unrelated skills. Conflict risk with other skills is minimal.

5 / 5

Total

16

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/energy-procurement/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.