chief-editor-review
Skill1 starsChanged 3 months agoApache-2.0View on GitHub
Resolve an article's independent editorial audits against its approved Article Brief, sources, author evidence, product state, and current reader Markdown. Use after edit-article and the five independent audits, or when author answers, user amendments, or final-reader findings reopen a locked decision. Accept, reject, or defer every material finding, apply only traceable edits, classify change impact, rerun only affected gates, decide explicitly on recommended author interviews, and lock meaning before visual work. Do not perform the independent audits, invent evidence, produce visuals, mutate CMS, or publish.
In this repository14 other files it gives its agents.
- audit-content-librarySkill
- audit-eeatSkill
- audit-paragraph-structureSkill
- audit-tone-honestySkill
- audit-useful-actionSkill
- 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, 12 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈12
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 42
When a user correction changes promise, reader, scope, product role, or mandatory claim, record a Brief amendment first.
- Very specific: line 50
Default to review; use amend when a locked snapshot and new input exist.
- Distinctive: line 58
Read the shared audit coverage contract.
- Distinctive: line 84
Every decision needs a reason and applied or next action.
- Distinctive: line 102
Use substance, not vote count:
- Distinctive: line 112
When findings require mutually exclusive edits, choose by input priority and record the rejected trade-off.
- Distinctive: line 116
Use exact anchors and the smallest sufficient scope.
- Distinctive: line 118
Keep audit IDs and ledger data outside reader Markdown.
- Distinctive: line 120
When an author answer changes a central framework, update the Brief or source handoff before reader copy.
- Distinctive: line 121
Never apply a change when its source is unavailable or its qualification would be lost.
- Distinctive: line 200
Treat voice as author evidence or confidence as an evidence fix.
- Distinctive: line 203
Start visual production before meaning lock.
- Distinctive: line 204
Create a CMS draft or publish.
≈ “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
Chief editor review
Purpose
Make one accountable editorial decision across complementary or conflicting audit reports, apply only evidence-safe changes, and lock a version whose meaning can move to visual-storytelling.
The chief editor owns the decision, not the evidence. Independent auditors diagnose; the chief editor accepts, rejects, or defers findings and owns changes to shared reader Markdown.
Responsibility
chief-editor-review:
- compares five independent reports with the Brief, sources, author evidence, and product state;
- records an explicit decision for every material finding;
- decides separately what to do with a
RECOMMENDEDauthor interview; - changes shared reader Markdown only from allowed evidence;
- classifies edits through the workflow
changeImpactManifestand assigns only affected reruns; - locks meaning, structure, evidence, first-person permissions, and snapshot.
It does not rerun independent audits itself, rewrite unaffected copy for taste, invent facts or experience, silently change the Brief, plan or produce visuals, read or mutate CMS, or publish.
Inputs and priority
Use:
- approved Article Brief and explicit amendments;
- current reader Markdown after
edit-article; - source bundle, claim permissions, and product-state snapshot;
authorDiscoverywhen present, author-contribution preflight, existingauthorInterviewChoice, and supplied author evidence or answers;- independent reports from
audit-useful-action,audit-paragraph-structure,audit-tone-honesty,audit-eeat, andaudit-content-libraryinpre-chief-editormode; - current
authorVoiceHandoffwhen used; - previous chief-editor decision log and
changeImpactManifestonly for rerun or amendment; - mode:
review,amend, orautomatic.
Priority: explicit user correction, approved Brief, verified primary source or real artifact or author answer, product state and claim permissions, independent findings, author voice and editorial policy, current draft, model preference.
When a user correction changes promise, reader, scope, product role, or mandatory claim, record a Brief amendment first. Never use the decision log as a hidden contract replacement.
Modes
review: perform the first complete reconciliation, apply decisions, and assign reruns.amend: process a new user correction, author answer, source, or integration finding after lock; supersede affected decisions and rerun only affected gates.automatic: ask no questions; returnblockedfor any contract change or external evidence need; do not accept an optionalRECOMMENDEDinterview without an explicit editorial decision in the package.
Default to review; use amend when a locked snapshot and new input exist.
Process
1. Verify package integrity
Confirm that the first complete pass has five reports for one reader snapshot and Brief version. On amendment, accept an affected fresh report or a valid carried_forward report only when its concern-specific coverageFingerprint, source artifact, impact-manifest ID, and rationale prove its controls unchanged. Every fresh report needs coverage, exact anchors, action, status, and clean-context provenance; text auditors did not mutate shared copy or read forbidden inputs; the corpus snapshot is fresh enough; and every marker and blocker is listed.
Read the shared audit coverage contract. Accept compact complete inventories and grouped passes from the first dispatch; do not demand expanded successful rows or a fresh audit merely for presentation. Reject counts without anchored coverage or independent provenance.
Never mix reports from different article versions without an explicit carry-forward record. A reader byte-hash mismatch calls for change-impact comparison and unambiguous anchor mapping, not automatic semantic invalidation. Verify source, product-state, metadata, and corpus controls separately even when reader bytes match. The same selective rules apply after all five first reports arrive, including changes made during initial reconciliation before the first lock.
2. Build the finding ledger
Normalize every material finding:
| Field | Meaning |
id | Stable chief-editor ID |
source | Gate or explicit correction |
anchor | Exact reader span or artifact |
diagnosis | What fails |
risk | Reader, evidence, trust, portfolio, or integration risk |
proposedAction | Auditor's minimum action |
dependencies | Source, author answer, Brief amendment, or rerun |
Merge duplicates while preserving all report sources. Auditor majority is not a decision rule.
3. Accept, reject, or defer
accept: a higher-priority input confirms the finding and the action preserves the contract;reject: the finding is incorrect, outside the gate's role, or would violate a higher-priority requirement;defer: the finding is real but needs a future source, answer, asset, or separate scope and does not block the current safe version.
Every decision needs a reason and applied or next action. Never ignore a finding silently or edit without a ledger entry.
4. Decide author contribution separately
Compare audit-eeat.authorContribution.decision with the early preflight.
First compare each proposed question with the actual discovery answers and their limits. Integrate an already supplied answer through a traceable edit and affected reruns; do not repeat the interview because the draft omitted it. For a new question, identify the material evidence detail still missing. Honor the scope of a discovery opt-out as well as later interview choices; neither can authorize an unsupported critical claim. A missing discovery record for an existing article alone does not require restarting it.
REQUIRED: do not fabricate a patch; route toauthor_interview, or accept a documentedREPHRASEorCUTonly when it preserves the Brief.RECOMMENDED: preserve the author's choice for the same substantive opportunity:skipmaps tokeep_current_text,deferremainsdefer, and completedinterview_nowuses its actual answers. Keepautomatic_fallbackdistinguishable from a user refusal and explicitly choose a safe editorial fallback inautomatic. In interactive work, route a still-pending or materially new opportunity to the coordinator for the author's choice; do not silently make that choice or repeat an already settled question. Explain the reader-value trade-off without describing evidence-safe generic copy as demonstrated author contribution.NOT_NEEDED: confirm sufficiency or irrelevance without decorative biography.
Reject interview questions that depend on model-invented frames and return them to audit-eeat for reality-first reformulation.
An independent auditor may recommend the same example without seeing the earlier decision. Reconcile that recommendation here using its planned-section/reader-benefit identity, not a newly assigned audit ID. Revisit a deferred choice only at the author's specified condition or explicit request. A new critical REQUIRED gap still blocks until evidence or a Brief-preserving repair resolves it; an old refusal cannot authorize invention.
5. Resolve report conflicts
Use substance, not vote count:
- evidence and honest qualification outrank smoothness;
- useful action outranks decorative completeness;
- the Article Brief outranks model preference;
- a real author answer outranks invented editorial taxonomy;
- portfolio role outranks repetition of a neighboring guide;
- first person never replaces provenance, but permitted authorial framing, navigation, and source-grounded judgment do not need to be neutralized merely because they are first person;
- production traceability stays outside reader Markdown.
When findings require mutually exclusive edits, choose by input priority and record the rejected trade-off.
6. Apply accepted changes
- Use exact anchors and the smallest sufficient scope.
- Link every factual or experiential insertion to a source or answer.
- Keep audit IDs and ledger data outside reader Markdown.
- Preserve primary key phrase placement or assign keyword regression.
- When an author answer changes a central framework, update the Brief or source handoff before reader copy.
- Never apply a change when its source is unavailable or its qualification would be lost.
7. Assign and verify reruns
Route changes:
- promise, opening, section role, or conclusion →
audit-useful-action; - paragraph, list, or table composition →
audit-paragraph-structure; - voice, disclosure, confidence, approved narrative perspective, or product motive →
audit-tone-honesty; - claims, experiential first person, author evidence, or trust surface →
audit-eeat; - owned job, scope, or internal links →
audit-content-librarypre-chief-editor; - key phrase placement →
draft-articleoredit-articleQA; - new or changed media → later visual and integration stages after lock.
Create or validate the changeImpactManifest before dispatching. Every affected gate must return ready for the current controls. Mark an unaffected gate carried_forward only with its unchanged coverage fingerprint, prior artifact, manifest ID, and recorded reason. If the edit's semantic effect or controlling inputs are unclear, escalate conservatively instead of carrying a gate forward.
8. Lock meaning
After reruns pass, record approved title and useful action; reader and scope; section order and required artifacts; allowed, qualified, and prohibited claims; author contribution, narrative perspective, and first-person permissions; product role and disclosure; reader-facing key phrase and placements; internal-link destinations; reader snapshot or hash; deferred findings and owners; and visual constraints that require returning to chief-editor review if changed.
The lock allows typo and integration fixes. Any change to meaning, claim, structure, or reader promise reopens affected gates.
Readiness gates
Return ready only when the initial five reports are complete and every later audit concern has either a fresh matching report or valid carried-forward coverage; every material finding has a reasoned decision; accepted changes are traceable; author contribution decision is explicit; amendments precede contract changes; every affected gate reran and passed; no critical evidence, trust, portfolio, or marker blocker remains; meaning and snapshot are locked; and no CMS mutation or publication occurred.
Until reruns complete, return blocked or in_review; never call the text locked.
Output
status: ready | blocked | in_review
mode: review | amend | automatic
package:
briefVersion: "..."
readerSnapshot: "..."
reportsPresent: []
findingLedger:
- id: CE001
source: audit-eeat
anchor: "..."
diagnosis: "..."
decision: accept | reject | defer
reason: "..."
action: "..."
authorContribution:
auditDecision: REQUIRED | RECOMMENDED | NOT_NEEDED
authorInterviewChoiceRef: null
editorialDecision: interview_now | keep_current_text | defer | not_needed
rationale: "..."
appliedEdits: []
briefAmendments: []
reruns:
required: []
completed: []
carriedForward: []
invalidated: []
lockedMeaning:
title: "..."
usefulAction: "..."
reader: "..."
scope: "..."
productRole: "..."
authorContribution: "..."
narrativePerspective: FIRST_PERSON | NEUTRAL | ORGANIZATIONAL | THIRD_PERSON
keyPhrase: "..."
snapshot: "..."
deferredFindings: []
warnings: []
blockers: []
nextStage: visual_storytelling | author_interview | research | edit_article | blockedReturn the reader artifact reference (or Markdown when needed) and one concise decision ledger outside reader Markdown. Do not repeat all accepted findings in a second human report or restate successful audit units. The package's finding ledger is the decision log; preserve reasons, provenance, deferred owners, and all changed concerns.
Do not
- Average auditor opinions by vote.
- Accept a
RECOMMENDEDinterview silently. - Treat voice as author evidence or confidence as an evidence fix.
- Amend the Brief after the fact to legalize existing copy.
- Skip an affected gate rerun.
- Start visual production before meaning lock.
- Create a CMS draft or publish.
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.

