cw-bluf

Diagnose whether the most important idea in an article, essay, post, memo, section, paragraph, or sentence appears where it best serves the reader. Use for BLUF checks, buried or misplaced ledes, slow or misleading openings, intro drift, competing main ideas, and requests to get to the point or find the real opening. Compare what the opening foregrounds with what the artifact actually delivers, judge whether any delay is earned, and recommend the smallest structural move. Diagnose by default; rewrite only when asked.

Quality

98%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

96%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-crafted, lean instructional skill with concrete tests, taxonomies, and copy-paste report templates organized into a clear workflow. The only notable defect is the broken external reference to a non-existent context-contract.md.

Suggestions

Fix or remove the broken reference: `../../references/context-contract.md` does not exist in the skill bundle, so the instruction to read it before judging placement is a dead end. Either add the file or inline the minimal context-loading guidance.

The `../../` path escapes the skill bundle; if a shared context contract is intended, reference it via a path that resolves relative to the installed skill location and confirm it ships with the plugin.

Dimension	Reasoning	Score
Conciseness	Lean and efficient across ~200 lines: every section is operational (tests, verdict taxonomy, report templates, revision steps) with no concept explanations Claude doesn't already know; each token earns its place.	5 / 5
Actionability	Highly actionable for an instruction-only skill: five named placement tests, a placement-mode table mapping artifact types to expectations, a verdict table, and a copy-paste-ready report template with bracketed fields plus a compressed short-form variant.	5 / 5
Workflow Clarity	Clear sequenced workflow — Establish Scope, Extract Three BLUFs, Determine Placement Mode, Run Placement Tests, Choose Verdict, Report Diagnosis, Revise Only When Asked — with the tests acting as checkpoints and the report template serving as a checklist; the revision section adds an escalation order.	5 / 5
Progressive Disclosure	Well-organized into clear sections, tables, and templates and appropriately self-contained for an editorial skill, but the sole external reference ("Read `../../references/context-contract.md`") is clearly signaled yet points to a file that does not exist in the bundle, a navigation gap that keeps it from 5.	4 / 5
	Total	19 / 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 actions, comprehensive natural trigger terms with synonyms, explicit what-and-when, and a distinct niche. Third person throughout, no fluff or over-claims.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "Diagnose whether the most important idea... appears where it best serves the reader", "Compare what the opening foregrounds with what the artifact actually delivers", "judge whether any delay is earned", "recommend the smallest structural move" — with comprehensive coverage of the diagnostic workflow and its default behavior.	5 / 5
Completeness	Explicitly answers both what (diagnose placement of the most important idea) and when ("Use for BLUF checks, buried or misplaced ledes... requests to get to the point") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural terms with synonyms: "BLUF checks, buried or misplaced ledes, slow or misleading openings, intro drift, competing main ideas, and requests to get to the point or find the real opening" — phrases an editor would actually say.	5 / 5
Distinctiveness Conflict Risk	Clear niche — lede/importance placement diagnosis — with distinct triggers ("buried lede", "get to the point") that would not fire for hook generation or thesis sharpening, giving minimal conflict risk.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: EveryInc/compound-writing
Path: skills/cw-bluf/SKILL.md
Commit: 8fd0ec8

Reviewed: 15 days ago

Table of Contents

Discovery Implementation Validation

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.