CtrlK
BlogDocsLog inGet started
Tessl Logo

starlight-custom-component

Create and override Astro Starlight UI components. Use when replacing or extending built-in Starlight components (header, footer, sidebar, page title, etc.), adding custom UI alongside existing components, accessing page route data inside a component, or applying overrides conditionally on specific pages.

75

Quality

93%

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

86%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 strong, well-structured body: executable examples for every common task, a clear step-by-step override workflow, high-value Starlight-specific anti-patterns, and clean separation of detail into a single real reference file. The only weaknesses are minor — slight redundancy in the anti-patterns/reference links and no explicit verification step in the workflow.

Suggestions

Add a final validation step to the override workflow (e.g., Step 4 — run the dev server / `astro build` and confirm the override renders) to close the workflow-clarity gap.

State each anti-pattern's consequence once (either in the WHY line or the Consequence line, not both) and mention overrides-reference.md once in the body plus once in References to tighten conciseness.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence (e.g., "Page data lives in `Astro.locals`, not props" adds only Starlight-specific knowledge), but there is minor trimmable redundancy: the overrides-reference.md link appears three times, and several anti-patterns state a consequence both inline and in a separate "**Consequence:**" line. This sits between the level-4 anchor (efficient, minor instances that could be trimmed) and level 5 (every token earns its place), closer to 4 than 5 because of that duplicated material.

4 / 5

Actionability

Fully executable, copy-paste-ready code covers the common cases: creating a component, registering it in `astro.config.mjs`, wrapping a default component (including named-slot transfer for `PageFrame`/`TwoColumnContent`), and accessing `Astro.locals.starlightRoute`. This matches the level-5 anchor (copy-paste ready code covering common cases); level 4 would require minor gaps in the examples, which are not present.

5 / 5

Workflow Clarity

A clear three-step sequence (identify slot → create component → register in config) with an explicit pointer to the Overrides Reference and Overrides Map, and failure modes enumerated with consequences. It falls short of the level-5 anchor because there is no explicit validation checkpoint (e.g., "run `astro build` / dev server to confirm the override applies"); the destructive/batch cap of 3 does not apply since this is not a destructive or batch operation.

4 / 5

Progressive Disclosure

The body is a concise overview with the bulky material (full component table, starlightRoute property table) correctly split into a single well-signaled reference file (references/overrides-reference.md, verified to exist), referenced one level deep with clear context for what it contains. This matches the level-5 anchor (clear overview, well-signaled one-level-deep references, easy navigation); the inline snippets are appropriate key examples, not misplaced bulk content.

5 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: third-person voice, concrete capabilities, an explicit 'Use when...' clause with specific triggers, and clearly distinct scope. It directly parallels the rubric's good-overall examples in structure and quality.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Create and override Astro Starlight UI components", "replacing or extending built-in Starlight components (header, footer, sidebar, page title, etc.)", "adding custom UI alongside existing components", "accessing page route data inside a component", "applying overrides conditionally" — with comprehensive coverage of the skill's capabilities. It matches the level-5 anchor (multiple specific concrete actions) and exceeds level 4, which allows only minor gaps; nothing material is missing.

5 / 5

Completeness

It explicitly answers both questions: what ("Create and override Astro Starlight UI components") and when ("Use when replacing or extending built-in Starlight components... adding custom UI... accessing page route data... applying overrides conditionally on specific pages") with concrete trigger phrases. This is a textbook match for the level-5 anchor; the explicit 'Use when...' clause rules out the level-4 cap on weak 'when' guidance.

5 / 5

Trigger Term Quality

Natural trigger phrases a user would actually say are covered: "override", "replacing or extending" (synonyms), "custom UI", and concrete component names ("header, footer, sidebar, page title") that users would name directly. This matches the level-5 anchor's comprehensive synonym coverage; level 4 ("a few natural terms missing") would apply only if common phrasings like the component names or replace/extend variants were absent.

5 / 5

Distinctiveness Conflict Risk

The niche is clear and narrowly scoped to Astro Starlight component overrides, with triggers naming specific Starlight components — minimal conflict risk with adjacent skills (theming, content management). It matches the level-5 anchor (clear niche with distinct triggers); level 4's "minor overlap risk with closely related skills" would require broader, less Starlight-specific wording.

5 / 5

Total

20

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pantheon-org/tekhne
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.