CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

Create or update AgentSkills, especially when a user wants the agent to learn a reusable capability, workflow, integration, domain rule, team process, or tool usage pattern for future tasks. Use when designing, structuring, reviewing, validating, packaging, or improving skills with SKILL.md, scripts, references, and assets.

59

Quality

67%

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 ./openclaw/skills/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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 a strong description that clearly defines a meta-skill for creating and managing agent skills. It effectively communicates both what it does and when to use it, with specific artifacts (SKILL.md, scripts, references, assets) and a comprehensive list of trigger scenarios. The description uses proper third-person voice and covers natural user language well.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Create or update AgentSkills', 'designing, structuring, reviewing, validating, packaging, or improving skills'. Also specifies concrete artifacts: 'SKILL.md, scripts, references, and assets'.

3 / 3

Completeness

Clearly answers both 'what' (create or update AgentSkills with SKILL.md, scripts, references, and assets) and 'when' (explicit 'Use when designing, structuring, reviewing, validating, packaging, or improving skills' plus the 'especially when' clause covering user intent scenarios).

3 / 3

Trigger Term Quality

Includes strong natural trigger terms users would say: 'learn a reusable capability', 'workflow', 'integration', 'domain rule', 'team process', 'tool usage pattern', 'SKILL.md', 'skills'. These cover a wide range of how users might phrase requests about teaching the agent new skills.

3 / 3

Distinctiveness Conflict Risk

This is a clearly distinct meta-skill about creating skills themselves. The triggers like 'AgentSkills', 'SKILL.md', 'reusable capability', and 'skill' creation/packaging are highly specific and unlikely to conflict with other task-oriented skills.

3 / 3

Total

12

/

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 is a comprehensive meta-skill for creating skills, but it suffers significantly from verbosity—it explains many concepts Claude already understands (what scripts are, what assets are, basic file organization) and includes extensive examples that could live in reference files. The actionable parts (init_skill.py, package_skill.py commands, the 6-step workflow) are solid but buried in explanatory prose. The skill ironically violates its own 'Concise is Key' principle.

Suggestions

Reduce the body by 50%+ by removing explanations of concepts Claude already knows (what skills provide, what PDFs are, what scripts/references/assets mean) and moving detailed examples and patterns into reference files like references/skill-patterns.md

Add concrete validation checkpoints in Step 4 (e.g., 'Verify SKILL.md is under 500 lines', 'Confirm all referenced files exist', 'Test at least one script') rather than deferring all validation to Step 5's packaging script

Replace abstract writing guidance ('Include information that would be beneficial and non-obvious') with a concrete checklist or template showing exactly what a good SKILL.md body contains, with a minimal worked example

Practice the progressive disclosure the skill preaches: move the 'About Skills' section, naming conventions, progressive disclosure patterns, and bundled resource details into reference files, keeping only the 6-step workflow and essential constraints in SKILL.md

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines, with significant portions explaining concepts Claude already knows (what skills are, what PDFs are, what scripts/references/assets mean conceptually). Sections like 'What Skills Provide', 'About Skills', and extensive explanations of directory structures and file types add token cost without proportional value. Many paragraphs could be reduced to single sentences.

1 / 3

Actionability

The skill provides concrete commands for init_skill.py and package_skill.py with executable examples, and the 6-step process is reasonably specific. However, much of the guidance remains abstract ('Write instructions for using the skill', 'Include information that would be beneficial and non-obvious') and the SKILL.md writing section lacks concrete before/after examples of good vs bad skill content.

2 / 3

Workflow Clarity

The 6-step creation process is clearly sequenced and each step has skip conditions. However, validation is only mentioned at the packaging step (Step 5), and there are no explicit validation checkpoints during the critical Step 4 (editing). The iteration step (Step 6) lacks concrete validation criteria. Missing feedback loops during content creation caps this at 2.

2 / 3

Progressive Disclosure

The skill references external files (references/workflows.md, references/output-patterns.md) and uses clear section headers. However, a massive amount of content that could be in reference files is inline in SKILL.md—the entire 'About Skills' section, progressive disclosure patterns with examples, naming conventions, and detailed bundled resource explanations could all be split out. The skill teaches progressive disclosure but doesn't fully practice it.

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
trpc-group/trpc-agent-go
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.