CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dev-create-component

Use when adding a new UI component to the project - handles templates, props, and scoped styles.

Quality

79%

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 ./packs/astro/skills/dev-create-component/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is an exemplary concise, actionable skill: exact paths, a complete template, a verification checklist, and a concrete validation command with no wasted tokens. The only meaningful gap is the absence of a fix-and-retry loop around the "npx astro check" validation step. Structure and disclosure are appropriate for a skill of this size.

DimensionReasoningScore

Conciseness

The ~42-line body is lean and assumes competence: no concept explanations, no padding, and every line instructs (paths, template, checklist, command). The only nit — "Read docs/ARCHITECTURE.md section 5" repeated in the intro and step 1 — is too trivial to drop it from the top anchor.

5 / 5

Actionability

Fully concrete: exact file paths per component type ("src/components/ComponentName.astro", "src/layouts/LayoutName.astro"), a copy-paste-ready Astro template with frontmatter/props/style structure, a six-item definition checklist, and the specific validation command "npx astro check". Placeholders like "prop1, prop2" are inherent to a scaffold template, not a gap.

5 / 5

Workflow Clarity

A clear five-step sequence with an explicit validation checkpoint ("Validate: npx astro check") and a post-creation checklist. It stops short of level 5 because there is no error-recovery feedback loop (e.g. "if the check fails, fix and re-run") — the level-5 anchor requires that loop.

4 / 5

Progressive Disclosure

Under 50 lines with a single clearly signaled one-level-deep reference ("docs/ARCHITECTURE.md section 5") and a well-organized "## Steps" section; no bundle files exist or are needed. Per the rubric's simple-skill guideline, this earns the top anchor on well-organized sections alone.

5 / 5

Total

19

/

20

Passed

Description

58%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 has a clear, explicit trigger clause but a weak 'what': "handles templates, props, and scoped styles" never states the actual action (creating Astro components) or the framework. Trigger coverage lacks common synonyms and the .astro extension, and the framework omission creates genuine conflict risk with non-Astro component skills. It is serviceable but sits mid-scale on most dimensions.

Suggestions

State the concrete action and framework up front, e.g. "Create Astro components (.astro files) with typed Props and scoped styles, following project conventions. Use when adding, creating, or scaffolding a new UI component."

Add natural trigger synonyms and the file extension: 'create', 'scaffold', 'new component', 'Astro component', '.astro'.

Name Astro explicitly in the trigger clause so the skill does not fire for React/Vue/Svelte component requests.

DimensionReasoningScore

Specificity

"handles templates, props, and scoped styles" names the domain and its facets, but "handles" is a generic verb and the concrete action (creating an Astro component file) is never stated. This matches the anchor for domain plus 1-2 concrete actions rather than the level-4 anchor listing several specific actions.

3 / 5

Completeness

Both parts are present: an explicit "Use when adding a new UI component" clause and a 'what' ("handles templates, props, and scoped styles"). It falls short of level 5 because the 'what' is vague — no concrete action verb like "Create Astro components" — and exceeds level 3 because the 'when' is explicit rather than weakly implied.

4 / 5

Trigger Term Quality

"adding a new UI component" is a natural phrase users would say, but common variations and synonyms are missing: "create", "scaffold", the framework name "Astro", and the ".astro" file extension. Some relevant keywords present, but coverage is incomplete, matching the level-3 anchor.

3 / 5

Distinctiveness Conflict Risk

The trigger "adding a new UI component" is somewhat specific but would also fire for React, Vue, or Svelte component requests since the framework (Astro) is never named in the description. This creates real overlap risk with any other component-creation skill, matching the level-3 anchor rather than level 4's 'minor overlap risk'.

3 / 5

Total

13

/

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

fernandezbaptiste/specialist-agent

Path

packs/astro/skills/dev-create-component/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.