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.

82

1.47x
Quality

73%

Does it follow best practices?

Impact

99%

1.47x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agents/skills/fusion-skill-authoring/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

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.

This is a strong description that clearly defines its scope with both positive (USE FOR) and negative (DO NOT USE FOR) trigger guidance, making it highly complete and distinctive. The main weakness is in trigger term quality — the language leans toward internal/technical jargon ('activation cues', 'review loops', 'discovery wording') rather than the natural phrases a user would type when requesting help with skills. The specificity of actions is good, listing multiple concrete tasks.

Suggestions

Add more natural user-facing trigger terms such as 'SKILL.md', 'write a skill', 'skill template', 'skill file', or 'how to make a skill' to improve discoverability from typical user queries.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: 'creates or modernizes repository skills', 'tightening an existing skill', 'improving discovery wording', 'structuring references/assets/optional helper agents'. These are specific, actionable capabilities.

3 / 3

Completeness

Clearly answers both 'what' (creates/modernizes skills with activation cues, support files, review loops) and 'when' with explicit USE FOR and DO NOT USE FOR clauses that provide clear trigger guidance and boundary conditions.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'skill', 'activation cues', 'discovery wording', 'support files', but misses natural user phrasings. Users might say 'write a skill', 'SKILL.md', 'skill file', or 'skill template' — these common variations are absent. The terms 'activation cues' and 'review loops' are more jargon than natural user language.

2 / 3

Distinctiveness Conflict Risk

The explicit DO NOT USE FOR clause (product-code changes, routine copy edits, non-skill documentation) combined with the specific domain of 'repository skills' creates a clear niche that is unlikely to conflict with other skills. The boundaries are well-defined.

3 / 3

Total

11

/

12

Passed

Implementation

62%

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

This is a well-structured meta-skill with a clear 7-step workflow, strong validation checkpoints, and thoughtful safety constraints. Its main weaknesses are verbosity (repeated information across sections, content that could be moved to references/) and lack of concrete executable examples — no sample frontmatter, no sample SKILL.md output, no actual commands to run. The progressive disclosure intent is good but the main file is heavy and bundle files aren't available to verify references.

Suggestions

Add a concrete, complete example of a minimal SKILL.md with frontmatter that could be copy-pasted as a starting point, rather than only describing the structure in prose.

Consolidate duplicate content: merge the 'Optional helper agents' section into Step 6's subagent guidance, and merge the standalone 'Expected output' section into Step 7 to reduce repetition.

Move the detailed 'Metadata and structure constraints' subsection to a references/ file (e.g., references/metadata-constraints.md) and summarize key rules inline to reduce SKILL.md length.

DimensionReasoningScore

Conciseness

The skill is well-structured but verbose for its purpose. Several sections repeat information (e.g., helper agents are described in Instructions Step 6, then again in 'Optional helper agents' section; expected output details appear in Step 7 and again in 'Expected output'). The metadata constraints section is thorough but lengthy, and some guidance (like explaining what capability uplift vs workflow means) could be tighter. However, it largely avoids explaining things Claude already knows.

2 / 3

Actionability

The skill provides a clear multi-step workflow with specific decision criteria and checklists, but lacks concrete executable examples. There are no actual code snippets, command examples, or sample SKILL.md frontmatter/content to copy-paste. The 'Examples' section shows input/output scenarios at a high level but doesn't include actual file content that would be produced. The metadata constraints section is specific but would benefit from a complete frontmatter example.

2 / 3

Workflow Clarity

The 7-step workflow is clearly sequenced with explicit validation checkpoints (Step 6), decision gates (Step 1 — decide if it should be a skill), and feedback loops (representative requests as acceptance criteria in Step 2, validation in Step 6, reporting in Step 7). The workflow includes clear go/no-go decisions and recovery guidance.

3 / 3

Progressive Disclosure

The skill references several supporting files (assets/follow-up-questions.md, references/skill-template-baseline.md, references/validation-signals.md, assets/skill-readiness-checklist.md, agents/*.md) which demonstrates good intent for progressive disclosure. However, no bundle files were provided, so these references are unverifiable. The main SKILL.md itself is quite long and could benefit from moving the detailed metadata constraints or the helper agents section to references/.

2 / 3

Total

9

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

10

/

11

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.