CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-authoring

Creates and structures SKILL.md files for AI coding agents, including YAML frontmatter, trigger phrases, directive instructions, decision trees, code examples, and verification checklists. Use when the user asks to write a new skill, create a skill file, author agent capabilities, generate skill documentation, or define a skill template for Claude Code agents.

Install with Tessl CLI

npx tessl i github:rohitg00/skillkit --skill skill-authoring
What are skills?

93

Does it follow best practices?

Validation for skill structure

SKILL.md
Review
Evals

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an exemplary skill description that hits all the marks. It provides specific concrete actions, includes a comprehensive 'Use when...' clause with natural trigger terms, and carves out a distinct niche that won't conflict with other skills. The third-person voice is used correctly throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Creates and structures SKILL.md files', 'YAML frontmatter', 'trigger phrases', 'directive instructions', 'decision trees', 'code examples', and 'verification checklists'.

3 / 3

Completeness

Clearly answers both what (creates SKILL.md files with specific components) AND when (explicit 'Use when...' clause with multiple trigger scenarios).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'write a new skill', 'create a skill file', 'author agent capabilities', 'generate skill documentation', 'define a skill template', 'Claude Code agents'.

3 / 3

Distinctiveness Conflict Risk

Very specific niche targeting SKILL.md files for AI coding agents with distinct triggers like 'skill file', 'skill template', 'Claude Code agents' - unlikely to conflict with general documentation or coding skills.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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

This is a well-structured meta-skill that provides comprehensive, actionable guidance for authoring SKILL.md files. Its strengths are clear workflow, concrete examples, and good use of tables and checklists. Minor weakness is some verbosity in explaining concepts Claude likely already understands (voice/tone basics, what semantic versioning is).

Suggestions

Trim the 'Voice and Tone' section—Claude understands second person and active voice; just show the examples without explanation

Remove the semantic version explanation in the Maintenance section; Claude knows semver conventions

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some content Claude already knows (e.g., explaining what second person/active voice means, basic markdown structure). The tables and examples add value but some sections like 'Voice and Tone' could be trimmed.

2 / 3

Actionability

Provides concrete, executable guidance with specific examples throughout: exact frontmatter format, code block templates, decision tree patterns, and copy-paste ready structures. The anti-patterns table and checklists give clear, actionable criteria.

3 / 3

Workflow Clarity

Clear sequential process from anatomy through writing to testing and publication. The publication checklist provides explicit validation steps, and the skill testing section defines verification criteria. The flow from structure → content → testing → maintenance is logical and complete.

3 / 3

Progressive Disclosure

Well-organized with clear section headers and appropriate references to external files (PACKS.md, MAINTENANCE.md) for detailed information. Content is appropriately split—overview stays in this file while detailed policies are referenced one level deep.

3 / 3

Total

11

/

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

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.