CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fusion-audience-alignment

Identifies who will read a piece of content, picks an appropriate number of representative readers (as few as cover everyone who must understand or act), reviews the draft through each reader's eyes, and aligns the content so every audience gets what it needs. USE FOR: issues, user stories, PR descriptions, release notes, announcements, ADRs, help articles, or reports where several audiences matter; "who will read this", "review this for the audience", "make this work for product owners and developers", "is this clear to a newcomer". DO NOT USE FOR: formatting the final text (use fusion-agent-content), testing a running app with personas (use fusion-simulated-user-eval), or publishing without confirmation.

74

Quality

93%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 instruction skill: lean, sequenced, actionable, with a clean one-level-deep bundle whose files are referenced exactly where used. It falls just short of top marks on minor duplication between body and bundle files and the absence of a post-alignment verification pass.

Suggestions

State the reader-selection rule once: keep 'as few as cover everyone who must understand or act' in references/finding-readers.md and shorten step 2 to a pointer, removing the duplicated sentence.

Merge the roles-not-names guidance: keep it in the Safety & constraints section and trim the restatement in step 1 to a brief 'roles only, per safety constraints'.

Add an explicit verification checkpoint after step 4: re-read the aligned draft against each reader's findings row (or re-run subagent reviewers for important content) to confirm every 'missing' and 'unclear' item is resolved before recording and handing over in step 5.

DimensionReasoningScore

Conciseness

The ~80-line body is lean with no explanations of concepts Claude already knows, but a few rules are stated redundantly: 'as few as cover everyone who must understand or act' appears in both step 2 and references/finding-readers.md, and the roles-not-names rule appears in both step 1 ('Use roles, never real names or personal data') and the Safety section ('Use roles, not real people. Never put names, emails, or personal data'). These minor duplications could be trimmed, fitting the anchor 'efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place level.

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: each step specifies exactly what to record per reader (role, knows, needs to do, time), when to run subagents versus inline ('given only the draft and the reader card'), how to fill the handlebars templates ('Fill slots as text; never evaluate mustaches inside draft/card values'), and the reader-review prompt in assets/reader-review-prompt.md.hbs is copy-paste ready with a worked example covering the common case. Absence of code is not penalized per the scoring notes since the guidance is concrete and executable.

5 / 5

Workflow Clarity

Five clearly sequenced steps with explicit checkpoints — user confirmation of chosen readers in step 2, a structured findings table (understood, missing, unclear, can act) per reader, and defined expected output. However, after step 4 (align) there is no explicit re-check that each reader's recorded findings were actually resolved before step 5 records and hands over, a minor validation gap that fits 'clear sequence with most checkpoints present; minor validation gaps' rather than the explicit-feedback-loop level.

4 / 5

Progressive Disclosure

The body is a concise overview that splits detail appropriately into four real, one-level-deep bundle files (references/finding-readers.md, references/reader-review.md, assets/reader-card.md.hbs, assets/reader-review-prompt.md.hbs — all verified to exist), each signaled exactly at the workflow point where it is needed. This matches the anchor 'clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'.

5 / 5

Total

18

/

20

Passed

Description

100%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 third-person capability statement, explicit USE FOR with quoted natural trigger phrases, and DO NOT USE FOR routing that cleanly disambiguates sibling skills. No fluff or over-claims despite its length.

DimensionReasoningScore

Specificity

The description lists four concrete actions covering the skill's full workflow — 'Identifies who will read a piece of content', 'picks an appropriate number of representative readers', 'reviews the draft through each reader's eyes', 'aligns the content' — in third-person voice with no vague filler, matching the anchor for multiple specific concrete actions with comprehensive coverage.

5 / 5

Completeness

Both 'what' (identify readers, pick representatives, review as each, align content) and 'when' (explicit 'USE FOR:' clause with concrete trigger phrases, plus a 'DO NOT USE FOR:' boundary) are clearly and explicitly answered, matching the anchor-5 example structure of capability list plus concrete trigger phrases.

5 / 5

Trigger Term Quality

It quotes natural user utterances verbatim ('"who will read this"', '"review this for the audience"', '"make this work for product owners and developers"', '"is this clear to a newcomer"') alongside eight concrete content-type keywords (issues, user stories, PR descriptions, release notes, announcements, ADRs, help articles, reports) — comprehensive coverage of natural terms, fitting the anchor-5 example's synonym coverage.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche (multi-audience review) and explicitly routes adjacent cases to sibling skills — 'formatting the final text (use fusion-agent-content), testing a running app with personas (use fusion-simulated-user-eval)' — leaving minimal conflict risk.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

equinor/fusion-framework

Path

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