CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

command-development

This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.

68

Quality

85%

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

71%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 highly actionable, well-sequenced reference whose examples are uniformly executable, but it is too long and padded for a SKILL.md body and its bundle is poorly wired: most reference files are orphaned and one link points at a nonexistent directory. Tightening the body and linking the full reference set would move it toward top marks.

Suggestions

Trim boilerplate Claude already knows — the 'What is a Slash Command?' explanation, the Reusability/Consistency/Sharing/Efficiency bullet lists, and the repeated generic 'Benefits:'/'Key points:'/'Why use it:' blocks — to tighten conciseness.

Link the five orphaned reference files (advanced-workflows.md, documentation-patterns.md, interactive-commands.md, marketplace-considerations.md, testing-strategies.md) from SKILL.md so they are discoverable, and remove or create the referenced `examples/` directory.

Move detailed inline material (e.g., Plugin-Specific Features patterns, Validation Patterns) into the existing references and keep SKILL.md as a lean overview, reducing duplication with references/plugin-features-reference.md.

DimensionReasoningScore

Conciseness

The ~830-line body is mostly useful domain specifics (frontmatter fields, $1/$2 argument expansion, !`bash` execution, ${CLAUDE_PLUGIN_ROOT}) but repeatedly pads with concepts Claude already knows — 'A slash command is a Markdown file containing a prompt', 'Reusability: Define once, use repeatedly', 'Efficiency: Quick access to complex prompts' — and recurring generic 'Benefits:', 'Key points:', 'Why use it:' bullet lists that could be trimmed. Not a 2 because the bulk is non-obvious product-specific detail, not generic filler.

3 / 5

Actionability

Nearly every section gives copy-paste-ready material: complete YAML frontmatter blocks (description, allowed-tools with Bash(git:*) patterns, argument-hint), executable command templates with $ARGUMENTS/$1/$2 expansion, working !`git diff --name-only` and !`gh pr view $1` snippets, and concrete validation examples like !`test -f $1 && echo "EXISTS" || echo "MISSING"` covering the common cases.

5 / 5

Workflow Clarity

Content flows in a clear logical sequence (basics → file format → frontmatter → dynamic arguments → file references → bash execution → organization → patterns → troubleshooting), and the Validation Patterns and Error Handling sections show explicit validate-then-branch feedback loops. Not a 5 because the core 'how to build a command' path is presented as reference sections rather than one end-to-end sequenced workflow with checkpoints.

4 / 5

Progressive Disclosure

References exist and the two that are linked (frontmatter-reference.md, plugin-features-reference.md) are clearly signaled, but the body inlines ~830 lines of detail that belongs in those files, links to an `examples/` directory that does not exist in the bundle, and leaves 5 of 7 reference files (advanced-workflows, documentation-patterns, interactive-commands, marketplace-considerations, testing-strategies) completely unmentioned and undiscoverable — more than the 'minor organization gaps' of the level-4 anchor.

3 / 5

Total

15

/

20

Passed

Description

95%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 strong description with comprehensive, natural trigger terms, an explicit use-when clause, and a clearly distinct niche in third-person voice. Its only weakness is that capabilities are expressed through user trigger phrases rather than as direct statements of what the skill does.

DimensionReasoningScore

Specificity

The description lists several specific concrete phrases ('create a slash command', 'define command arguments', 'use command frontmatter', 'organize commands', 'use AskUserQuestion in command'), but the skill's own capabilities are only framed as 'needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments...' rather than stated as actions, leaving minor gaps versus the comprehensive anchor.

4 / 5

Completeness

It explicitly answers 'when' with concrete trigger phrases ('This skill should be used when the user asks to...') and answers 'what' with 'guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code'.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive with natural synonyms users would actually say: 'create a slash command', 'add a command', 'write a custom command', 'organize commands', 'interactive command', plus domain vocabulary like 'YAML frontmatter fields', 'dynamic arguments', 'bash execution in commands'.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Claude Code slash command development) with distinct, specific triggers ('slash command', 'command frontmatter', 'AskUserQuestion in command') that are unlikely to fire for unrelated skills.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (836 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

Galaxy-Dawn/claude-scholar

Path

skills/command-development/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.