CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

68

Quality

86%

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

85%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.

An exceptionally actionable, well-sequenced skill-authoring guide with real validation feedback loops and copy-paste commands that match the bundled scripts. Its one significant defect is progressive disclosure: both reference-file pointers in Step 4 are dead links, so a reader following them finds nothing. Secondary cost is mild verbosity in the worked examples.

Suggestions

Add the missing references/workflows.md and references/output-patterns.md files (or remove the pointers from Step 4), since both links are currently dead.

Trim one or two of the four parallel Step-2 worked examples and condense the three progressive-disclosure pattern examples to reclaim tokens without losing guidance.

Delete the redundant opener 'This skill provides guidance for creating effective skills.' and the 'About Skills' framing that restates what the frontmatter already establishes.

DimensionReasoningScore

Conciseness

The body is dense with operational guidance and mostly assumes competence — no 'what is a PDF' style padding — but has trimmable fat: three full progressive-disclosure pattern examples with directory trees, four parallel Step-2 worked examples, and a redundant opening line ("This skill provides guidance for creating effective skills"). This matches anchor 4 (minor instances of over-explanation); anchor 3 would require noticeably more unnecessary explanation.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with examples: "scripts/init_skill.py my-skill --path skills/public --resources scripts,references" and "scripts/package_skill.py <path/to/skill-folder> ./dist" (both verified to exist in scripts/ with matching usage), plus concrete user-question scripts for Step 1 and explicit naming rules ("lowercase letters, digits, and hyphens only", "under 64 characters"). Matches anchor 5: specific examples cover the common cases.

5 / 5

Workflow Clarity

The six-step process is clearly sequenced ("Follow these steps in order, skipping only if there is a clear reason why they are not applicable") with explicit per-step skip conditions, a validation checkpoint in Step 5 (package_skill.py validates first; "If validation fails ... Fix any validation errors and run the packaging command again"), and an iterate/feedback loop in Step 6. Matches anchor 5: explicit validation steps and error-recovery feedback loops.

5 / 5

Progressive Disclosure

The body is well-structured and preaches one-level-deep references, but its two operational reference pointers are dangling: "See references/workflows.md" and "See references/output-patterns.md" (lines 350-351) point to files that do not exist — the bundle has no references/ directory at all. This is below anchor 4 ('references mostly clear', which presumes they resolve) and sits at anchor 3: structure is present but navigation is broken, leaving design-pattern guidance unavailable.

3 / 5

Total

17

/

20

Passed

Description

83%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 an explicit, well-enumerated 'Use when' clause and concrete artifact-level terminology. It is clearly distinguishable as the meta-skill for authoring skills. Minor gaps: it omits common synonyms (skill bundle, frontmatter, .skill package) that would round out trigger coverage.

Suggestions

Add high-value domain synonyms users naturally say, e.g. "skill bundle", "frontmatter", or ".skill file", to the trigger clause.

Tighten the trigger verbs ("designing, structuring, reviewing, validating") with "skills" qualification to reduce overlap with generic design/code-review requests.

Mention the description/frontmatter trigger-writing capability explicitly, since that is a core use of this skill but is only implied.

DimensionReasoningScore

Specificity

"Create or update AgentSkills" names the domain, and the trigger clause enumerates several concrete actions — "designing, structuring, reviewing, validating, packaging, or improving skills" — plus the concrete artifact terms "SKILL.md, scripts, references, and assets". It falls between anchor 3 (1-2 actions) and anchor 5 (fully comprehensive, e.g. listing the frontmatter fields or trigger-writing itself), matching anchor 4: several specific actions with minor coverage gaps.

4 / 5

Completeness

It explicitly answers both questions: what ("Create or update AgentSkills ... learn a reusable capability, workflow, integration, domain rule, team process, or tool usage pattern for future tasks") and when ("Use when designing, structuring, reviewing, validating, packaging, or improving skills with SKILL.md, scripts, references, and assets") with concrete trigger phrases. This matches anchor 5 exactly; anchor 4's 'when could be more explicit' does not apply since the Use-when clause is fully enumerated.

5 / 5

Trigger Term Quality

Natural trigger phrases a user would say are present — "create or update" a skill, "reusable capability, workflow, integration, domain rule, team process", and file-level terms "SKILL.md, scripts, references, and assets". Below anchor 5 because common synonyms and variants are missing, e.g. "skill bundle", "frontmatter", "description/trigger", or ".skill package", which users of this domain would plausibly mention.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — creating/updating AgentSkills as bundles ("SKILL.md, scripts, references, and assets"), which is distinct from ordinary coding or document skills, matching anchor 4. Not anchor 5 because generic verbs in the trigger clause ("designing, structuring, reviewing, validating") could pull this in for ordinary design/code-review requests not about skills.

4 / 5

Total

17

/

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

relative_links

Relative link issues: 6 missing

Warning

referenced_paths_exist

Referenced path issues: 15 missing

Warning

Total

14

/

16

Passed

Repository

trpc-group/trpc-agent-go

Path

openclaw/skills/skill-creator/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.