CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

81

1.26x
Quality

86%

Does it follow best practices?

Impact

100%

1.26x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%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-structured authoring workflow with explicit sequencing, validation gates, safety constraints, and strong progressive disclosure of long material into references/ and assets/. The main deductions are moderate redundancy across steps and helper-agent sections, conditional rather than concrete validation commands, and agent-file references pointing at files absent from the bundle.

Suggestions

Merge the folder-structure guidance in Step 4 and Step 6 into a single list, and fold the 'Optional helper agents' section into Step 7's subagent guidance to eliminate duplicate coverage and trim tokens.

Ship the four referenced agents/*.md files (scoper, reviewer, trigger-tuner, devils-advocate) or drop the file-level references and keep only the inline role descriptions, so every referenced path resolves in the bundle as Step 7 itself requires.

Add one or two concrete example validation commands (e.g., a representative catalog schema-validation invocation) to Step 7 so the validation step is executable rather than conditional in catalog-equipped repositories.

DimensionReasoningScore

Conciseness

The body is dense and imperative throughout, assumes competence, and never explains basics Claude already knows, but has minor trims available: Step 4's folder-structure purposes are re-listed in Step 6, the "Optional helper agents" section duplicates the agent roles already given in Step 7, and "Core behavior to preserve" restates earlier steps. These repetitions are over-explanation instances that keep it below the lean score-5 anchor, while the mostly-tight bullets place it above the noticeably-verbose score-3 anchor.

4 / 5

Actionability

Mostly executable guidance: concrete constraints ("1-64 characters, lowercase letters/numbers/hyphens only", "default new skills to `custom-<base-skill-name>`", "<= 1024 chars"), a copy-paste-ready description example, and specific acceptance-criteria and validation loops. It stays at 4 rather than 5 because some guidance is conditional and abstract ("inventory or schema validation for the skill catalog, if available" names no concrete commands), and at 4 rather than 3 because the metadata rules, example description, and checklist loops are directly actionable.

4 / 5

Workflow Clarity

Eight clearly sequenced steps with explicit validation (Step 7: run catalog validation, read every referenced file end-to-end, verify each representative request), feedback loops for error recovery (re-validate on failure, "If validation fails" style guidance, plus references/validation-signals.md for failure signals and recovery steps), a readiness checklist, and decision branches for the installed-copy case. This matches the top anchor: clear sequence, explicit validation steps, and recovery guidance.

5 / 5

Progressive Disclosure

Good structure with clearly signaled, one-level-deep references (references/skill-authoring-platform-references.md, references/skill-template-baseline.md, references/validation-signals.md, assets/follow-up-questions.md, assets/skill-readiness-checklist.md — all of which exist in the bundle) and heavy content correctly offloaded from SKILL.md. Not score 5 because the body references `agents/scoper.md`, `agents/reviewer.md`, `agents/trigger-tuner.md`, and `agents/devils-advocate.md`, but no agents/ directory ships in the bundle — a minor organization gap, though the roles are also described inline as fallback.

4 / 5

Total

17

/

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, third-person description that explicitly states what the skill does, when to use it via a concrete USE FOR clause, and when not to via a DO NOT USE FOR clause. Trigger phrasing is natural and boundaries are explicit; only minor keyword synonyms and action-depth gaps keep specificity and trigger term quality from the top anchor.

DimensionReasoningScore

Specificity

"Creates or modernizes repository skills with clear activation cues, purposeful support files, and practical review loops" plus "tightening an existing skill, improving discovery wording, and structuring references/assets/optional helper agents" lists several specific actions, but coverage stays at the framing level with minor gaps (no mention of scaffolding mechanics or validation specifics). It lists more than the 1-2 concrete actions of a score-3 anchor, but is not the comprehensive action enumeration of a 5.

4 / 5

Completeness

Clearly and explicitly answers both: the "what" ("Creates or modernizes repository skills with clear activation cues, purposeful support files, and practical review loops") and the "when" ("USE FOR: creating a new skill, tightening an existing skill, improving discovery wording, and structuring references/assets/optional helper agents"), with a concrete "DO NOT USE FOR" clause as bonus boundary guidance. This matches the score-5 anchor with concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes natural phrases a user would say such as "creating a new skill", "tightening an existing skill", and "improving discovery wording", giving good keyword coverage, but misses common variations like "scaffold a skill", "skill authoring", or "turn this workflow into a reusable skill" (which appear in the body but not the description). Not score 5 because synonyms and alternate user phrasings are incomplete; not 3 because the phrases present are genuinely natural rather than generic.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (skill authoring within a skills catalog) with distinct triggers, and the explicit "DO NOT USE FOR: product-code changes, routine copy edits outside skills/, or documentation that should not become an installable skill" clause minimizes conflict risk with adjacent documentation or code-review skills.

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

Path

.agents/skills/fusion-skill-authoring/SKILL.md

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.