CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

toc-generator

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

Quality

80%

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 ./skills/components/navigation/toc/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.

The body is an exemplary deprecation stub: it states the move, gives an executable install command, links directly to the replacement reference, and explicitly disclaims that it contains no component rules. It is lean, fully actionable, and appropriately structured for a redirect with no bundle files. No improvements needed for what it is.

DimensionReasoningScore

Conciseness

The 9-line body is maximally lean: a heading, one sentence naming the new home, one copy-paste install command, one usage instruction, and one sentence telling the agent no rules live here. Every token earns its place with zero padding or explanations of concepts Claude already knows. Matches anchor 5.

5 / 5

Actionability

Provides a fully executable, copy-paste-ready command ('npx skills add kostja94/bricks --skill component-builder') plus a concrete instruction ('Ask the agent to use component-builder to build a new Table of Contents') and a direct link to the reference. The single common case for this stub is fully covered. Matches anchor 5.

5 / 5

Workflow Clarity

This is a simple, single-purpose skill and the single action is unambiguous: follow the link, run the install command, then use component-builder. No destructive or batch operations exist, so no validation checkpoints are needed. Per the simple-skill scoring note, this scores 5.

5 / 5

Progressive Disclosure

The skill is under 50 lines, requires no bundle files (none exist in references/, scripts/, or assets/), and is well-organized with a clearly signaled, one-level-deep reference link to the successor's documentation. Per the simple-skill scoring note, this scores 5.

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 clearly communicates the skill's deprecation status and where the functionality moved, using specific language rather than vague filler. However, it lacks an explicit 'Use when...' trigger clause and natural keyword variations, limiting its discoverability and completeness. As a redirect stub it serves its purpose, but the missing trigger guidance is the main gap.

Suggestions

Add an explicit 'Use when...' clause (e.g., 'Use when the user asks to build or update a table of contents') to raise completeness and trigger-term coverage.

Include natural keyword variations users would actually say, such as 'TOC', 'contents page', or 'section links', to improve trigger term quality.

Specify the medium or output type for Table of Contents construction (e.g., markdown files, HTML pages) to sharpen distinctiveness against general document-formatting skills.

DimensionReasoningScore

Specificity

Names the domain ('Table of Contents construction') and one concrete action ('install and use component-builder to build a new Table of Contents'), but coverage is not comprehensive. Matches anchor 3: domain plus 1-2 concrete actions; below 4 because it lists no multiple specific capabilities.

3 / 5

Completeness

The 'what' is clear (a deprecated compatibility entry whose successor lives in Bricks), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. The 'when' is only weakly implied by the topic mention.

3 / 5

Trigger Term Quality

The natural phrase 'Table of Contents' appears twice, but common variations and synonyms users would say ('TOC', 'contents page', 'section links/navigation') are absent. Fits anchor 3: some relevant keywords but missing common variations.

3 / 5

Distinctiveness Conflict Risk

'Table of Contents construction' is a single, specific task niche unlikely to trigger for unrelated skills, though it lacks a medium qualifier (markdown/HTML/PDF unspecified) and could overlap with closely related document-navigation or formatting skills. Fits anchor 4: mostly distinct with minor overlap risk; below 5 because it has no distinct trigger phrases to further disambiguate.

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

Path

skills/components/navigation/toc/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.