CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

assess-energy-shock

Model oil or gas supply shock exposure for a country and chokepoint. Use when the user asks how an energy disruption could affect fuel supply, strategic cover, or product deficits.

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 highly actionable, well-structured API skill: complete endpoint details, an executable worked example, explicit error handling, prompt-injection safety, and clear routing to sibling skills. Minor gains are available by consolidating the repeated gas-semantics caveats and moving some interpretation prose to a reference file.

DimensionReasoningScore

Conciseness

The body is dense but efficient: a parameter table with shapes and clamping rules, a complete response example, and a copy-paste curl command. The gas-semantics paragraphs (lines 70-74) repeat coverage and caveat statements that could be consolidated, matching anchor 4 (efficient with minor over-explanation to trim) rather than 5.

4 / 5

Actionability

Provides an exact endpoint URL, auth header format, full parameter table with types and defaults, an executable curl example with jq projection, and error codes with retry guidance. This is copy-paste ready and covers common cases, matching anchor 5.

5 / 5

Workflow Clarity

As a single-task API skill, the single action (present key header, GET with parameters, interpret response flags) is unambiguous, with explicit error-recovery paths for 401, 429 (retry with backoff), and degraded data via dataAvailable/coverageLevel. The simple-skill exception applies; there are no destructive or batch operations requiring a validation cap.

5 / 5

Progressive Disclosure

Content is well-organized under clear section headers, with core interpretation material inline and deeper material (OpenAPI spec, auth matrix, docs) delegated one level deep via a References section. At ~105 lines with several dense gas-semantics paragraphs that could live in a reference file, it matches anchor 4 (good structure, minor organization gaps) rather than 5.

4 / 5

Total

18

/

20

Passed

Description

78%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 strong description with an explicit and well-targeted 'Use when' clause covering distinct trigger topics. Its main weaknesses are the single capability verb (modeling) and missing natural trigger variants like "chokepoint", "LNG", or named straits that users would commonly say.

Suggestions

List one or two more concrete capabilities in the 'what' sentence (e.g., quantifies product deficits and effective cover days) to raise specificity.

Add natural trigger variants such as "chokepoint", "LNG", or named straits (e.g., "strait closure") that users would actually say when they need this skill.

Clarify distinctiveness from adjacent skills by signaling that this is scenario modeling rather than current-status monitoring in the description itself.

DimensionReasoningScore

Specificity

"Model oil or gas supply shock exposure for a country and chokepoint" names a specific domain and one concrete action, but lists only a single action verb without secondary capabilities (products affected, cover days, gas sensitivity). It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 4, which requires several listed actions.

3 / 5

Completeness

It explicitly answers both questions: what ("Model oil or gas supply shock exposure for a country and chokepoint") and when ("Use when the user asks how an energy disruption could affect fuel supply, strategic cover, or product deficits") with concrete trigger topics. The 'when' clause is explicit and specific, matching anchor 5 rather than 4.

5 / 5

Trigger Term Quality

Triggers like "energy disruption", "fuel supply", "strategic cover", and "product deficits" are natural user phrasings. Common variants such as "chokepoint", "LNG", or named straits (Hormuz/Malacca) — which the body itself uses as example triggers — are missing, so it falls at anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Scenario shock modeling is a clear niche distinct from static energy profiles or chokepoint status checks, but terms like "energy disruption" and "fuel supply" carry minor overlap risk with closely related sibling skills (which the body's own "When NOT to use" section routes around). Anchor 4 (mostly distinct, minor overlap) fits better than 5.

4 / 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

koala73/worldmonitor

Path

public/.well-known/agent-skills/assess-energy-shock/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.