editorial-qa
Pre-publish QA framework for content. Brief adherence, voice consistency, fact accuracy, structure and clarity, AI-content audit, SEO and AEO compliance, internal linking and schema validation, QA at scale via sampling, the QA workflow, and the discipline that distinguishes catch-problems QA from ch…
Install / Use
npx skills add rampstackco/claude-skills --skill editorial-qaInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of editorial-qa
editorial-qa scores 86/100 on our quality scale, 1834th of 2,790 Automation skills we index.
Its SKILL.md is 22 KB long, well organised into 16 sections and no code examples: a thorough specification that gives an agent plenty to work with.
It has 902 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so editorial-qa is actively maintained.
- Our last check on 2026-11-03 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
editorial-qa compared with similar skills
All 4 of these similar skills score higher than editorial-qa; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| editorial-qa (this skill)by rampstackco | 86 | 902 | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install editorial-qa?
- Run
npx skills add rampstackco/claude-skills --skill editorial-qa. The install tabs above show the steps for each supported agent. - Which AI agents does editorial-qa work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is editorial-qa safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is editorial-qa still maintained?
- The repository was last updated about 2 months ago, so editorial-qa is actively maintained.
Skill content
View source on GitHubname: editorial-qa
description: "Pre-publish QA framework for content. Brief adherence, voice consistency, fact accuracy, structure and clarity, AI-content audit, SEO and AEO compliance, internal linking and schema validation, QA at scale via sampling, the QA workflow, and the discipline that distinguishes catch-problems QA from checkbox QA. Triggers on editorial QA, content review, pre-publish review, content audit, content QA process, AI-content audit, hallucination check, content sampling, programmatic QA, voice consistency check, brief adherence check. Also triggers when a content team is shipping sloppy work, when AI-co-authored content is reaching publish unaudited, when a QA process burns reviewers out, or when a programmatic SEO set needs sampling discipline. On a voice consistency check, this skill owns checking a draft against an existing voice system at the publish gate; use brand-voice when the voice system itself needs defining or documenting."
category: content
catalog_summary: "Pre-publish QA framework: brief adherence, voice consistency, fact accuracy, AI-content audit, AEO/SEO compliance, sampling at scale, and the workflow that distinguishes catch-problems QA from process theater"
display_order: 7
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-strategyis program scope: what to produce.pillar-content-architectureis hub scope: how the topical hub fits together.content-brief-authoringis per-piece scope: briefs each piece.content-and-copyis execution scope: writes each piece.programmatic-seois 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.
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).
- Voice drift in long pieces. 3,000-word pieces often start in brand voice and drift to generic by section 4. Sample paragraphs from start, middle, end.
For AI-co-authored pieces, voice drift is the dominant failure mode. AI assistants regress to a model-default voice unless the writer actively pulls them back. The QA check needs to read for the brand voice as much as for the words.
Detail in references/voice-consistency-patterns.md.
Fact accuracy and citation discipline
Every claim in the piece needs to be true. The check:
- Statistics. Every number sourced or removed if no source.
- Quotes. Every quote attributed to a real person who actually said it.
- Case studies. Every example refers to a real company or scenario, or labeled clearly as hypothetical.
- Dates and timelines. Verified, not approximate.
- Named experts. Real people who consented to attribution.
- Product claims. Matches actual product behavior, not future-tense roadmap or marketing aspiration.
Hallucination is the dominant failure mode in AI-assisted writing. AI assistants generate plausible statistics, plausible quotes, plausible case studies, none of which are real. The fact-accuracy check is the gate that catches them. If you skip this gate on AI-generated content, you ship hallucinations.
Citation discipline:
- Inline citations link to authoritative sources (academic papers, industry reports, primary sources).
- Avoid citing other content marketing pages (citation laundering).
- Date the source; sources older than 3 years for fast-moving topics need refresh.
Detail in references/fact-accuracy-and-citation-discipline.md.
Structure and clarity check
Does the piece work as a piece?
- Lede. First 200 words answer the user's likely query (for SEO/AEO pieces) OR establish the thesis (for thought leadership).
- Sectioning. H2s map to user mental model, not writer enthusiasm.
- Section length. Even-ish across H2s. One massive section plus four 80-word sections signals broken structure.
- Reading flow. Paragraphs connect, sentences vary in length.
- Specificity vs abstraction. Claims are concrete, not vague.
- Endings. Piece concludes with something specific (action, question, idea), not throat-clearing filler.
Detail in references/structure-and-clarity-review.md.
AI-content audit
The QA check that did not exist as prominently 2 years ago. AI-co-authored content has detectable patterns even when written by a competent human editor.
AI tells (pattern recognition).
- Excessive em-dashes (model-default punctuation)
- Predictable opening phrasings (throat-clearing openers that announce what the piece is about to do; the fast-paced-world opener, the importance-noting opener, the whether-you-are-X-or-Y opener)
- Predictable concluding paragraphs (throat-clearing wrap-ups, "By following these steps")
- Bullet-list overuse where prose would serve
- "On the other hand" / "However" overuse
- Forced bilateral framing (always "two sides" even when one side is right)
- Sentence-end filler ("...and more.", "...among other things.", "...for example.")
- Repetitive sentence-rhythm (every paragraph 2-3 sentences, similar lengths)
- Generic openings (descriptive paragraphs that could open any article on the topic)
- Bridging fluff ("That said", "With that in mind", "Moving on")
- Hedge stacking ("typically", "generally", "often") on claims that should be specific
Hallucination patterns (factual errors).
- Statistics that look authoritative (specific decimal places, named source) but the source does not exist or does not say that
- Quotes attributed to real people who did not say it
- Case studies about companies that do not exist
- Citations to URLs that 404 or never existed
- "Studies show" claims with no actual study behind them
- Made-up product features
Voice drift.
- Piece starts in brand voice, drifts to generic by section 4
- Vocabulary regresses to model defaults
- Stance becomes diplomatic ("there are good arguments on all sides") when brand stance was clear
The audit shape. Read with these patterns top-of-mind. Flag any match. The bar is not "AI was used" (it almost always is now); the bar is "would a careful human editor have shipped this." If the patterns above are present, the piece needs another revision pass with the patterns called out.
Detail in references/ai-content-audit-patterns.md.
SEO and AEO compliance check
Does the piece serve search engines AND answer engines?
SEO checks.
- Tar
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
