CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

component

Help author a component specification for an agent.

52

Quality

65%

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

Quality

Content

78%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 a tight, well-structured instruction skill: a clear goal statement, a concrete fillable template, and an ordered set of imperative instructions with sensible guardrails (ask when unsure, use complete file paths, prefer file references over code snippets to avoid staleness). The only meaningful gaps are the absence of a worked example of a completed overview and the lack of an explicit validation step before finishing.

DimensionReasoningScore

Conciseness

The body is lean with no padding and no explanation of concepts Claude already knows — every section is skill-specific (goal, fillable template, instruction list). Only minor trimming is possible: the overview paragraph ("The overview should include a brief description of the component, its main features, an architectural diagram and layout of important code files") restates what the format template already encodes. This matches anchor 4 (efficient, minor over-explanation) rather than anchor 5 because of that small duplication.

4 / 5

Actionability

Concrete, executable guidance: a fully structured markdown template with placeholders, an exact output path ("`.components/[component-name].md`"), and a specific path convention with a worked example ("`src/vs/workbench/services/example/browser/exampleService.ts`"). It falls short of anchor 5 only because there is no filled-in example overview to anchor expected output quality; it is clearly above anchor 3, which expects pseudocode or missing key details.

4 / 5

Workflow Clarity

The instructions form a coherent sequence — **Create** the file, **Fill** sections, **Gather** information, **Ask** for clarification — with an escalation checkpoint ("Ask the user for clarification if you cannot fill out a section with accurate information"). It is not anchor 5 because the steps are an unordered bullet list without an explicit validation pass (e.g. verifying every section is filled or that referenced paths exist), and not anchor 3 because the sequence and checkpoint are clearly present.

4 / 5

Progressive Disclosure

The skill is a self-contained, ~50-line document with no external references needed (no references/, scripts/, or assets/ exist), and it is well organized into three clearly signaled tagged sections (overview, format, instructions) with the template cleanly separated from the procedural instructions. Per the simple-skill scoring note, a short single-purpose skill with no need for external files earns full marks with well-organized sections alone.

5 / 5

Total

17

/

20

Passed

Description

36%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 thin: it names the domain but gives a single generic action, no trigger guidance for when to use the skill, and no hint of the deliverable's substance (component overview, features, architecture diagram, key files). It reads closer to the penalized pattern "Helps with documents" than to the strong examples, which state multiple concrete actions plus an explicit "Use when..." clause.

Suggestions

State what the skill actually produces, e.g. "Generate a component overview document covering the component's purpose, scope, key classes and interfaces, architecture diagram, and key code files with complete file paths."

Add an explicit trigger clause, e.g. "Use when the user asks to create, update, or document a component overview/specification, or wants a component summary to attach to a feature request."

Include natural synonyms users would say — "component overview", "component documentation", "component summary" — to improve both trigger coverage and distinctiveness from generic component-building skills.

DimensionReasoningScore

Specificity

The description names the domain ("a component specification") but offers only a minimal, generic action — "Help author" — with no mention of what the specification actually contains (overview, features, architecture diagram, file layout). It parallels the anchor-2 example "Processes PDF files" (domain named, action minimal) rather than anchor 3, which expects one or two concrete, substantive actions; it is not anchor 1 because the domain is concretely named rather than pure abstraction.

2 / 5

Completeness

There is no "Use when..." clause or any equivalent trigger guidance — the "when" is entirely absent, which caps completeness at 3 — and the "what" is itself vague: it never says what the specification includes. This lands on anchor 2 (vague what, no when) rather than anchor 3, which requires a clearly stated "what" comparable to "Extract text and tables from PDF files, fill forms, merge documents".

2 / 5

Trigger Term Quality

It contains relevant keywords — "component specification", "agent" — but misses the natural phrases a user would likely say, such as "component overview", "component documentation", or "architecture diagram". This matches anchor 3 ("some relevant keywords but missing common variations or synonyms", e.g. "Works with PDF files") better than anchor 4's good-and-nearly-complete coverage, and better than anchor 2 because the keywords are domain-specific rather than generic.

3 / 5

Distinctiveness Conflict Risk

"Component" is a broadly used software term, so the description could overlap with UI/React component-building or general spec-writing skills, but "component specification" for an agent context is a somewhat distinct artifact type. This fits anchor 3 ("somewhat specific but could still overlap with similar skills") rather than anchor 4, which would require mostly distinct triggers the description does not provide.

3 / 5

Total

10

/

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

microsoft/vscode

Path

.github/skills/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.