CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bikeshed-conversion

Convert a W3C spec from ReSpec (index.html) to Bikeshed (index.bs), keeping its anchors and exported terms stable

Quality

77%

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 ./skills/bikeshed-conversion/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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.

This is a strong, expert-level conversion playbook: fully sequenced with validation feedback loops, concrete commands and config blocks, and hard-won gotchas (var:type, data-lt, oldids) that Claude could not invent. Its main defects are a missing bundle script that the verification step depends on, some duplicated guidance, and no use of reference files for the bulky lookup tables.

Suggestions

Ship `check-anchors.py` with the skill (or move its usage into a `scripts/` file) so the step-7 verification command is actually runnable.

Move the step-6 common-issues table and the ReSpec id-pattern tables into a reference file (e.g. `references/gotchas.md`) and keep a short pointer in SKILL.md, reducing token load when the skill is loaded.

Deduplicate the |var:type| and example-id guidance, which appears in both step 3 and step 6/examples sections.

DimensionReasoningScore

Conciseness

The body is dense operational detail that assumes Claude's competence — e.g. "Bikeshed does NOT support this — it renders the |var:type| text literally", the data-lt semantics difference, and the ReSpec id-pattern table — with no filler explaining what ReSpec or Bikeshed are. Not 5 because the |var:type| issue and example-id guidance are each explained twice (step 3 prose and the step 6 issue table / examples section), and a few table rows restate earlier bullet points.

4 / 5

Actionability

Guidance is largely copy-paste ready: the exact spec-generator curl URL, `bikeshed -f spec`, complete `.pr-preview.json` and workflow YAML blocks, and BAD/GOOD HTML snippets. Not 5 because the critical verification step depends on `python3 <skill-dir>/check-anchors.py`, a script referenced as being in the skill's directory but absent from the bundle, so the shipped skill cannot actually run its own verification flow.

4 / 5

Workflow Clarity

Seven clearly sequenced steps with explicit validation checkpoints and feedback loops: baseline sanity check (`grep -c '<dfn'` "must be more than 0"), iterative fix-until-clean ("fix ALL errors, warnings, and info messages... until the build produces ZERO output"), and verify-and-retry ("must end with OK. For every id or exported term it reports missing, fix index.bs... then rerun"), plus visual comparison and artifact cleanup. This matches the anchor-5 example's validate→fix→retry structure despite involving destructive steps (deleting index.html).

5 / 5

Progressive Disclosure

Section structure is clear (numbered steps, labeled subsections), but the bundle contains no reference files at all while the body twice references `check-anchors.py` "in this skill's directory" — a broken reference — and ~100 lines of lookup material (the issue/fix table, id-pattern tables, and element-conversion rules) are inlined in SKILL.md where a reference file would keep the working overview lean. Above anchor 2 because structure and signaling are present; below anchor 4 because the one reference used is not actually shipped.

3 / 5

Total

16

/

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.

The description is highly specific and unambiguous about what the skill does, with excellent niche distinctiveness and the right technical trigger terms. Its one structural weakness is the total absence of a 'when to use' clause, which caps completeness and leaves invocation conditions implicit.

Suggestions

Add an explicit trigger clause, e.g. "Use when converting or migrating a W3C repository's spec source from ReSpec to Bikeshed".

Include one or two natural synonyms such as "migrate" or "spec migration" so users phrasing the request differently still match.

Optionally name the supporting activities (CI/preview config updates, anchor verification) to broaden the 'what' beyond the single convert action.

DimensionReasoningScore

Specificity

"Convert a W3C spec from ReSpec (index.html) to Bikeshed (index.bs), keeping its anchors and exported terms stable" names concrete file formats, the transformation, and the invariant to preserve. Not 5 because it describes a single action plus constraint rather than a list of specific capabilities (no mention of CI updates, building, or verification); clearly above the '1-2 concrete actions' of 3.

4 / 5

Completeness

The 'what' is explicit and precise (convert ReSpec index.html to Bikeshed index.bs while keeping anchors and exported terms stable), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

Natural terms a user would say are present: "W3C spec", "ReSpec", "Bikeshed", "index.html", "index.bs", "anchors", "exported terms" — in this niche the jargon IS the natural vocabulary. Not 5 because synonyms like "migrate"/"migration" or "spec conversion" are missing.

4 / 5

Distinctiveness Conflict Risk

"Convert a W3C spec from ReSpec (index.html) to Bikeshed (index.bs)" occupies a clear, narrow niche with distinct trigger terms; no realistic overlap with other skills. Not lower: it is far more specific than the 'mostly distinct' anchor 4 example.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

w3c/web-performance

Path

skills/bikeshed-conversion/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.