CtrlK
BlogDocsLog inGet started
Tessl Logo

fusion-skill-authoring

Creates or modernizes repository skills with clear activation cues, purposeful support files, and practical review loops. USE FOR: creating a new skill, tightening an existing skill, improving discovery wording, and structuring references/assets/optional helper agents when they genuinely add value. DO NOT USE FOR: product-code changes, routine copy edits outside skills/, or documentation that should not become an installable skill.

93

1.47x
Quality

Does it follow best practices?

Impact

99%

1.47x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

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.

A well-structured, actionable meta-skill with a clear sequenced workflow and effective one-level-deep progressive disclosure; its main weakness is modest redundancy between the step descriptions, the helper-agent section, and the core-behavior summary.

Suggestions

Remove the duplicate helper-agent descriptions: keep them in 'Optional helper agents' and have Step 6 reference that section, or vice versa, to eliminate the redundancy flagged in conciseness.

Consider folding 'Core behavior to preserve' into the relevant steps (or cutting it) since it restates principles already covered, to tighten token use.

Move the detailed inline 'Metadata and structure constraints' spec into references/ and keep only the highest-signal rules in the body, consistent with the skill's own progressive-disclosure guidance.

DimensionReasoningScore

Conciseness

The 269-line body is disciplined and avoids explaining concepts Claude already knows, but the four helper agents are described in both Step 6 and the 'Optional helper agents' section, and 'Core behavior to preserve' restates principles already embedded in the steps — material that could be tightened rather than the fully lean score-3 case.

2 / 3

Actionability

Provides concrete, executable guidance: precise naming rules (1-64 chars, lowercase/digits/hyphens, no consecutive hyphens), specific file paths (agents/scoper.md, references/skill-template-baseline.md), explicit metadata field constraints, and a copy-pasteable description example, matching the specific-instructions score-3 anchor for an instruction-only skill.

3 / 3

Workflow Clarity

A clear 7-step sequence with an explicit validation step (Step 6) and a fix -> re-run -> report feedback loop in references/validation-signals.md, plus a readiness checklist; validation checkpoints are explicit rather than implicit.

3 / 3

Progressive Disclosure

Heavy material is split into real, one-level-deep bundle files (verified: references/skill-template-baseline.md, references/validation-signals.md, references/skill-authoring-platform-references.md, assets/follow-up-questions.md, assets/skill-readiness-checklist.md all exist and do not nest further), each clearly signaled inline with 'See ... for ...'.

3 / 3

Total

11

/

12

Passed

Description

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.

A strong, third-person description that states concrete capabilities and pairs them with explicit USE FOR / DO NOT USE FOR triggers, giving clear routing signal and low conflict risk.

DimensionReasoningScore

Specificity

Lists multiple concrete actions ('Creates or modernizes repository skills with clear activation cues, purposeful support files, and practical review loops') plus a USE FOR list of distinct actions (creating, tightening, improving discovery wording, structuring references/assets), matching the score-3 anchor rather than the single-action score-2 example.

3 / 3

Completeness

Explicitly answers what ('Creates or modernizes repository skills...') and when via both USE FOR and DO NOT USE FOR cues, satisfying the 'clearly answers both what AND when with explicit triggers' anchor rather than the when-implied score-2 case.

3 / 3

Trigger Term Quality

Uses natural phrasings a user would actually say ('creating a new skill', 'tightening an existing skill', 'improving discovery wording', 'structuring references/assets'); these are common variations rather than jargon, fitting the good-coverage score-3 anchor.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche (authoring skills themselves) with explicit anti-triggers ('product-code changes, routine copy edits outside skills/, or documentation that should not become an installable skill') that suppress false positives, matching the distinct-trigger score-3 anchor.

3 / 3

Total

12

/

12

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

referenced_paths_exist

Referenced path issues: 2 missing, 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository
equinor/fusion-framework
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.