CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends AIPex's capabilities with specialized knowledge, workflows, or tool integrations.

69

Quality

85%

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%

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

The body is a well-structured, highly actionable meta-skill with clear sequencing, an explicit validation feedback loop, and properly bundled one-level-deep scripts. Its main weakness is conciseness: a conceptual intro and inlined API docs could be trimmed to better respect the context budget.

Suggestions

Trim the conceptual 'About Skills' / 'What Skills Provide' sections, which restate general knowledge Claude already has, down to the non-obvious essentials (the anatomy diagram and progressive-disclosure principle).

Move the full writeFile/deleteFile parameter and return documentation into a short references/ file (e.g. references/api.md), keeping only the function signatures and a one-line purpose inline in SKILL.md.

Tighten the 'Skill Creation Process' steps by converting explanatory prose into imperative checklists so each line is an actionable instruction rather than narrative.

DimensionReasoningScore

Conciseness

The ~275-line body is mostly efficient, but the conceptual "About Skills" / "What Skills Provide" intro and the fully inlined writeFile/deleteFile parameter documentation assume some context Claude already has and could be tightened. It is not level 3 because not every token earns its place, and not level 1 because the bulk is actionable rather than padded with general concept explanations.

2 / 3

Actionability

Provides fully executable, copy-paste-ready signatures for initSkill, writeFile, deleteFile, packageSkill, and validateSkill with concrete parameters and return shapes, all backed by real bundled scripts. It is not level 2 because the guidance is complete and executable rather than pseudocode or missing key details.

3 / 3

Workflow Clarity

A clearly sequenced six-step creation process with an explicit validation feedback loop in Step 5 ("If validation fails... Fix any validation errors and run the packaging function again") and an iteration loop in Step 6. It is not level 2 because validation checkpoints are explicit, not implicit.

3 / 3

Progressive Disclosure

The body serves as an overview while the actual code lives one level deep in real bundled scripts (init_skill.js, write_file.js, delete_file.js, package_skill.js, quick_validate.js) that are clearly signaled and referenced; there is no nested-reference chaining. It is not level 2 because content is appropriately split into scripts rather than inlined as a monolithic wall, and not lower because navigation is straightforward.

3 / 3

Total

11

/

12

Passed

Description

85%

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 clearly and concisely states both what the skill does and when to use it, in proper third-person voice with explicit trigger guidance. Its only weakness is narrow trigger-term variation, which slightly limits how many natural phrasings would surface it.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "create a new skill (or update an existing skill)" that "extends AIPex's capabilities with specialized knowledge, workflows, or tool integrations" — matching the level-3 anchor of multiple specific concrete actions. It is not level 2 because it goes beyond naming only a domain and partial actions.

3 / 3

Completeness

Explicitly answers both what ("Guide for creating effective skills") and when ("This skill should be used when users want to create a new skill (or update an existing skill)...") using third-person voice with an explicit trigger clause. It is not level 2 because the 'when' is stated explicitly rather than merely implied.

3 / 3

Trigger Term Quality

Includes natural phrasing a user would say ("when users want to create a new skill (or update an existing skill)"), but offers only two surface verbs (create/update) and misses common variations like "build", "make", or "design a skill". It falls short of level 3's broad coverage of natural terms.

2 / 3

Distinctiveness Conflict Risk

Occupies a clear niche (skill authoring/meta-creation) with distinct triggers unlikely to overlap with task-specific skills. It is not level 2 because the trigger ('create/update a skill') is specific enough to avoid conflicting with other skills.

3 / 3

Total

11

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 12 missing

Warning

Total

15

/

16

Passed

Repository
AIPexStudio/AIPex
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.