CtrlK
BlogDocsLog inGet started
Tessl Logo

adb-skill-generator

Meta-tool for rapid adb-* skill creation from templates

68

1.88x
Quality

22%

Does it follow best practices?

Impact

100%

1.88x

Average score across 6 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./adb-meta-automation/adb-skill-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

17%

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 too terse and jargon-heavy to serve as an effective skill selector. It lacks a 'Use when...' clause, concrete action verbs, and natural trigger terms that a user would employ. While the adb-* domain provides some distinctiveness, the description needs significant expansion to be useful in a multi-skill selection context.

Suggestions

Add a 'Use when...' clause with natural trigger terms like 'create a new adb skill', 'scaffold skill', 'new skill from template', 'add adb skill'.

List specific concrete actions such as 'Generates skill markdown files, configures YAML frontmatter, scaffolds directory structure from predefined templates'.

Replace jargon like 'meta-tool' with clearer phrasing such as 'Scaffolds and creates new adb-prefixed skill files' to improve discoverability.

DimensionReasoningScore

Specificity

It names the domain (adb-* skill creation) and one action (rapid creation from templates), but doesn't list multiple concrete actions like what the creation process involves (e.g., generating files, configuring YAML frontmatter, scaffolding directories).

2 / 3

Completeness

It partially addresses 'what' (skill creation from templates) but has no 'when' clause or explicit trigger guidance, and the 'what' itself is vague. The missing 'Use when...' clause caps this at 2 per the rubric, but the weak 'what' brings it to 1.

1 / 3

Trigger Term Quality

The terms 'meta-tool', 'adb-* skill creation', and 'templates' are technical jargon unlikely to match natural user queries. Users would more likely say 'create a new skill', 'scaffold a skill', or 'add a new adb skill'.

1 / 3

Distinctiveness Conflict Risk

The 'adb-* skill creation' niche is somewhat specific and distinguishable from general coding or document skills, but 'meta-tool' and 'templates' could overlap with other scaffolding or template-generation skills.

2 / 3

Total

6

/

12

Passed

Implementation

27%

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

This skill is significantly over-documented for what is essentially a CLI scaffolding tool. It suffers from excessive verbosity (design philosophy, TOON explanations, ecosystem context), a monolithic structure that should leverage progressive disclosure, and missing validation steps in its workflows. The actionable CLI examples are its strongest aspect, but they're buried in unnecessary context.

Suggestions

Cut the content by at least 50%: remove 'Design Philosophy', 'What is TOON?', 'Related Skills' sections entirely, and trim the Quick Reference to just the CLI examples and parameter list.

Add a validation step after skill generation (e.g., 'Verify: check that SKILL.md frontmatter is valid YAML and scripts are syntactically correct') to improve workflow clarity.

Move the template structure details, customization patterns, and workflow documentation into separate referenced files (e.g., TEMPLATES.md, CUSTOMIZATION.md) to improve progressive disclosure.

Remove redundant workflow sections — the TOON workflow information appears in three different places (Workflow Template Structure, Running a Workflow, Creating New Workflows) and should be consolidated into one brief section or external reference.

DimensionReasoningScore

Conciseness

Extremely verbose at ~300+ lines. Contains extensive sections that don't add actionable value: 'Design Philosophy' explaining generic principles, 'What is TOON?' explaining a format Claude doesn't need explained, 'Related Skills' listing dependencies without actionable guidance, emoji-laden capability lists, and redundant workflow sections. The 'Quick Reference' section alone restates information found throughout. Much content could be cut by 60%+ without losing utility.

1 / 3

Actionability

Provides concrete CLI commands with parameters and examples of expected output (including JSON), which is good. However, the actual generator script is not provided in the bundle, so we can't verify executability. The customization patterns show code snippets but they're fragments rather than complete executable examples. The generated script template structure is described abstractly (numbered list) rather than with actual template code.

2 / 3

Workflow Clarity

The 'Integration with Ecosystem' section provides a 4-step workflow (Generate → Implement → Create Workflows → Share), but lacks validation checkpoints. There's no step to verify the generated skill works correctly before proceeding. The troubleshooting section partially compensates but doesn't integrate into the workflow. For a generator that creates file structures, there should be explicit validation that generated files are correct before customization begins.

2 / 3

Progressive Disclosure

Monolithic wall of text with no references to external files despite the skill clearly warranting them. The template structure, design philosophy, TOON explanation, workflow documentation, and customization patterns could all be in separate referenced files. No bundle files are provided, yet the content references workflow/ directory files that don't exist. Everything is inlined into one massive document with poor information hierarchy.

1 / 3

Total

6

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
majiayu000/claude-skill-registry-data
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.