CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

Guide for creating effective skills. Use this skill when users need to create a new skill or reshape a draft skill package before hardening, benchmarking, or distribution.

50

Quality

54%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./Plugins/skill-factory/fixtures/budget-archive/2026-04-21/deferred-store/skills/scaffolding_templates/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 adequately covers both 'what' and 'when' with an explicit trigger clause, which is its strongest aspect. However, it lacks specificity in the concrete actions it performs (e.g., structuring frontmatter, writing descriptions, defining triggers) and could include more natural trigger terms users would actually say. The domain is moderately distinctive but could be sharpened.

Suggestions

Add specific concrete actions like 'structure YAML frontmatter, write skill descriptions, define trigger terms, organize markdown sections' to improve specificity.

Include more natural trigger term variations such as 'skill.md', 'skill file', 'skill template', 'write a skill', 'author a skill' to improve discoverability.

DimensionReasoningScore

Specificity

The description names the domain ('creating effective skills') and mentions some actions ('create a new skill', 'reshape a draft skill package'), but doesn't list specific concrete actions like 'write YAML frontmatter', 'define trigger terms', 'structure markdown sections', etc.

2 / 3

Completeness

The description answers both 'what' ('Guide for creating effective skills') and 'when' ('Use this skill when users need to create a new skill or reshape a draft skill package before hardening, benchmarking, or distribution') with an explicit 'Use this skill when...' clause.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'create a new skill', 'draft skill package', 'hardening', 'benchmarking', 'distribution', but misses common natural variations users might say such as 'write a skill', 'skill.md', 'skill template', 'skill file', or 'skill description'.

2 / 3

Distinctiveness Conflict Risk

The description is somewhat specific to skill creation, but 'creating effective skills' is somewhat vague and could overlap with general documentation or template-writing skills. The mention of 'hardening, benchmarking, or distribution' adds some distinctiveness but these terms are not strongly tied to a unique niche.

2 / 3

Total

9

/

12

Passed

Implementation

42%

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

This skill demonstrates strong progressive disclosure with well-signaled references and a clear organizational structure, but suffers from significant verbosity and redundancy. The philosophical and meta-guidance sections consume many tokens explaining concepts an agent already understands, while the actionable content (commands, output schemas) could be more concrete with actual examples of expected outputs.

Suggestions

Cut the Philosophy, Encouraging Variation, and Remember sections entirely—these are meta-guidance an agent doesn't need. Fold any unique constraints into the Procedure or Constraints sections.

Add a concrete example of the output contract JSON structure showing actual field values, rather than just listing field names.

Integrate validation checkpoints directly into the Procedure steps (e.g., 'After step 3, run quick_validate.py') rather than having a separate Validation section that must be cross-referenced.

Remove duplicate guidance about progressive disclosure and moving content to references/ which appears in at least 4 separate sections.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~200+ lines with significant redundancy. It explains meta-concepts like 'philosophy' and 'encouraging variation' that an agent already understands. Multiple sections repeat the same guidance (e.g., progressive disclosure is mentioned in Philosophy, Procedure, Anti-Patterns, and Constraints). The Table of Contents alone consumes tokens for a document that could be half its length.

1 / 3

Actionability

There are concrete executable commands (init_skill.py, quick_validate.py, generate_openai_yaml.py, validate_role.sh) which is good, but much of the content is abstract guidance rather than specific instructions. The output contract section lists field names without showing a concrete example of the expected JSON/YAML structure. The procedure steps mix actionable commands with vague directives like 'Clarify scope with concrete examples.'

2 / 3

Workflow Clarity

The Procedure section provides a numbered sequence and the Validation section includes a fail-fast policy with re-validation loops, which is good. However, the workflow is fragmented across multiple sections (Procedure, Validation, Agent Injection, Governance Spine) making the full sequence hard to follow. Validation checkpoints are mentioned but not integrated inline at each procedural step where they matter.

2 / 3

Progressive Disclosure

The skill excels at progressive disclosure with well-signaled 'Read when:' conditions for each reference file, clear one-level-deep references to foundations.md, creation-playbook.md, factory-governance-spine.md, etc. The References section is well-organized with explicit trigger conditions for when to consult each file.

3 / 3

Total

8

/

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

metadata_version

'metadata.version' is missing

Warning

Total

10

/

11

Passed

Repository
jscraik/Agent-Skills
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.