CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.

61

Quality

51%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

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 functional and covers both what and when, earning good marks on completeness. However, it lacks concrete specificity about what creating/updating an AgentSkill actually entails (e.g., YAML frontmatter, markdown structure, file organization), and the trigger terms could be more natural and varied to help Claude distinguish this skill from general project scaffolding or documentation tasks.

Suggestions

Add more concrete actions like 'write YAML frontmatter, generate script files, organize asset directories, define skill metadata'

Include more natural trigger terms users might say, such as 'SKILL.md', 'skill template', 'new skill file', 'skill definition', or 'skill configuration'

DimensionReasoningScore

Specificity

Names the domain ('AgentSkills') and some actions ('create or update', 'designing, structuring, packaging'), but doesn't list concrete specific actions like 'write YAML frontmatter', 'generate script files', or 'organize asset directories'.

2 / 3

Completeness

Clearly answers both 'what' (create or update AgentSkills with scripts, references, and assets) and 'when' (explicit 'Use when designing, structuring, or packaging skills').

3 / 3

Trigger Term Quality

Includes some relevant terms like 'skills', 'scripts', 'references', 'assets', 'packaging', but misses natural user phrases like 'skill file', 'SKILL.md', 'skill template', 'new skill', or 'skill definition'. 'AgentSkills' is a specific term but may not be what users naturally say.

2 / 3

Distinctiveness Conflict Risk

The term 'AgentSkills' provides some distinctiveness, but 'scripts, references, and assets' is broad enough to potentially overlap with general project scaffolding or documentation skills. The word 'skills' alone could conflict with other skill-related tools.

2 / 3

Total

9

/

12

Passed

Implementation

35%

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

This skill provides a comprehensive guide to skill creation with a clear 6-step process and concrete CLI commands, but suffers significantly from verbosity—it explains many concepts Claude already knows (what skills are, what scripts/references/assets mean, metaphors about bridges and fields). The irony is that a skill about conciseness is itself not concise. The actionability is moderate: while init/package commands are concrete, the actual SKILL.md writing guidance is abstract and would benefit from more concrete before/after examples.

Suggestions

Cut the 'About Skills' and 'What Skills Provide' sections entirely—Claude already knows what skills are. Start directly with 'Core Principles' or even the creation process.

Remove the 'degrees of freedom' bridge/field metaphor and replace with a concise table mapping task characteristics to freedom levels with one-line examples.

Add a concrete, complete example of a well-written SKILL.md body (not just frontmatter) in Step 4 to make the writing guidance actionable rather than abstract.

Move the 'Progressive Disclosure Design Principle' patterns and 'Anatomy of a Skill' detailed breakdowns into a references/ file, practicing what the skill preaches about keeping SKILL.md lean.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~300+ lines, with extensive explanations of concepts Claude already understands (what skills are, what PDFs are, what scripts/references/assets mean). Sections like 'What Skills Provide' and 'About Skills' explain obvious concepts. The 'degrees of freedom' metaphor with bridge/field analogy is unnecessary padding. Much of this could be cut by 60%+ while preserving all actionable content.

1 / 3

Actionability

The skill provides concrete commands for init_skill.py and package_skill.py with real CLI examples, and the 6-step process is specific. However, the SKILL.md body writing guidance is mostly abstract ('Write instructions for using the skill'), the frontmatter section gives only one example description, and there are no concrete examples of what a good SKILL.md body looks like end-to-end. References to workflows.md and output-patterns.md add actionability but are external.

2 / 3

Workflow Clarity

The 6-step creation process is clearly sequenced and each step has reasonable detail. However, validation is only mentioned as part of the packaging step (Step 5) rather than as explicit checkpoints throughout. There's no feedback loop for testing SKILL.md content quality before packaging, and Step 4 (Edit the Skill) lacks validation checkpoints for scripts beyond 'must be tested by actually running them.'

2 / 3

Progressive Disclosure

The skill references external files (references/workflows.md, references/output-patterns.md) and mentions init_skill.py and package_skill.py scripts, which is good progressive disclosure. However, the SKILL.md itself is monolithic with extensive inline content that could be split out (e.g., the entire 'Progressive Disclosure Design Principle' section with its patterns, the 'Anatomy of a Skill' section). The skill teaches progressive disclosure but doesn't practice it well itself.

2 / 3

Total

7

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
deepgram/dglabs-deepclaw
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.