CtrlK
BlogDocsLog inGet started
Tessl Logo

howto-section-generator

Deprecated compatibility entry for How-to Section construction. This component is now maintained in Bricks; install and use component-builder to build a new How-to Section.

64

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/components/content/howto-section/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

As a deprecation stub, the body is exemplary: it states plainly that the component has moved, gives an executable install command, and explicitly declares that no component rules are contained here. Every dimension is satisfied by what is written, with no waste tokens.

DimensionReasoningScore

Conciseness

The body is a lean 8-line redirect: a heading, a one-sentence pointer to the successor, an install command, and one instruction. Every token earns its place with no padding or explanation of concepts Claude already knows. Not below 5 because nothing could be cut without losing information.

5 / 5

Actionability

The install command 'npx skills add kostja94/bricks --skill component-builder' is copy-paste ready and the follow-up instruction ('Ask the agent to use component-builder to build a new How-to Section') is concrete and complete for the entry's purpose. Not below 5 because no key detail is missing for executing the migration.

5 / 5

Workflow Clarity

This is a simple single-purpose skill whose single action (install the successor, then use it) is unambiguous and correctly ordered, so the simple-skill exception applies. Not below 5 because no destructive or batch operation is involved, so no validation checkpoint is required.

5 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references, and consists of a well-organized single section that links one level deep to the successor's reference document. Per the scoring notes, this satisfies the top anchor for short self-contained skills; there are no buried or nested references.

5 / 5

Total

20

/

20

Passed

Description

53%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 honest and specific about the skill's deprecated status and points clearly to its successor, but as a trigger description it is incomplete: it lacks any 'when to use' guidance and offers no natural trigger phrases. Distinctiveness is good since the scope is tightly named.

Suggestions

Add an explicit 'Use when...' clause (or equivalent trigger guidance) naming the situations in which this entry or its successor should be invoked, e.g. 'Use when building or editing a How-to Section'.

Include natural trigger keywords and synonyms users would actually say (e.g., how-to section, tutorial section, guide section) so the successor skill is discoverable from this entry.

Briefly state what a How-to Section component actually produces, so the entry conveys the domain's concrete actions rather than only its deprecation status.

DimensionReasoningScore

Specificity

The description names the domain ('How-to Section construction') and one concrete action ('install and use component-builder'), matching the anchor for naming the domain with 1-2 concrete actions but not comprehensive. It is not score 4 because it lists no capabilities of the component itself, and not score 2 because 'install and use component-builder to build a new How-to Section' is more concrete than a generic domain mention.

3 / 5

Completeness

There is a clear 'what' — a deprecated compatibility entry whose successor is component-builder — but no 'when' guidance at all, so the missing-'Use when' clause caps this at 3 per the judging guidelines. Not score 2 because the 'what' is explicit and specific rather than vague; not score 4 because no trigger context is present or implied.

3 / 5

Trigger Term Quality

'How-to Section' and 'component-builder' are relevant domain keywords, but the description offers no natural trigger phrases or synonyms a user would say, matching 'some relevant keywords but missing common variations or synonyms'. Not score 4 because there is no coverage of natural variations users might use (e.g., tutorial section, guide section); not score 2 because the keywords present are specific rather than generic.

3 / 5

Distinctiveness Conflict Risk

The scope is narrowly pinned to 'How-to Section construction' with a named successor, so it is mostly distinct with only minor overlap risk against general component-building skills. Not score 5 because 'compatibility entry' language and the reference to generic 'Bricks' leave slight ambiguity against sibling component entries; not score 3 because the domain term is far more specific than the 'Works with document files' anchor.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
kostja94/marketing-skills
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.