CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

track-unrest-events

Retrieve seeded protest, riot, strike, and civil unrest events. Use when the user asks whether social unrest is occurring in a country or over a recent time window.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 lean, well-structured API skill: everything Claude needs to authenticate, call, and interpret the endpoint is present and executable, with strong error-recovery guidance and proper externalization of reference material. The only flaw is minor duplication of the health-check caveat between the Response shape and Errors sections.

DimensionReasoningScore

Conciseness

Nearly all content is API-specific detail Claude could not know (auth header, parameter table, response shape, error codes) with no padding about known concepts, but the health-check caveat ('check /api/health?compact=1 ... leaves status at HEALTHY') is repeated nearly verbatim in the Response shape and Errors sections, and the opening sentence restates the frontmatter description.

4 / 5

Actionability

The worked curl example is complete and copy-paste executable (header, URL, urlencoded country/start params, jq projection), and the parameter table, JMESPath example, and per-error-code remedies make the common cases executable as-is. Not 4 because no key details are missing from the example.

5 / 5

Workflow Clarity

A simple single-action skill whose sequence (set WM_API_KEY, call the endpoint with the X-WorldMonitor-Key header, project with jq) is unambiguous, and it includes explicit recovery guidance: cross-check /api/health on ambiguous empty results and 'retry with backoff' on 429. The simple-skill exception applies; the feedback loops present keep it above anchor 4.

5 / 5

Progressive Disclosure

No bundle files exist; the body is cleanly sectioned (Authentication, Endpoint, Parameters, Response, Example, Errors, When NOT to use) and bulk detail (full OpenAPI spec, auth matrix) is externalized one level deep via clearly signaled reference URLs rather than inlined.

5 / 5

Total

19

/

20

Passed

Description

82%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 in the anchor-5 pattern: concrete third-person capability statement plus an explicit 'Use when...' trigger clause covering country and time-window queries. Its only weaknesses are a single retrieval action verb and the omission of a few natural synonyms (demonstrations, marches).

DimensionReasoningScore

Specificity

'Retrieve seeded protest, riot, strike, and civil unrest events' names the domain and enumerates concrete event types around a single retrieval action, matching anchor 3 (domain plus 1-2 concrete actions, not comprehensive). Not 4 because only one action verb is offered; not 2 because the action and object types are concrete rather than generic.

3 / 5

Completeness

Explicitly answers both questions: what ('Retrieve seeded protest, riot, strike, and civil unrest events') and when ('Use when the user asks whether social unrest is occurring in a country or over a recent time window'), mirroring the anchor-5 good example structure with concrete trigger phrasing. Not 4 because the 'when' clause is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Natural user phrases are well covered - 'protest', 'riot', 'strike', 'civil unrest', 'social unrest is occurring' - but common variations like 'demonstrations' or 'marches' are absent even though the body uses 'demonstrations'. Matches anchor 4 (good keyword coverage, a few natural terms missing); not 5 because those synonyms are missing.

4 / 5

Distinctiveness Conflict Risk

Civil-unrest event retrieval is a clear niche with distinct triggers, and the 'when' phrasing ('whether social unrest is occurring') is unlikely to fire for adjacent skills (conflict events, news digests) that the body explicitly disambiguates. Not 4 because overlap risk is minimal, not minor.

5 / 5

Total

17

/

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

skills/track-unrest-events/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.