editorial-qa
Editorial-qa is a pre-publish quality control framework that catches content problems before publication through structured checks addressing brief adherence, voice consistency, factual accuracy, structural clarity, AI-content auditing, and SEO compliance. Use this skill when building a content QA process from scratch, auditing existing processes that ship sloppy work or burn out reviewers, designing QA gates for AI-assisted workflows, or implementing sampling discipline for programmatic SEO production at scale.
git clone --depth 1 https://github.com/rampstackco/claude-skills /tmp/editorial-qa && cp -r /tmp/editorial-qa/dist/pi/.agents/skills/editorial-qa ~/.claude/skills/editorial-qaSKILL.md
# Editorial QA A senior editor's playbook for pre-publish content QA. The discipline that catches problems BEFORE content ships, not after. Most content QA is broken in one of two directions. The thin version is "did I read it once and is the spelling OK," which catches typos but misses brief drift, voice inconsistency, hallucinated facts, AI tells, and structural problems that reach readers as "this is fine but not memorable." The thick version is a 47-item checklist that nobody completes honestly because it is process theater: checkboxes nobody actually believes catch problems. This skill is the discipline of catch-problems QA. Each check earns its keep by catching a specific class of failure that would reach readers if missed. Checks that do not catch anything get cut. Checks the production volume cannot sustain get redesigned (sampling instead of full audit, automated instead of manual). The QA framework is what is left when you remove the theater. The skill covers three production shapes: single editorial pieces (one at a time, full QA), AI-generated drafts (with the AI-content audit that did not exist as prominently 2 years ago), and programmatic SEO sets at scale (sampling discipline, threshold gating). Each needs its own QA shape; the underlying methodology composes across all three. When to use this skill: building a content QA process from scratch, auditing an existing QA process that ships sloppy work or burns out the team, designing QA gates for an AI-assisted workflow, or building sampling discipline for programmatic SEO sets. --- ## What this skill is for This skill spans pre-publish quality control. It plugs in at the END of every other content skill's output. The six-skill content suite distinction: - `content-strategy` is program scope: what to produce. - `pillar-content-architecture` is hub scope: how the topical hub fits together. - `content-brief-authoring` is per-piece scope: briefs each piece. - `content-and-copy` is execution scope: writes each piece. - `programmatic-seo` is scaled scope: generates many pages from data. - This skill is gate scope: verifies before publish. Every skill above produces a draft. This skill is what gets drafts to publishable. It is the gate where quality is actually enforced. The audience: editorial leads, content directors, in-house content QA, agencies with production lines, content ops managers, anyone running a writer (human or AI) and accountable for what ships. The voice is senior editor to junior editor or content marketer. Specific, opinionated, honest about where QA earns its keep versus where it becomes process theater. --- ## Catch-problems QA vs checkbox QA The keystone distinction. Two failure modes plus the discipline. **Thin QA (typo-checking dressed as quality control).** "I read it once, it is fine." Catches obvious mistakes; misses brief drift, voice inconsistency, hallucinated facts, structural problems, AI tells. Output: shipped content that is "fine but not memorable." Cost: invisible until a brand misstep, a hallucinated statistic, or a competitor's content compounds and the thin set falls behind. **Thick QA (47-item checklist nobody completes honestly).** Every conceivable check listed; no triage. Reviewers either skim and check boxes (theater) or burn out under the cognitive load. Output: shipped content slightly more polished than thin QA produces, but the team's review velocity collapses. Cost: throughput drops; reviewers leave; the checklist atrophies into a few checks that actually run. **Catch-problems QA (the discipline).** Each check earns its keep by catching a specific class of failure that would reach readers if missed. Checks that do not catch anything get cut. Production volume drives sampling versus full-audit decisions. Reviewers are accountable for what they caught, not for box-completion. The litmus test. If the team can name the last 3 problems each QA check caught, the check earns its keep. If a check has not caught anything in 6 months, it is theater. Cut it; reallocate the attention to checks that catch real problems. --- ## Brief adherence check Did the writer execute the brief? The check is straightforward when the brief is well-authored (see `content-brief-authoring`). The brief-adherence checks: - **Target keyword and cluster.** Present in title, first paragraph, headings. - **Search intent and SERP format.** Piece matches the dominant SERP format (article when SERP wants article, listicle when SERP wants listicle). - **Target audience.** Piece reads as written FOR the named audience, not for a generic reader. - **Heading structure.** Piece follows the H2 / H3 outline in the brief, or has a documented reason for deviation. - **Required entities.** Every entity flagged in the brief appears in the piece. - **Internal links.** Outbound links specified in the brief are present with the right anchor text. - **Anti-patterns.** Piece avoids the off-limits language and structures named in the brief. - **Success criteria acknowledged.** Piece is shaped to MEASURE against the success criteria. The brief-adherence check is the cheapest, fastest, highest-value QA gate. It runs first in the QA sequence because catching a brief-adherence failure early saves the editor from spending time on voice and structure on a piece that will need to restart. If briefs are vague, this check is impossible. Fix briefs first; the QA process cannot enforce a contract that does not exist. Detail in [`references/brief-adherence-checklist.md`](references/brief-adherence-checklist.md). --- ## Voice consistency check Does the piece sound like the brand? - **Vocabulary.** Brand-specific terms used correctly; off-brand terms absent. - **Sentence rhythm.** Matches brand voice (short and punchy versus measured and layered versus colloquial). - **Stance.** The piece takes positions consistent with brand POV. - **Register.** Formal or casual matches the surface (blog versus whitepaper versus help doc)
Run a comprehensive WCAG accessibility audit covering perceivable, operable, understandable, and robust principles. Use this skill whenever the user wants to audit accessibility, review WCAG compliance, fix accessibility issues, prepare for accessibility certification, address an accessibility lawsuit risk, or systematically improve a site's accessibility. Triggers on accessibility audit, WCAG audit, a11y audit, accessibility compliance, ADA compliance, screen reader test, keyboard navigation, accessibility report, fix accessibility, axe scan. Also triggers when accessibility issues have been reported and need systematic remediation.
How to produce ad creative that converts at performance scale. Hook patterns, format selection, video pacing, variation systems, sequential testing methodology, fatigue detection, brand-voice alignment without conversion dilution, and platform-specific creative norms. Triggers on ad creative, ad design, hook patterns, ad video pacing, creative testing, ad variations, creative refresh, creative fatigue, refresh ad creative, video ads for Meta, TikTok creative, LinkedIn ad creative, ad asset library. Also triggers when a team is producing creative at scale, planning a creative test cycle, or auditing why creative is not converting.
How to read paid media dashboards without fooling yourself. Attribution models, platform reporting quirks, multi-platform reconciliation, ROAS vs LTV horizon traps, statistical noise in performance metrics, incrementality testing, and the failure modes that produce expensive lessons. Triggers on read paid media dashboard, attribution analysis, ROAS vs LTV, multi-platform reconciliation, ad incrementality, geo holdout, conversion lift study, ghost bidding, paid media reporting, board-deck paid media metrics, blended CAC, MMM, MTA, last-click attribution. Also triggers when a marketer is about to scale, kill, or rebudget a campaign based on platform metrics, or when reconciling platform reports against warehouse revenue.
Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons. Use this skill whenever the user wants to run a postmortem, retrospective, AAR, or after-action review on any past event. Triggers on after-action report, AAR, postmortem, retrospective, retro, post-incident review, what went well what didn't, lessons learned, blameless postmortem, root cause analysis, RCA, five whys. Also triggers when the user has just shipped something or just resolved an incident and wants to capture learnings.
How humans and AI compose in content workflows. Where AI legitimately participates, where humans must own, hybrid workflow patterns, voice ownership preservation, the AI slop problem, disclosure and transparency, team calibration, and the ethics of intellectually honest AI-assisted content production. Triggers on AI content workflow, AI-assisted writing, hybrid content production, AI in editorial, AI slop, AI disclosure, AI usage policy, AI content ethics, voice preservation with AI, team AI calibration. Also triggers when content feels generic despite quality tools, when team AI usage has drifted into inconsistency, or when a regulated or trust-sensitive context requires explicit AI policy.
Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy. Use this skill whenever the user wants to plan analytics, design dashboards, build event taxonomies, define KPIs, set up tracking, or audit existing measurement. Triggers on analytics strategy, measurement plan, event taxonomy, tracking plan, KPI framework, dashboard design, north star metric, attribution model, conversion tracking, GA4 setup, Mixpanel setup, analytics audit. Also triggers when the user has data but no clear way to use it, or wants to make decisions but doesn't know what to track.
Direct visual and creative work for campaigns, photography, illustration, video, and branded experiences. Use this skill whenever the user wants to brief a photographer, direct illustrators, plan a creative campaign, develop visual concepts, write a creative direction document, or evaluate creative work for fit. Triggers on art direction, photo brief, photography brief, illustration brief, campaign concept, creative concept, visual direction, mood board, look and feel, visual treatment, video direction. Also triggers when the user has approved brand identity but needs to extend it into specific creative deliverables.
Plan and run backups, set recovery objectives, and run disaster recovery drills. Use this skill when defining RPO/RTO targets, designing backup architecture, deciding what to back up and how often, planning for full-region or platform outages, or running a restoration drill. Triggers on backup, restore, RPO, RTO, disaster recovery, DR, business continuity, what if the database is gone, what if our hosting goes down, recovery drill, ransomware planning. Also triggers when an incident reveals a gap in restoration capability.