CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

webspec-index

Query WHATWG, W3C, IETF and TC39 web specifications from the command line. Use to read a spec section or algorithm, find which algorithms invoke a concept and with what arguments, trace a call chain, list who writes a spec field, see what an algorithm may cause (events, tasks), look up IDL, validate an anchor, or read a spec as changed by an open WHATWG PR.

1.00x
Quality

91%

Does it follow best practices?

Impact

100%

1.00x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 dense, highly actionable command guide with realistic examples and unusually good validation/error-recovery guidance for a lookup tool. Its main weakness is structure: it is a monolithic 440-line SKILL.md whose full command API reference should be split into a references/ bundle file, with SKILL.md kept as overview plus common patterns.

Suggestions

Move the per-command API reference (query/search/exists/anchors/list/refs/trace/graph/idl/state/effects/flow details, PR previews, and update) into a references/commands.md file, keeping SKILL.md as a concise overview plus the highest-frequency patterns and one-line pointers per command.

Split the 'Usage patterns for Gecko development' scenarios into their own reference file (or trim to the 3-4 most common), and have SKILL.md signal it explicitly so the Gecko workflow detail is loaded only when relevant.

Remove small redundancies: the duplicated `webspec-index query 'DOM#concept-tree'` example and the pseudo-syntax placeholder line `webspec-index state 'SPEC#anchor' | --coverage SPEC [...]` in the state section.

DimensionReasoningScore

Conciseness

Nearly every token is tool-specific knowledge Claude cannot infer — real commands, flag semantics, and gotchas like "Roughly 60% of references are not calls" and may-semantics — with no explanations of concepts Claude already knows. Not 5: there are minor trims available, e.g. the duplicated example `webspec-index query 'DOM#concept-tree'` and the pseudo-syntax placeholder line in the state section. Not 3: no padded or unnecessary explanatory sections.

4 / 5

Actionability

Every section is copy-paste-ready bash with realistic concrete arguments ('HTML#navigate', "RFC9000#section-22", 'HTML#*sandbox*', 'Window.navigation'), documented flags, and described outputs. Specific examples cover the common cases for each subcommand, matching the fully-executable score-5 anchor.

5 / 5

Workflow Clarity

Scenario workflows sequence commands with comments, and validation checkpoints with error-recovery loops are explicit: "Read `Search was truncated` before trusting the result — raise `-l` or narrow the endpoints", "confirm an absence with `refs --direction incoming --kind step` before concluding a call does not exist", and `exists` exit-code validation before citing anchors. The tool involves no destructive or batch operations, so no cap applies.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and all ~440 lines — including the full per-command API reference — are inlined in SKILL.md. Section headers give it some structure, but the command-reference bulk clearly belongs in a one-level-deep references/ file, matching the score-3 anchor (content that should be separate is inline) rather than 4 (most content appropriately placed).

3 / 5

Total

17

/

20

Passed

Description

92%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: concrete, third-person, comprehensive action list paired with an explicit multi-trigger "Use to…" clause. The only weakness is slight synonym coverage (e.g., "standard" as well as "spec"/"specification").

DimensionReasoningScore

Specificity

The description enumerates eight concrete, distinct actions ("read a spec section or algorithm", "find which algorithms invoke a concept and with what arguments", "trace a call chain", "list who writes a spec field", "look up IDL", "validate an anchor", "read a spec as changed by an open WHATWG PR") — comprehensive coverage of the tool's capabilities with no vague filler. It clearly matches the score-5 anchor rather than 4, which would require minor gaps in the action inventory.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the opening sentence ("Query WHATWG, W3C, IETF and TC39 web specifications from the command line"), and the "when" is an explicit "Use to…" clause with concrete trigger phrases for each capability. Not 4: the trigger guidance is already explicit and specific, not merely present.

5 / 5

Trigger Term Quality

It uses natural phrases a user would actually say when needing this skill ("spec section", "algorithm", "call chain", "IDL", "anchor", "PR", plus the org names WHATWG/W3C/IETF/TC39), giving good keyword coverage. It falls short of 5 because common synonyms like "standard", "web standard", or "spec URL" are missing.

4 / 5

Distinctiveness Conflict Risk

Naming the four standards bodies and the command-line query niche gives it a clear domain with distinct triggers; no plausible overlap with unrelated skills. Minimal conflict risk, matching the score-5 anchor.

5 / 5

Total

19

/

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

mozilla/enterprise-firefox

Path

.agents/skills/webspec-index/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.