CtrlK
BlogDocsLog inGet started
Tessl Logo

create-skill

How to create new skills for an agent-native app. Use when adding a new skill, documenting a pattern the agent should follow, or creating reusable guidance for the agent.

60

Quality

75%

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 ./.agents/skills/create-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 well-organized, lean instructional skill whose main strength is concrete, copy-paste-ready templates plus explicit naming and frontmatter conventions. The weaknesses are the absence of an explicit numbered creation workflow with validation checkpoints, and the lack of a filled worked example or reference files for depth.

Suggestions

Add an explicit numbered workflow for creating a skill (e.g., 1. Run the interview, 2. Pick a type, 3. Copy the template, 4. Apply naming/frontmatter rules, 5. Verify) with a validation checkpoint that confirms name matches directory, description is under 40 words, and SKILL.md is under ~500 lines.

Include one fully filled example of a real generated skill (frontmatter plus body) so the bracketed template placeholders have a concrete worked reference.

Move the three full templates into a references/templates.md file and keep only the type-selection guidance inline, matching the skill's own advice to push depth into references/ and slimming SKILL.md further.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no padding with concepts Claude already knows, and every section (When to Use, Interview, Templates, Naming, Frontmatter, Anti-Patterns) earns its place. It is not a 5 because the frontmatter block is repeated verbatim across all three templates and the 'Related Skills' stub appears three times, minor redundancy that could be factored out.

4 / 5

Actionability

Provides three complete copy-paste markdown templates, a concrete naming regex ('[a-z0-9-]', max 64 characters), a frontmatter field table, and specific anti-patterns — mostly executable guidance for an instruction-only skill. It falls short of anchor 5 because the templates are skeletons with bracketed placeholders and no filled worked example of a real generated skill, and there is no concrete scaffold command (e.g., creating the skill directory).

4 / 5

Workflow Clarity

The sections imply a logical order (Interview → choose a Type → apply the Template → Naming → Frontmatter → File Structure), but there is no explicit end-to-end numbered sequence for creating a skill, and validation checkpoints are absent — nothing tells the author to verify the result (e.g., name matches the directory, description is under 40 words, SKILL.md under 500 lines is only a tip, not a check). This matches anchor 3: sequence present but checkpoints missing or implicit.

3 / 5

Progressive Disclosure

The skill is self-contained (~180 lines) with clean section structure, consistent heading hierarchy, and nothing inlined that clearly belongs in a separate file; navigation is easy. It does not reach anchor 5 because there are no references/ files at all despite the skill advising 'push depth into references/', and the three full templates could be split into a references/templates.md to slim the overview.

4 / 5

Total

15

/

20

Passed

Description

73%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 that explicitly covers both what the skill does and when to use it, with natural trigger phrasing. The main weakness is specificity: the stated actions are generic/meta-level ('create', 'document a pattern') rather than a comprehensive list of concrete capabilities.

DimensionReasoningScore

Specificity

The description names the domain ('How to create new skills for an agent-native app') and a couple of actions ('documenting a pattern the agent should follow', 'creating reusable guidance'), matching anchor 3: domain plus 1-2 concrete actions, but not comprehensive. It falls short of anchor 4 because the actions are meta-level rather than a list of several specific concrete operations.

3 / 5

Completeness

It explicitly answers both what ('How to create new skills for an agent-native app') and when ('Use when adding a new skill, documenting a pattern the agent should follow, or creating reusable guidance for the agent') with concrete trigger phrases, matching the anchor 5 example pattern exactly. It is not a 4 because the 'when' clause is already explicit and specific with three distinct triggers.

5 / 5

Trigger Term Quality

'Use when adding a new skill, documenting a pattern the agent should follow, or creating reusable guidance' provides good natural keyword coverage users would actually say. A few natural variations are missing (e.g., 'make a skill', 'scaffold a skill', 'new skill'), so it does not reach anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (skill creation for an agent-native app) with distinct triggers, but phrases like 'documenting a pattern the agent should follow' and 'creating reusable guidance' carry minor overlap risk with closely related instruction-writing skills referenced in the body (writing-agent-instructions, capture-learnings). This matches anchor 4 (mostly distinct, minor overlap risk) rather than 5.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository
BuilderIO/agent-native
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.