audit-useful-action
Skill1 starsChanged 3 months agoApache-2.0View on GitHub
Define the text's useful action in the reader's world and verify that the title, opening, sections, examples, product block, and conclusion lead to the promised change. Use as a required independent gate after edit-article, or when choosing an angle, checking an Article Brief, or making a focused commercial-copy revision. Do not replace full editing, paragraph or evidence audits, or change the editorial contract without explicit approval.
In this repository14 other files it gives its agents.
- audit-content-librarySkill
- audit-eeatSkill
- audit-paragraph-structureSkill
- audit-tone-honestySkill
- chief-editor-reviewSkill
- cms-draft-handoffSkill
- cold-reader-reviewSkill
- draft-articleSkill
- edit-articleSkill
- final-integration-checkSkill
- load-author-voiceSkill
- render-mermaid-infographicSkill
- run-seo-writing-workflowSkill
- visual-storytellingSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. About 0 are common, 8 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
Do not rebuild the article when formulation or focused repair is enough.
- Very specific: line 18
Do not perform full edit-article work on style, syntax, or rhythm outside the diagnosed problem.
- Very specific: line 19
Do not replace audit-paragraph-structure or audit facts beyond the useful-action dependency.
- Distinctive: line 20
Never invent evidence or change the approved reader, situation, promise, scope, or product role.
- Distinctive: line 21
Never publish or hand content to CMS without a separate request.
- Very specific: line 23
If a stronger useful action requires a contract change, return EDITORIAL_CONFLICT and propose the smallest Article Brief amendment.
- Very specific: line 38
Read the shared audit coverage contract for complete anchored coverage, controlling inputs, and independent provenance.
- Distinctive: line 81
Verify that the title names the problem, change, or path.
- Distinctive: line 125
After any rewrite, audit every unit again.
- Very specific: line 135
Use stable IDs UA01, UA02, and so on.
- Distinctive: line 160
Never leak audit IDs or internal comments into publish-ready Markdown.
- Distinctive: line 164
Treat a topic, query, product feature, discount, or publishing motive as useful action by itself.
- Distinctive: line 165
Add a synthetic “benefit” sentence to every paragraph.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Audit the useful action
Purpose
Answer: “What becomes better for this reader after the text?” State the answer in the reader's world as a testable promise that controls the title, structure, evidence, examples, and next action.
A useful action is not a topic or reason to publish. It is an observable change: the reader understands a situation better, makes a decision, completes an action, avoids an error, becomes more capable, or receives an intentionally promised emotional effect.
Boundaries
- Audit one macro level: the promised reader change and each semantic unit's contribution to it.
- Do not rebuild the article when formulation or focused repair is enough.
- Do not perform full
edit-articlework on style, syntax, or rhythm outside the diagnosed problem. - Do not replace
audit-paragraph-structureor audit facts beyond the useful-action dependency. - Never invent evidence or change the approved reader, situation, promise, scope, or product role.
- Never publish or hand content to CMS without a separate request.
If a stronger useful action requires a contract change, return EDITORIAL_CONFLICT and propose the smallest Article Brief amendment.
Inputs and priority
Use:
- explicit user correction;
- approved Article Brief;
- verified primary source or real asset;
- editorial policy and brand system;
- text and working notes;
- model assumption.
Minimum inputs are the text or source material, known reader and situation, and the Article Brief when one exists. Useful additions include search intent and scope, claim permissions and sources, product role, and target next action.
Read the shared audit coverage contract for complete anchored coverage, controlling inputs, and independent provenance. Default to reportDetail: findings; retain the useful-action statement and group passing unit IDs instead of explaining each success.
Modes
formulate: define the useful action before drafting or revision; when several are plausible, show how each changes title and structure.audit: inspect completed copy without editing; return a useful-action map and focused recommendations.rewrite: repair only units markedrewriteorremove, then rerun the complete audit.automatic: ask no questions; make only safe inferences; returnreadyorblocked; remove optional weak claims instead of inventing support.
Working formula
Use one sentence:
For [specific reader] in [trigger or constraint], help them [understand, decide, do, choose, avoid, or feel a specific change] through [material, method, or artifact], without promising [important boundary].
Also record reader, situation, current obstacle, change, artifact or decision, next action, and non-goal. Do not require a numeric metric when success is recognizable through a decision, artifact, or action.
Separate action from publishing motive
Weak formulations live in the author's or company's world: tell what happened, demonstrate expertise, advertise a product, announce a release or discount, list features, or express an opinion.
Move them into the reader's world:
- Who can use this?
- In which specific situation?
- What can that person understand, decide, do, choose, avoid, or feel?
- How can they recognize the change?
- Which evidence, method, or tool makes it possible?
Repeat “How does this help the reader?” until the answer no longer describes the author's interest or the product's existence.
Process
1. Fix the contract
Extract reader, situation, promise, subject, scope, product role, claims, and target next action from the Article Brief. Mark any recovery without a Brief as a working hypothesis.
2. Define the reader-world change
Complete the formula. Confirm that the action belongs to the reader, is more specific than “learn,” matches situation and intent, is achievable through one text, and does not turn possibility into guarantee.
3. Check promise surfaces
Verify that the title names the problem, change, or path; the opening explains who needs it and when; the result matches the Brief; and the reader can see which decision, action, or artifact they will gain.
4. Inventory semantic units
Audit separately:
- title;
- opening;
- every section;
- every independent example;
- product block;
- conclusion and CTA.
Give each unit one primary contribution:
action: enables an action;decision: helps select or reject an option;evidence: supports or verifies a conclusion;constraint: exposes a limitation or error;orientation: provides a necessary map;emotion: delivers the promised emotional value;transition: connects necessary stages.
Topical relevance is insufficient. A unit must change action, decision, understanding, or confidence, or be a necessary transition.
5. Apply the skeptic test
For each weak unit ask what changes after it, why that matters in this situation, which choice or action it enables, and what material makes that possible. Clarify a necessary dependent unit; rewrite or remove a unit with no answer.
6. Inspect special zones
- An example must provide a transferable reasoning pattern, decision, or applicability boundary—not showcase the author or product.
- A product block must begin with the reader's difficulty or decision, explain where the product helps, and state when another tool is better. A feature, release, price, or discount is not the useful action.
- A conclusion must return to the promised change and next action, not merely summarize or promote the author.
7. Assign status
pass: necessary contribution without excess promise;rewrite: contribution is needed but author-centered, abstract, or hidden;remove: no reader change and no necessary transition;blocked: contribution requires critical evidence or a Brief change.
8. Rerun coverage
After any rewrite, audit every unit again. The gate is incomplete until title, opening, every section, every example, product block, and conclusion have final statuses.
Readiness gates
Return ready only when reader and situation are defined; the useful action lives in the reader's world; success is recognizable; title and opening promise it honestly; every unit contributes; examples transfer action or reasoning; the product block stays within applicability boundaries; the conclusion returns to change and next action; claims remain permitted and supported; and the Article Brief was not changed silently.
Output
Return status ready, blocked, or EDITORIAL_CONFLICT; useful-action statement; material reader-world versus author-world diagnosis; complete anchored coverageInventory and counts; grouped passedUnits; every rewrite, remove, or blocked unit with exact anchor, priority, and minimum action; concern-specific coverageFingerprint, input and worker provenance; and next action. Do not duplicate strong-unit explanations in the default report.
Use stable IDs UA01, UA02, and so on. In reportDetail: expanded, use the full map:
| ID | Unit | Reader situation | Reader change | Contribution | Artifact or decision | Status | Action |
For automatic, return:
status: ready | blocked
usefulAction: "..."
readerWorld: true | false
coverage:
title: "1/1"
lead: "1/1"
sections: "N/N"
examples: "N/N"
productBlocks: "N/N"
conclusion: "1/1"
rewritten: []
removed: []
blockers: []
warnings: []
nextStage: draft_article | edit_article | chief_editor_review | blockedNever leak audit IDs or internal comments into publish-ready Markdown.
Do not
- Treat a topic, query, product feature, discount, or publishing motive as useful action by itself.
- Add a synthetic “benefit” sentence to every paragraph.
- Promise an outcome the text cannot deliver.
- Mechanically remove necessary context, transitions, or qualifications.
- Substitute status or emotional value when the Brief promises a practical result.
- Hide a Brief conflict behind smoother wording.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

