CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator-skill

Triggers when the user wants to create, edit, improve, or debug an OpenLoaf custom Skill. Typical phrasings: "help me create a skill", "build a new skill", "turn what we just did into a skill", "write a skill that auto-XX", "tweak this skill", "why isn't this skill triggering", "edit my custom skill", "add a global skill", "add a skill to the current project". Any create / modify / tune request touching a `SKILL.md` under `.openloaf/skills/` should load this skill. Also applies when the user wants to understand the skill format, troubleshoot triggering issues, or solidify a conversation workflow into a reusable capability. Not for: modifying built-in skills (e.g. file-ops, email-ops) — those are read-only capabilities shipped with the platform.

75

Quality

94%

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

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

A well-crafted instructional skill body: concrete paths, templates, decision trees, and an explicit verify-and-iterate loop make it immediately actionable, and the writing is lean and imperative. Remaining gains are minor: trim the tool-inventory/iron-rule redundancy and consider splitting reference-style material (troubleshooting, body-structure template) into a references file as the skill grows.

Suggestions

Cut the Tool Inventory table's 'always-available tools' repetitions and fold the Iron Rules summary into the sections that already state each rule, saving tokens without losing guidance.

Move the troubleshooting table and the recommended body-structure template into a references/ file (e.g. references/templates.md) to keep SKILL.md a lean overview as the skill grows.

DimensionReasoningScore

Conciseness

The body is dense and imperative with tables, decision trees, and templates instead of concept-teaching prose, with only minor over-explanation (the Tool Inventory table restates always-available tools, and the Iron Rules section repeats points already made in Scope/Step 1/description guidance). It fits anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') rather than 5, which would require every section to be non-redundant.

4 / 5

Actionability

Guidance is fully concrete: exact write paths per scope, Glob conflict-check patterns, exact questions to ask the user, a copy-ready openloaf.json example with the colorIndex palette, a SKILL.md template, and a symptom/cause/fix troubleshooting table. For an instruction-only skill this is copy-paste-ready and covers the common cases, matching anchor 5.

5 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced (understand requirements -> write SKILL.md -> openloaf.json -> save with Glob conflict check -> verify and iterate) with explicit validation checkpoints and a feedback loop ('If something's off, come back and edit SKILL.md, then open a new conversation and retry'). This matches anchor 5's clear sequence with validation and error-recovery loops.

5 / 5

Progressive Disclosure

The single-file structure is well organized with a clear section hierarchy and no nested or buried references, and at ~208 lines nothing urgently needs splitting. It sits at anchor 4 ('good structure; most content appropriately placed; minor organization gaps') rather than 5 because there are no well-signaled one-level-deep references, and sections like the troubleshooting table and recommended body-structure template are natural candidates for extraction as the skill grows.

4 / 5

Total

18

/

20

Passed

Description

96%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 trigger description: it names concrete capabilities, quotes many natural user phrasings including colloquial variants, explicitly separates what/when, and closes with a not-for boundary. The only weakness is that several broad phrasings are not tied to the OpenLoaf ecosystem, creating minor conflict risk with generic skill-authoring requests.

Suggestions

Qualify broad phrasings like 'turn what we just did into a skill' with the OpenLoaf context (e.g. 'turn what we just did into an OpenLoaf skill') to reduce overlap with other skill-creation tooling.

Tighten the middle sentences ('Any create / modify / tune request...' and 'Also applies when...') by merging overlapping trigger lists to cut verbosity without losing coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ('create, edit, improve, or debug an OpenLoaf custom Skill', 'understand the skill format, troubleshoot triggering issues, or solidify a conversation workflow into a reusable capability') with comprehensive coverage of its niche, matching the anchor-5 example's breadth. It is not score 4 because there are no meaningful coverage gaps within the skill-authoring domain.

5 / 5

Completeness

It explicitly answers both what ('create, edit, improve, or debug an OpenLoaf custom Skill') and when ('Triggers when the user wants to...', 'Typical phrasings: ...', 'Not for: modifying built-in skills') with concrete trigger phrases, in third-person voice. This matches the anchor-5 example structure exactly; score 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

It quotes natural phrasings users would actually say ('help me create a skill', 'tweak this skill', 'why isn't this skill triggering', 'turn what we just did into a skill') and includes the concrete path/file trigger 'a SKILL.md under .openloaf/skills/', giving comprehensive coverage including synonyms. Not score 4 because even colloquial variants and the path-based trigger are present.

5 / 5

Distinctiveness Conflict Risk

The niche is clear and the 'Not for: modifying built-in skills' clause draws an explicit boundary, but generic phrasings like 'turn what we just did into a skill' and 'write a skill' are not OpenLoaf-qualified and could overlap with skill-creation requests targeting other ecosystems. Minor overlap risk places it at anchor 4 rather than 5.

4 / 5

Total

19

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
itsablabla/openloaf-web
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.