CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

madrid-avisos

Prepare, submit with user authorization, and check municipal reports at avisos.madrid.es. Use for Avisos Madrid, reporting street defects, cleaning, lighting or urban equipment in Madrid city, and requests for new street elements. Not for other municipalities, emergencies, or general administrative appeals.

Quality

87%

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

81%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 well-engineered, lean workflow for an agentic browser task: clear phases, strong verification discipline around submission, and appropriate safety constraints stated as rules rather than explanations. The only notable gap is that references/evaluation.md is not signposted from the body, and a worked draft example would push actionability to the top.

DimensionReasoningScore

Conciseness

The body is dense and operational with almost no explanation of concepts Claude already knows; nearly every sentence encodes a portal-specific fact or constraint. A few long, hedged sentences (e.g., "do not repeat approval already given unless the content, data, destination, or a host-required confirmation changes") could be trimmed, matching the efficient-with-minor-trimming anchor rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

For an instruction-only skill the guidance is highly executable: a copy-ready draft template with named fields, concrete portal controls ("Nuevo reporte", "Mis reportes"), and a fixed status vocabulary ("Borrador", "Registrado", "Envío no confirmado"). It stays at 4 rather than 5 because there is no worked example of a filled draft or Spanish description text, leaving minor gaps for the most common case.

4 / 5

Workflow Clarity

The four phases (Choose mode → Gather and draft → Prepare the portal → Submit and verify) are clearly sequenced with explicit validation checkpoints and feedback loops: read back filled values, treat a click/spinner/HTTP success as non-evidence, report "Envío no confirmado" on ambiguity, and inspect "Mis reportes" before any retry with no duplicate submission. This matches the top anchor with error-recovery loops; the destructive/batch cap does not apply because validation is thorough.

5 / 5

Progressive Disclosure

Three of the four bundle files (portal.md, sessions.md, runtimes.md) are one level deep and clearly signaled with when-to-read conditions. However, references/evaluation.md is never referenced or linked from the body, so navigation to it relies on discovery alone — a minor organization gap that keeps this below the well-signaled, complete top anchor.

4 / 5

Total

17

/

20

Passed

Description

87%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 third-person voice that pairs concrete capabilities with an explicit 'Use for' trigger clause and a clear 'Not for' boundary. Trigger terms are natural and domain-specific, with only minor synonym coverage gaps.

DimensionReasoningScore

Specificity

The description lists three concrete actions — "Prepare, submit with user authorization, and check municipal reports" — plus the concrete domain avisos.madrid.es and specific report categories (street defects, cleaning, lighting, urban equipment), matching the anchor for several specific actions with minor gaps (e.g., status tracking is only implied by "check"). It falls short of the 5 anchor's comprehensive multi-action coverage.

4 / 5

Completeness

It explicitly answers both questions: what ("Prepare, submit with user authorization, and check municipal reports") and when ("Use for Avisos Madrid, reporting street defects... and requests for new street elements"), with concrete trigger phrases plus explicit exclusions. This matches the 5 anchor clearly; the 4 anchor's weaker 'when' clause does not apply.

5 / 5

Trigger Term Quality

Natural trigger phrases are well covered: "Avisos Madrid", "reporting street defects, cleaning, lighting or urban equipment in Madrid city", "requests for new street elements", and the URL "avisos.madrid.es". A few natural synonyms users might say (e.g., "pothole", "report a problem in Madrid", "track my report") are missing, keeping it just below the comprehensive-coverage anchor.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous (a single named municipal portal for Madrid city) and the explicit "Not for other municipalities, emergencies, or general administrative appeals" boundary minimizes conflict risk, matching the clear-niche anchor. It is more distinct than the 4 anchor's minor-overlap example.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

saski/arnesto

Path

.agents/skills/madrid-avisos/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.