CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fusion-agent-content

Shapes text that agents write for people: issues, PR descriptions, review replies, comments, verdicts, bug reports, and delivery reports. Produces a banner naming the agent and model, a quoted TL;DR, human-first prose under the repository template, folded supporting details, and a folded record of the skills, references, and evidence used. USE FOR: drafting or tidying agent-written GitHub text, making a PR or issue body shorter and readable, adding provenance and evidence, "write this up for humans", "add a TL;DR". DO NOT USE FOR: choosing or simulating the audience (use fusion-audience-alignment), skill or agent instruction files, commit messages, end-user product help, or publishing without confirmation.

77

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%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 exemplifies a well-structured instruction skill: a tight five-step workflow with an explicit pre-handover checklist, concrete copy-paste formats for the error-prone pieces (banner, TL;DR, issue links), and clean one-level-deep delegation to real bundle files. No verbosity, no missing validation, no navigation traps.

DimensionReasoningScore

Conciseness

The body is lean and directive with no padding: no concepts Claude already knows are explained, and every line instructs ('Take the model and reasoning effort from the runtime. Never guess.', 'Write issues and pull requests as `owner/repo#123`, never as Markdown links'). The two-sentence intro and the 'Avoid' example each earn their place by stating purpose and failure modes — the level-5 anchor ('every token earns its place').

5 / 5

Actionability

Guidance is concrete and executable: a copy-paste-ready banner ('<sub>🤖 Drafted by fusion-developer (GitHub Copilot) · claude-opus-5.5 · high reasoning</sub>'), an exact TL;DR prefix ('> **TL;DR:**'), fallback text for unknowns ('write `model not reported`'), a fixed five-part ordering, and an exact issue-reference convention. For an instruction-only skill this matches the level-5 anchor: specific examples cover the common cases, and the remaining templates are deliberately and clearly delegated to named bundle files ('fill by hand, without installing or running a renderer').

5 / 5

Workflow Clarity

The workflow is a clear numbered sequence (shape → banner → TL;DR/body → fold → check) with an explicit validation checkpoint: step 5 'Run `assets/pre-post-checklist.md`. Then hand the draft back', plus safety gates ('Publishing stays with the calling workflow and needs the user's confirmation'). This is not a destructive or batch skill, so no cap applies, and the checklist plus ordered steps match the level-5 anchor ('explicit validation steps... checklists for complex processes').

5 / 5

Progressive Disclosure

The SKILL.md is an overview and every detailed artifact is one level deep and clearly signaled: 'Follow `references/writing-for-people.md`', 'Follow `references/details-and-references.md`', 'Read `assets/content-skeleton.md.hbs`... and `assets/partials/agent-content/README.md`', 'Run `assets/pre-post-checklist.md`'. All referenced paths exist in the bundle, and the reference files do not nest further navigation (mentions of other files inside them are example content, not links to follow). This matches the level-5 anchor: well-signaled one-level-deep references with the overview appropriately split.

5 / 5

Total

20

/

20

Passed

Description

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

An exemplary description: concrete outputs, explicit USE FOR / DO NOT USE FOR triggers with verbatim user phrasings, and third-person voice. The only residual risk is overlap with its sibling authoring skills (issue/PR authoring), which are not explicitly routed away the way audience-alignment is.

Suggestions

In DO NOT USE FOR, add explicit routing for the sibling authoring skills (e.g. 'the authoring skill for a specific deliverable (use fusion-issue-authoring or fusion-pr-documentation) runs first; use this skill to shape what they produce') to close the overlap with 'drafting... agent-written GitHub text'.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions and outputs: 'Produces a banner naming the agent and model, a quoted TL;DR, human-first prose under the repository template, folded supporting details, and a folded record of the skills, references, and evidence used' — coverage spans the full output shape plus the input types ('issues, PR descriptions, review replies, comments, verdicts, bug reports, and delivery reports'). It is written in third person ('Shapes text that agents write for people'), matching the level-5 anchor for comprehensive concrete actions; nothing here is generic padding.

5 / 5

Completeness

It explicitly answers both questions: the 'what' ('Shapes text that agents write for people... Produces a banner... a quoted TL;DR... folded supporting details') and the 'when' via a dedicated 'USE FOR:' clause with concrete trigger phrases ('drafting or tidying agent-written GitHub text', 'add a TL;DR'). A 'DO NOT USE FOR:' clause adds further boundary clarity, exceeding the level-4 anchor where 'when' could be more explicit.

5 / 5

Trigger Term Quality

It includes natural phrases a user would actually say, some quoted verbatim: '"write this up for humans"', '"add a TL;DR"', 'making a PR or issue body shorter and readable', 'adding provenance and evidence', plus natural domain terms (PR description, issue, review reply, verdict). This matches the level-5 anchor (comprehensive natural terms and synonyms); file extensions are not applicable to this skill's trigger surface.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (shaping agent-written GitHub text with provenance, banners, and folding) and one sibling is explicitly routed away ('DO NOT USE FOR: choosing or simulating the audience (use fusion-audience-alignment)'). However, 'drafting or tidying agent-written GitHub text' still overlaps the surface of the closely related authoring skills it lists (fusion-issue-authoring, fusion-pr-documentation), which is the level-4 anchor ('minor overlap risk with closely related skills') rather than the level-5 'minimal conflict risk'.

4 / 5

Total

19

/

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 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

equinor/fusion-framework

Path

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