audit-tone-honesty
Skill1 starsChanged 3 months agoApache-2.0View on GitHub
Audit and selectively rewrite tone in editorial, technical, marketing, and commercial copy by separating false performance, honest speech, and justified play. Use as a required independent gate after edit-article, or to check invented author voice, production-language leakage, hidden motives, false intimacy, pressure, flattery, shame, unsupported confidence, fabricated stories, honest limits, care, and demonstration. Permit play only inside a clear frame with independent value. Do not replace full editing, fact-checking, E-E-A-T audit, or the Article Brief.
In this repository14 other files it gives its agents.
- audit-content-librarySkill
- audit-eeatSkill
- audit-paragraph-structureSkill
- audit-useful-actionSkill
- 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
16 rules. About 0 are common, 15 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈15
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 24
Do not redefine the useful action or rebuild paragraph structure without a tone reason.
- Distinctive: line 26
Never treat calm wording as evidence, invent identity or motive, or change Brief, product role, qualifications, or feature state.
- Distinctive: line 27
Never publish or hand content to CMS without a separate request.
- Distinctive: line 37
Never infer an unknown biography or motive.
- Very specific: line 39
Read the shared audit coverage contract for complete anchored coverage, controlling inputs, and independent provenance.
- Distinctive: line 63
Do not simulate an emotion that the evidence and frame cannot support honestly.
- Distinctive: line 69
Equality: treat the reader as capable.
- Distinctive: line 72
Natural register: use words the real speaker would use in this situation.
- Distinctive: line 73
Emotional pressure: no artificial urgency, threat, fear, pain, envy, status promise, or guaranteed success without a real basis.
- Distinctive: line 89
Verify, narrow, qualify, distinguish judgment from observation, or remove a claim when the speaker is compensating for weak evidence.
- Distinctive: line 115
Read reader Markdown without the Brief or reports.
- Distinctive: line 125
Check the opening for a flattering alliance against a common enemy.
- Distinctive: line 142
Read everything again after repair.
- Distinctive: line 196
Remove humor and character mechanically.
- Distinctive: line 197
Add disclosure to every self-reference.
- Distinctive: line 198
Treat first person as proof of author experience or reject it solely because it is permitted authorial voice.
≈ “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 tone honesty
Purpose
Make the imagined voice in the reader's head match the real speaker, situation, motive, evidence, and relationship.
Distinguish:
false: the voice performs an identity, closeness, emotion, confidence, or disinterest that context does not support;honest: the speaker talks from a real position, exposes material motive and limits, respects the reader, and demonstrates claims;play: the speaker performs intentionally inside a frame the reader understands and provides independent emotional value.
False tone is not a list of banned words. Context determines whether the same phrase is honest or false.
Boundaries
- Act as a separate trust gate after task, evidence, and macrostructure are fixed.
- Repair only spans where voice changes trust or the relationship; do not perform full
edit-articlework. - Do not redefine the useful action or rebuild paragraph structure without a tone reason.
- Notice false authority or experience signaling, but leave full claim inventory, provenance, gap routing, and interview decisions to
audit-eeat. - Never treat calm wording as evidence, invent identity or motive, or change Brief, product role, qualifications, or feature state.
- Never publish or hand content to CMS without a separate request.
Return EDITORIAL_CONFLICT when honest wording requires a contract change.
Inputs and priority
Collect the speaker or organization, channel and format, reader and competence, actual relationship, commercial or personal stake, intended emotion and action, Article Brief, claims, sources, product state, approved authorVoiceHandoff when used, and complete text including title, captions, CTA, and relevant disclosures.
Priority: explicit user correction, approved Brief, verified primary source and real channel context, editorial policy and permitted voice handoff, current text, model assumption.
Never infer an unknown biography or motive. Do not read CMS for voice during this independent audit. The supplied voice handoff is not evidence.
Read the shared audit coverage contract for complete anchored coverage, controlling inputs, and independent provenance. Default to reportDetail: findings; inspect every unit through the applicable eleven gates, grouping passing IDs without repeating successful analysis.
Modes
set-tone: define the tone contract before writing.audit: inspect the full text and return an external manifest without changing reader Markdown.rewrite: repair onlyrewrite,remove, ordiscloseunits, then rerun the complete audit.automatic: ask no questions; returnreadyorblockedwithout creating a plausible legend for unknown context.
Tone contract
Record:
speaker: who may say the text;narrativePerspective:FIRST_PERSON,NEUTRAL,ORGANIZATIONAL, orTHIRD_PERSONas approved by the Brief;readerRelation: stranger, customer, subscriber, colleague, community member, or another real relationship;frame: instruction, technical guide, column, letter, advertisement, show, or another genre;intendedEmotion: the specific response sought;commercialStake: what the speaker gains from the reader's decision;evidencePosture: what is known, interpreted, judged, or unknown;careObligation: material risk, downside, and poor-fit cases to expose;playMode: none | light | full;forbiddenMoves: Brief- and policy-specific restrictions.
Do not simulate an emotion that the evidence and frame cannot support honestly.
Eleven gates
- Identity: the voice belongs to the real speaker or a clearly declared role. A verified assigned author may use Brief-approved first person for authorial framing, navigation, and source-grounded judgment or recommendation. No invented experience, testimonial, quote, ordinary-user mask, or imitation.
- Motive: material commercial or personal interest is visible before it changes the reader's decision. Avoid ritual disclosure when context already makes the stake clear.
- Equality: treat the reader as capable. No shame, condescension, contempt, novice-shaming, belonging manipulation, or unsupported flattery.
- Confidence: wording strength matches evidence. Separate observation, interpretation, judgment, prediction, and guarantee.
- Care: disclose material difficulty, risk, support cost, and poor-fit cases even when they weaken the sale. Help the reader decide, not merely approach the product.
- Natural register: use words the real speaker would use in this situation. Do not disguise press copy as conversation or formal copy as dialogue.
- Emotional pressure: no artificial urgency, threat, fear, pain, envy, status promise, or guaranteed success without a real basis. State real deadlines or risks with their cause.
- Authority and social proof: expertise requires relevant experience, source, or demonstration. A title, name, statistic, testimonial, or “everyone knows” is not an argument.
- Play: humor, character, hyperbole, and irony fit channel expectations, preserve usefulness, and provide value beyond familiarity.
- Product honesty: introduce the product at a real reader need; show capability, limit, alternative, and human decision ownership proportionally. No unsupported miracle transition.
- Production voice: solve the reader's task rather than narrating production. Keep query metrics, Brief fields, corpus or audit findings, collision labels, gates, MCP or schema methods, raw statuses, and validation timestamps outside reader copy unless the article genuinely teaches them.
A verified product behavior may belong in copy; the internal method used to verify it usually does not. First person does not fix production voice or prove personal product use.
Diagnostic signals
Look for invented stories or customers; advertising disguised as independent advice; forced emotion, capitals, exclamation, or intensifiers; pain, fear, urgency, shame, or status manipulation; effortless-money or guaranteed-result promises; unearned familiarity; authority in place of evidence; miraculous before-and-after product narratives; fake dialogue; raw production vocabulary; unconditional advice despite exceptions; and compliments that substitute for a criterion or tool.
Directness, imperative voice, strong emotion, conversational language, and money are not false by themselves. Judge function and foundation.
Honest repair tools
- Verify, narrow, qualify, distinguish judgment from observation, or remove a claim when the speaker is compensating for weak evidence.
- Expose material motive, payment, relationship, prior involvement, or conflict before it affects trust; do not turn disclosure into confession.
- Demonstrate care through a useful boundary, risk check, stop condition, or alternative—not “we care.”
- Replace evaluation with a verifiable example, real interface, source, trade-off, rejection condition, or reproducible method.
- Speak to an equal by preserving necessary complexity, explaining only what matters, offering criteria, and allowing refusal.
Play modes
none: use when precision dominates, error risk is high, relationship is weak, or entertainment does not support the task.light: allow a rare metaphor, rhythmic contrast, or gentle irony that clarifies without changing factual status.full: allow character, plot, hyperbole, or show only when the reader understands and accepts the frame, useful information remains accessible, the play has independent value, the form can be sustained, and commercial action is separate and visible.
Familiarity without independent value is not play.
Process
1. Fix the editorial and tone contracts
Record reader, situation, useful action, promise, claims, product role, restrictions, and the tone contract.
2. Inventory the complete surface
Audit title, every prose paragraph, lists, tables, quotes, code comments, standalone examples and stories, product block, CTA, disclosure, and conclusion. Assign stable external IDs TN001, TN002, and so on; never insert them into reader Markdown.
3. Run an imagined-voice cold pass
Read reader Markdown without the Brief or reports. For every unit, identify the apparent speaker, relationship, intended emotion, contract fit, hidden alternate speaker such as press office or SEO operator, and whether the sentence is useful without knowing the production workflow.
Then compare claims and restrictions with the Brief. The Brief controls meaning but does not justify service vocabulary in reader copy.
4. Apply the eleven gates
Mark only relevant risks. Do not penalize permitted non-experiential first person merely because it says I; audit whether the apparent speaker, relationship, and evidence posture fit the approved perspective. Do not penalize a short technical paragraph because disclosure or play lives elsewhere and context already covers it.
5. Inspect high-risk zones
Check the opening for a flattering alliance against a common enemy; stories for reality or clear hypotheticals; expert references for a specific supported conclusion; product coverage for stake, limits, and alternatives; and conclusion or CTA for pressure, false urgency, or status promises.
6. Assign status
pass: voice fits the contract;rewrite: required meaning sounds false, coercive, flattering, or unnatural;disclose: material motive or relationship must become visible;remove: the unit exists only for manipulation or valueless play;verify: voice strength depends on an unsupported claim, story, or authority;blocked: honest repair requires unknown critical evidence or a Brief change.
7. Repair minimally
Preserve facts, links, technical terms, useful action, and author character. Prefer qualification, demonstration, and a clear boundary to generic neutrality.
8. Rerun the full audit
Read everything again after repair. Removing pressure in one span must not move false tone into another or destroy rhythm.
Readiness gates
Return ready only when speaker, relationship, frame, and emotion are defined; coverage is complete; no false identity, experience, closeness, or independence remains; confidence matches evidence; material motive is visible; the reader is treated as an equal; product limits and alternatives remain; play mode is justified; claims and Brief are preserved; audit IDs are absent; and every remaining production term has a genuine reader function.
Output
Return status ready, blocked, or EDITORIAL_CONFLICT; tone contract; material false / honest / play profile; complete anchored coverageInventory and counts; grouped passedUnits; every rewrite, disclose, remove, verify, or blocked unit with exact anchor, priority, and minimum action; concern-specific coverageFingerprint, input and worker provenance; and next action. Do not repeat trust strengths for each successful unit.
For reportDetail: expanded, use the full manifest:
| ID | Anchor | First words or unit | Imagined voice | Trust function or risk | Result | Action |
For automatic, return:
status: ready | blocked
toneContract:
speaker: "..."
readerRelation: "..."
frame: "..."
intendedEmotion: "..."
commercialStake: "..."
evidencePosture: "..."
playMode: none | light | full
coverage:
prose: "N/N"
lists: "N/N"
tables: "N/N"
examples: "N/N"
productBlocks: "N/N"
toneManifest: []
changes: []
warnings: []
blockers: []
qa:
motiveVisible: true | false
readerTreatedAsEqual: true | false
confidenceQualified: true | false
careDemonstrated: true | false
playJustified: true | false
claimsPreserved: true | false
internalIdsRemoved: true | false
productionVoiceAbsent: true | false
permittedAuthorialFirstPersonPreserved: true | false
coldReaderPass: true | false
nextStage: chief_editor_review | edit_article | blockedDo not
- Make honest copy dry by default or treat evidence-backed confidence as false.
- Remove humor and character mechanically.
- Add disclosure to every self-reference.
- Treat first person as proof of author experience or reject it solely because it is permitted authorial voice.
- Allow production language merely because an auditor understands it.
- Perform equality through slang, familiarity, or deliberate errors.
- Turn care into another marketing claim.
- Correct pressure with shame about marketing.
- Require play in technical or high-risk copy.
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.

