agentleFS
flexim-ioflexim-io/seo-writers/skills/chief-editor-review/SKILL.md

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.

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
  1. Distinctive:

    When a user correction changes promise, reader, scope, product role, or mandatory claim, record a Brief amendment first.

    line 42
  2. Very specific:

    Default to review; use amend when a locked snapshot and new input exist.

    line 50
  3. Distinctive:

    Read the shared audit coverage contract.

    line 58
  4. Distinctive:

    Every decision needs a reason and applied or next action.

    line 84
  5. Distinctive:

    Use substance, not vote count:

    line 102
  6. Distinctive:

    When findings require mutually exclusive edits, choose by input priority and record the rejected trade-off.

    line 112
  7. Distinctive:

    Use exact anchors and the smallest sufficient scope.

    line 116
  8. Distinctive:

    Keep audit IDs and ledger data outside reader Markdown.

    line 118
  9. Distinctive:

    When an author answer changes a central framework, update the Brief or source handoff before reader copy.

    line 120
  10. Distinctive:

    Never apply a change when its source is unavailable or its qualification would be lost.

    line 121
  11. Distinctive:

    Treat voice as author evidence or confidence as an evidence fix.

    line 200
  12. Distinctive:

    Start visual production before meaning lock.

    line 203
  13. Distinctive:

    Create a CMS draft or publish.

    line 204

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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 RECOMMENDED author interview;
  • changes shared reader Markdown only from allowed evidence;
  • classifies edits through the workflow changeImpactManifest and 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:

  1. approved Article Brief and explicit amendments;
  2. current reader Markdown after edit-article;
  3. source bundle, claim permissions, and product-state snapshot;
  4. authorDiscovery when present, author-contribution preflight, existing authorInterviewChoice, and supplied author evidence or answers;
  5. independent reports from audit-useful-action, audit-paragraph-structure, audit-tone-honesty, audit-eeat, and audit-content-library in pre-chief-editor mode;
  6. current authorVoiceHandoff when used;
  7. previous chief-editor decision log and changeImpactManifest only for rerun or amendment;
  8. mode: review, amend, or automatic.

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; return blocked for any contract change or external evidence need; do not accept an optional RECOMMENDED interview 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:

FieldMeaning
idStable chief-editor ID
sourceGate or explicit correction
anchorExact reader span or artifact
diagnosisWhat fails
riskReader, evidence, trust, portfolio, or integration risk
proposedActionAuditor's minimum action
dependenciesSource, 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 to author_interview, or accept a documented REPHRASE or CUT only when it preserves the Brief.
  • RECOMMENDED: preserve the author's choice for the same substantive opportunity: skip maps to keep_current_text, defer remains defer, and completed interview_now uses its actual answers. Keep automatic_fallback distinguishable from a user refusal and explicitly choose a safe editorial fallback in automatic. 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-library pre-chief-editor;
  • key phrase placement → draft-article or edit-article QA;
  • 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 | blocked

Return 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 RECOMMENDED interview 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.