CtrlK
BlogDocsLog inGet started
Tessl Logo

markdown-toc

Extract a Markdown heading tree with line numbers before editing or integrating notes. Use when you need to inspect a long Markdown file quickly and choose the best insertion point instead of editing blind.

76

Quality

95%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A concise, fully actionable skill body that pairs an executable bundled script with a clear five-step workflow and a real one-level reference, with no padding or unnecessary concept explanation.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — it gives the command, sample targets, a short workflow, and an output sample without explaining what Markdown or headings are, so every token earns its place.

3 / 3

Actionability

It provides a copy-paste-ready command 'python3 {baseDir}/scripts/extract_toc.py /path/to/file.md', concrete target examples, specific follow-up commands ('sed -n', 'nl -ba'), and a sample output block, matching fully executable guidance.

3 / 3

Workflow Clarity

The five-step Workflow is clearly sequenced and, because the operation is read-only inspection rather than destructive/batch work, the absence of an explicit validation checkpoint is not penalized per the simple-skill guidance.

3 / 3

Progressive Disclosure

At under 50 lines with well-organized sections and a single one-level-deep reference to a real bundled file ({baseDir}/scripts/extract_toc.py, confirmed present), it matches the anchor for clear overview with well-signaled references.

3 / 3

Total

12

/

12

Passed

Description

90%

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 focused, well-formed description with an explicit Use-when trigger and concrete language; its only weakness is that it names a single core action rather than enumerating multiple capabilities, capping specificity at 2.

Suggestions

Broaden specificity by listing the additional concrete actions the skill supports (e.g., locating a section by line number, comparing heading structure across files) alongside the primary extraction action.

DimensionReasoningScore

Specificity

Quotes one concrete core action — 'Extract a Markdown heading tree with line numbers' — but the rest ('editing or integrating notes', 'choose the best insertion point') frames use cases rather than listing multiple distinct capabilities, so it sits at 'names domain and some actions' rather than 'lists multiple specific concrete actions'.

2 / 3

Completeness

It explicitly answers what ('Extract a Markdown heading tree with line numbers') and when via an explicit 'Use when you need to inspect a long Markdown file quickly...' clause, matching the top anchor.

3 / 3

Trigger Term Quality

Natural terms a user editing notes would actually say appear throughout: 'Markdown file', 'notes', 'editing', 'inspect', matching the anchor for good coverage of natural terms.

3 / 3

Distinctiveness Conflict Risk

The TOC-with-line-numbers niche and 'before editing' trigger are specific enough to avoid firing for unrelated skills, matching 'clear niche with distinct triggers'.

3 / 3

Total

11

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
huangruiteng/CS-Notes
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.