CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skills-index-snippets

Create and maintain AGENTS.md / CLAUDE.md snippet indexes that route tasks to the correct dotnet-skills skills and agents (including compressed Vercel-style indexes).

Quality

73%

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

Quality

Content

75%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-structured, lean instruction skill: it provides two complete copy-paste snippet templates, identifies the registry as source of truth with the ID-matching rule, and gives a sequenced update procedure with a validation step. Remaining gaps are the absent validation feedback loop, unverifiable referenced scripts, and mild inline redundancy between the templates and the categories section.

DimensionReasoningScore

Conciseness

The body is efficient: no explanations of concepts Claude already knows, and the bulk is two copy-paste-ready templates plus a concrete update procedure. It is not a 5 because the "Recommended Categories" section (~12 lines) restates categories already evident in both templates, and the "Goal" section's three-point explanation of the router concept is slightly padded relative to the "When to Use" section that already conveys it.

4 / 5

Actionability

Guidance is mostly executable: two complete snippet templates ready to copy into a target repo, a concrete command ("./scripts/generate-skill-index-snippets.sh --update-readme"), a validation command ("./scripts/validate-marketplace.sh"), and a numbered update procedure with specific rules ("Keep names exactly matching frontmatter IDs"). It falls short of 5 because the referenced scripts are not part of this skill's bundle (no scripts/ directory), so their behavior and failure modes are unverifiable from the skill alone.

4 / 5

Workflow Clarity

"How to Update Snippets After Skill Changes" gives a clear 5-step sequence (update plugin.json → ensure frontmatter names → run validate-marketplace.sh → update routing lists → regenerate and re-copy downstream snippets) with an explicit validation checkpoint at step 3. It is not a 5 because there is no feedback loop for validation failures and no final verification that the regenerated snippet matches the registry, leaving minor validation gaps at the end of the sequence.

4 / 5

Progressive Disclosure

Structure is good: purpose, source of truth, both templates, README regeneration, update procedure, and categories are each clearly sectioned, and the whole skill is a self-contained overview with no nested or buried references. It is not a 5 because the body exceeds the simple-skill threshold (119 lines vs the under-50 guideline) and carries some inline redundancy (categories section, two parallel full templates) that a small references/ split could relieve, plus it references repo-level scripts without bundling or describing them.

4 / 5

Total

16

/

20

Passed

Description

58%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 solid description that clearly states what the skill produces (AGENTS.md/CLAUDE.md snippet indexes routing to dotnet-skills skills and agents, including a compressed Vercel-style variant) in third person with concrete artifacts. Its main weakness is the missing "Use when..." trigger clause, which both caps completeness and leaves natural trigger terms implicit.

Suggestions

Append an explicit trigger clause, e.g.: "Use when adding, removing, or renaming skills or agents in dotnet-skills, updating .claude-plugin/plugin.json, or creating AGENTS.md/CLAUDE.md routing snippets for downstream repos."

Include the natural phrases users would say when needing this skill ("skill index", "routing snippet", "plugin registry", "AGENTS.md boilerplate") to strengthen trigger-term coverage.

Mention the validation/regeneration capabilities (validate-marketplace.sh, generate-skill-index-snippets.sh --update-readme) to round out coverage of what the skill does.

DimensionReasoningScore

Specificity

"Create and maintain AGENTS.md / CLAUDE.md snippet indexes that route tasks to the correct dotnet-skills skills and agents (including compressed Vercel-style indexes)" lists several specific actions (create, maintain, route tasks to skills/agents, produce compressed Vercel-style variants) tied to concrete artifacts. It falls short of a 5 because it does not comprehensively cover related operations (e.g., regenerating README index blocks or validating the registry), and short of specificity in the sense of enumerating the snippet categories; it is clearly above a 3 since more than 1-2 concrete actions are named.

4 / 5

Completeness

The "what" is clear (create/maintain snippet indexes that route tasks to skills and agents, including compressed variants), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the "what" half is concrete, and not a 4 because the "when" half is entirely absent rather than merely underspecified.

3 / 5

Trigger Term Quality

Relevant keywords are present — "AGENTS.md", "CLAUDE.md", "snippet indexes", "skills", "agents", "Vercel-style" — but the phrases a user would naturally say when needing this skill (e.g., "add a new skill", "update the plugin registry", "skill routing index", "AGENTS.md boilerplate") are only weakly implied. It sits between anchor 3 (some relevant keywords, missing common variations) and anchor 4, closer to 3 because no explicit use-when phrasing surfaces the natural trigger terms.

3 / 5

Distinctiveness Conflict Risk

The niche is narrow — generating routing-index snippets for AGENTS.md/CLAUDE.md from a dotnet-skills plugin registry — so it is mostly distinct with minimal conflict risk. It is not a 5 because the description lacks explicit trigger phrases that would fully disambiguate it from adjacent skills like generic AGENTS.md authoring or plugin-validation skills, leaving minor overlap risk.

4 / 5

Total

14

/

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

Aaronontheweb/dotnet-skills

Path

skills/skills-index-snippets/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.