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.

76

1.25x
Quality

78%

Does it follow best practices?

Impact

59%

1.25x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

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

The body is a well-sequenced, highly actionable authoring workflow with genuinely strong validation loops, but it is padded with duplicated helper-agent descriptions and a recap section, and its progressive-disclosure contract is undermined by four dangling agents/ references and one orphaned, unreferenced reference file. Fixing the bundle/navigation mismatch would raise both conciseness and progressive_disclosure.

Suggestions

Resolve the agents/ mismatch: either add the four agents/scoper.md, agents/reviewer.md, agents/trigger-tuner.md, and agents/devils-advocate.md files to the bundle, or drop the file paths from Step 7 and 'Optional helper agents' and describe the roles inline only (progressive_disclosure, actionability).

Delete or reference references/skill-authoring-platform-references.md — it exists in the bundle but is never mentioned in SKILL.md, so it is undiscoverable (progressive_disclosure).

Remove the duplicated helper-agent listing (keep it in one place) and the 'Core behavior to preserve' recap section to get comfortably under the skill's own 300-line limit (conciseness).

DimensionReasoningScore

Conciseness

The body is mostly directive and assumes competence (no explaining of basics), but it carries real redundancy: the four helper agents are described twice with overlapping wording (Step 7 and 'Optional helper agents'), and 'Core behavior to preserve' recaps rules already stated in the steps. At 300 lines it sits right at its own stated limit, so trimming this duplication would be easy — this matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 4, where over-explanation would be only minor.

3 / 5

Actionability

Guidance is largely concrete and executable: exact naming constraints ('1-64 characters, lowercase letters/numbers/hyphens only...'), a copy-paste example description string, hard line limits ('Keep under 300 lines... over 500 lines fail CI'), and a stepwise authoring procedure. It falls short of 5 because some instructions are abstract ('Prefer deterministic validation loops over hand-wavy advice') and Step 7 directs the agent to invoke 'agents/scoper.md', 'agents/reviewer.md', 'agents/trigger-tuner.md', and 'agents/devils-advocate.md' — files that do not exist in this bundle, so those instructions cannot be executed as written.

4 / 5

Workflow Clarity

Eight clearly sequenced steps with explicit validation checkpoints: representative requests captured as acceptance criteria before drafting (Step 3), structure selection rules (Step 4), a dedicated validation step with a no-tooling fallback that re-verifies every referenced path (Step 7), and a reporting contract (Step 8). Error-recovery signals are delegated to references/validation-signals.md. This matches anchor 5: clear sequence, explicit validation, feedback loops.

5 / 5

Progressive Disclosure

The referenced files that exist are real and clearly signaled one level deep ('See references/skill-template-baseline.md', 'Use assets/follow-up-questions.md as the default question bank'), and SKILL.md is well sectioned. However, scored against the actual bundle: four referenced paths (agents/scoper.md, agents/reviewer.md, agents/trigger-tuner.md, agents/devils-advocate.md) do not exist, and references/skill-authoring-platform-references.md is present but never referenced from the body — navigation is partly broken in both directions. That is more than the 'minor organization gaps' of anchor 4 and matches anchor 3 ('some structure but could be better organized').

3 / 5

Total

15

/

20

Passed

Description

87%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 description: third-person, concrete about what it does, with explicit USE FOR / DO NOT USE FOR boundary cues that make discovery reliable and minimize conflicts with adjacent skills. Minor room to add natural synonyms like 'scaffold', 'skill authoring', or 'frontmatter' to the trigger terms.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Creates or modernizes repository skills', 'clear activation cues, purposeful support files, and practical review loops', 'improving discovery wording', and 'structuring references/assets' — though 'creates or modernizes' stays at a higher altitude than e.g. scaffolding SKILL.md or writing frontmatter. It matches anchor 4 ('lists several specific actions; minor gaps in coverage') rather than 5, which would require fully comprehensive concrete action coverage.

4 / 5

Completeness

It explicitly answers both 'what' ('Creates or modernizes repository skills with clear activation cues, purposeful support files, and practical review loops') and 'when' via explicit 'USE FOR:' and 'DO NOT USE FOR:' clauses with concrete trigger phrases. This matches the anchor-5 example structure exactly; not 4 because the 'when' guidance is fully explicit, not merely present.

5 / 5

Trigger Term Quality

'creating a new skill', 'tightening an existing skill', 'improving discovery wording', 'structuring references/assets', and anti-triggers like 'product-code changes' and 'routine copy edits' are natural phrases users would say. It falls just short of anchor 5 because common variations such as 'scaffold', 'SKILL.md', 'frontmatter', or 'skill authoring' are absent.

4 / 5

Distinctiveness Conflict Risk

The skill-authoring niche is clear and the explicit exclusion list ('DO NOT USE FOR: product-code changes, routine copy edits outside skills/') sharply reduces overlap with general coding or documentation skills. Minimal conflict risk, matching anchor 5.

5 / 5

Total

18

/

20

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.

Validation — 14 / 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.