CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

Create new skills following the GBrain conformance standard. Generates SKILL.md with frontmatter, Contract, Phases, Output Format, and Anti-Patterns. Checks MECE against existing skills. Updates manifest and resolver.

64

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

87%

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 tight, actionable spec: concrete file paths, a runnable verification command, a copy-paste template, and well-organized sections with no token waste. The only gap is the lack of an explicit validate-fix-retry feedback loop in Phase 6, which leaves workflow clarity just below the top anchor for a mutating skill.

Suggestions

Add an explicit feedback loop to Phase 6: if 'bun test test/skills-conformance.test.ts' fails, review the failing assertions, fix the SKILL.md/manifest/resolver, and re-run until it passes — this closes the validate->fix->retry cycle for a mutating workflow.

Optionally note which conformance assertions are most commonly violated so failures are easier to triage on the first re-run.

DimensionReasoningScore

Conciseness

The body is lean — concise Contract bullets, terse numbered phases, a minimal embedded template, and brief Anti-Patterns — with no padding or explanation of concepts Claude already knows. Every section earns its place, matching the 3-anchor 'lean and efficient' profile. Not a 2 because there is no unnecessary explanation to trim.

3 / 3

Actionability

Provides concrete, executable guidance: specific file paths ('skills/manifest.json', 'skills/RESOLVER.md'), a runnable verification command ('bun test test/skills-conformance.test.ts'), and a complete copy-paste SKILL.md template with explicit section scaffolding. Not a 2 because the template and commands are directly usable rather than pseudocode or abstract direction.

3 / 3

Workflow Clarity

Six phases are clearly sequenced and Phase 6 provides an explicit verification step ('Run bun test ... to confirm the new skill passes'), but there is no feedback loop describing what to do when the conformance test fails (fix and re-run). For a mutating skill that creates and updates files, the missing error-recovery loop caps clarity at 2. Not a 1 because the sequence and a validation step are present; not a 3 because the validate->fix->retry loop is absent.

2 / 3

Progressive Disclosure

This is a short single-purpose skill with no bundle files (references/, scripts/, assets/ are absent) and no need for external references, yet it is well-organized into clear sections (Contract, Phases, Output Format, Anti-Patterns). Per the rubric's simple-skills note, this satisfies the 3 anchor. Not a 2 because organization is clean and nothing that should be offloaded is inline.

3 / 3

Total

11

/

12

Passed

Description

67%

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 is specific and distinctive, clearly enumerating the concrete actions and artifacts the skill produces, and occupies a well-defined niche. Its main weakness is the absence of an explicit 'Use when...' clause in the description, with the when-to-use signal relegated to the separate triggers field, which leaves completeness and trigger-term coverage slightly short of the top anchors.

Suggestions

Add an explicit 'Use when...' clause to the description (e.g., 'Use when the user asks to create, add, or improve a skill in the GBrain system') so the when-to-use is stated in the description itself, not only in triggers.

Broaden trigger coverage with natural variations such as 'make a skill', 'build a skill', and 'add a skill' alongside the existing phrases.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Generates SKILL.md with frontmatter, Contract, Phases, Output Format, and Anti-Patterns', 'Checks MECE against existing skills', 'Updates manifest and resolver' — matching the 3-anchor pattern of enumerating specific actions rather than vague phrasing. Not a 2 because it goes beyond naming a single domain action into a comprehensive action set.

3 / 3

Completeness

The 'what' is clearly answered (skill creation and the artifacts it produces), but there is no 'Use when...' clause or explicit when-to-use guidance woven into the description — the 'when' lives only in the separate triggers field. Per the rubric guideline, a missing 'Use when...' clause caps completeness at 2; not a 1 because the what is strong and triggers provide some when guidance.

2 / 3

Trigger Term Quality

Triggers 'create a skill', 'new skill', 'improve this skill' are natural user phrases, but common variations like 'make a skill', 'build a skill', or 'add a skill' are missing. Not a 3 due to incomplete coverage of natural variations; not a 1 because the terms present are genuinely what a user would say.

2 / 3

Distinctiveness Conflict Risk

Targets a clear, narrow niche — authoring GBrain skills ('Create new skills following the GBrain conformance standard') with distinct creation-oriented triggers — making it unlikely to fire for unrelated skills. Not a 2 because the meta-skill scope is unambiguous rather than overlapping with general document/code skills.

3 / 3

Total

10

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
garrytan/gbrain
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.