CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fusion-issue-authoring

Classify issue type, activate the matching agent mode for type-specific drafting, and enforce shared safety gates before GitHub mutation.

53

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

62%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 presents a well-sequenced, checkpoint-rich workflow with concrete MCP tool names, ordered mutations, and real reference/asset files for deferred detail. Its main weaknesses are the duplicated cache/confirmation/devil's-advocate policies (tokens spent restating the same rule) and the core classification-to-drafting path depending on five agent-mode files that are missing from the bundle.

Suggestions

Ship the five referenced 'agents/*.agent.md' files in the bundle, or replace the routing table in Step 1 with inline drafting guidance backed by the existing fallback templates, so the primary workflow resolves.

State each policy once: consolidate the label/assignee cache rules currently split between 'Required inputs' and Step 6's 'Shared gate cache policy' into Step 6 only, and keep the devil's-advocate escalation triggers in one place (Step 1) instead of repeating them in 'Agent modes'.

Trim the confirmation rules that appear in 'When not to use', Step 5, 'Core behavior to preserve', and 'Safety & constraints' down to Step 5 plus a single 'Safety & constraints' entry to reduce redundant tokens.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no concept over-explanation), but states key policies twice: label/assignee caching appears in 'Required inputs' ('Cache full label set per repo for session; filter locally', 'Reuse cached assignee-candidate results') and again nearly in full in Step 6 ('fetch the repository label set once and cache it for the active session'), and the devil's-advocate escalation conditions are repeated almost verbatim in both the Agent modes section and Step 1 ('when scope/criteria gaps are significant, or when invoked from fusion-issue-task-planning with two or more architecture-ambiguity signals'). This fits 'mostly efficient but could be tightened'; not 2 because nothing is padded or explains known concepts, not 4 because the duplication exceeds minor trimming.

3 / 5

Actionability

Guidance is largely executable — exact MCP tool names ('mcp_github::issue_write', 'mcp_github::search_issues'), an ordered mutation list, concrete defaults ('.tmp/{TYPE}-{CONTEXT}.md') and real fallback template paths ('assets/issue-templates/bug.md.hbs') — but the central drafting step routes to five files absent from the bundle ('Bug -> agents/bug.agent.md', 'agents/feature.agent.md', 'agents/user-story.agent.md', 'agents/task.agent.md', 'agents/devils-advocate.agent.md'), leaving the type-specific drafting logic missing. This matches 'some concrete guidance but incomplete'; not 4 because a missing primary routing target is more than a minor gap.

3 / 5

Workflow Clarity

Eight explicitly numbered steps sequence classification → routing → duplicate check → draft → confirmation → shared gates → ordered mutation → relationship validation, with explicit checkpoints ('Ask explicit publish confirmation before mutation', 'Never publish/update in the same pass as first draft unless user explicitly confirms') and feedback loops for error recovery ('explain the failure clearly... retry after user confirms setup is complete'; 'Keep draft artifacts and return a safe retry plan instead of looping retries'). This matches the top anchor of clear sequence + explicit validation + recovery loops; not 4 because checkpoints are explicit throughout rather than mostly present.

5 / 5

Progressive Disclosure

The body appropriately defers detail to real one-level-deep files ('Use detailed behavior and payload examples in references/instructions.md and references/mcp-server.md', plus assets that all exist in the bundle), but its most prominent routing references — 'agents/bug.agent.md', 'agents/feature.agent.md', 'agents/user-story.agent.md', 'agents/task.agent.md', 'agents/devils-advocate.agent.md' — do not exist in the bundle, breaking navigation from the overview to the primary drafting content. Existing references are clearly signaled, but broken core references are more than the 'minor organization gaps' of the level-4 anchor, so this sits at 3.

3 / 5

Total

14

/

20

Passed

Description

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

The description states three concrete capabilities in third person and occupies a distinct niche, but it omits any 'Use when...' trigger guidance (capping completeness) and lacks the natural vocabulary users would say when they need the skill. Adding explicit triggers and naming the deliverable would move it into the top tier.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user asks to create or update a GitHub issue, draft a ticket, or turn a bug, feature request, or user need into an actionable issue.'

Include natural user vocabulary such as 'create/write an issue', 'draft a ticket', 'bug report', and 'feature request' so the description surfaces on real phrasing rather than only jargon like 'agent mode' and 'GitHub mutation'.

Name the deliverable explicitly — drafting and publishing GitHub issues with labels, assignees, and sub-issue links — to close the coverage gap that currently holds specificity at 4.

DimensionReasoningScore

Specificity

Three concrete third-person actions are named — 'Classify issue type', 'activate the matching agent mode for type-specific drafting', 'enforce shared safety gates before GitHub mutation' — which fits 'lists several specific actions; minor gaps in coverage'. Not 5 because it never states the deliverable (drafting/creating/updating GitHub issues, labels, assignees, sub-issue links), and not 3 because it lists several actions rather than only 1-2.

4 / 5

Completeness

The description has a clear 'what' (classify → route to agent mode → enforce gates) but no 'Use when...' clause or equivalent explicit trigger guidance, which per the rubric guidelines caps completeness at 3 ('Has a clear what but when is missing or only weakly implied'). Not 4 because the 'when' is entirely absent, not merely under-specified.

3 / 5

Trigger Term Quality

Relevant domain keywords are present ('issue type', 'drafting', 'GitHub mutation') but the natural phrases a user would actually say — 'create an issue', 'draft a ticket', 'bug', 'feature request' — are absent, matching 'some relevant keywords but missing common variations or synonyms'. Not 4 because more than a few natural terms are missing; not 2 because the keywords go beyond one or two generic terms.

3 / 5

Distinctiveness Conflict Risk

The niche framing — issue-type classification with safety gates before GitHub mutation — is 'mostly distinct; minor overlap risk' against closely related issue-management or triage skills. Not 5 because without any explicit trigger phrases it could still collide with generic GitHub issue skills, and 'GitHub mutation' is jargon that broadens apparent scope.

4 / 5

Total

14

/

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: 1 missing, 5 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

equinor/fusion-framework

Path

.agents/skills/fusion-issue-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.