CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is editorial-qa in rampstackco/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured instructional skill with excellent progressive disclosure, concrete thresholds, and a clearly sequenced QA workflow with halt conditions. Its main cost is repetition — the thin/thick QA framing and litmus test each appear multiple times, inflating the token budget without adding guidance value.

Suggestions

Cut the duplicated thin/thick QA narrative: keep the full treatment in 'Catch-problems QA vs checkbox QA' and reduce the intro paragraph to a one-sentence pointer, saving roughly a paragraph of tokens.

Drop or compress the 'Closing' section — it restates the litmus test and checklist already covered in 'Catch-problems QA vs checkbox QA' and 'The framework' — and fold its final readiness questions into the framework section.

For judgment-style checks (e.g., 'Reading flow', 'Specificity vs abstraction'), add a one-line pass/fail heuristic or pointer to the concrete examples in the relevant reference file so the check is executable rather than descriptive.

DimensionReasoningScore

Conciseness

The thin/thick QA narrative is stated twice — fully in the intro ("The thin version is 'did I read it once…' … The thick version is a 47-item checklist") and again in its own dedicated section — and the closing section re-summarizes the litmus test already covered in "Catch-problems QA vs checkbox QA". Most content is domain-specific methodology rather than concepts Claude already knows, so this sits at 'mostly efficient but could be tightened' rather than verbose.

3 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: specific thresholds ("more than 5% of sampled pages fail the manual review, halt new generation", "40 to 60 word answer paragraph", "3 to 7 for typical 1,500-word piece"), named AI tells, and a halt/flag/auto-fix taxonomy. Minor gaps remain where checks are judgment descriptions rather than how-to ("Paragraphs connect, sentences vary in length", "Claims are concrete, not vague").

4 / 5

Workflow Clarity

The sequence is explicit ("Brief-adherence to fact-accuracy to structure to AI-audit to voice to SEO/AEO to linking to schema") with halt conditions named per gate and a threshold-gating feedback loop (fail → halt generation → fix → resume → document breach). Not a 5 because the actual gate list and order are delegated to the reference template rather than fully inline, and the per-piece QA loop lacks an explicit re-check-after-revision step.

4 / 5

Progressive Disclosure

The body is a genuine overview: each section distills its check set and signals "Detail in [references/…]" to one of ten real, one-level-deep reference files, consolidated in an annotated "Reference files" list. All referenced paths exist in the bundle, and reference files do not nest further references, making navigation easy.

5 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: comprehensive, specific capability listing, explicit multi-phrase trigger guidance, and an explicit boundary against the closest competing skill. The only gap is a handful of natural trigger synonyms (fact-check, proofread) that would make triggering even more reliable.

DimensionReasoningScore

Specificity

The description lists the full capability set — "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" — comprehensively mirroring every section of the skill with no coverage gaps.

5 / 5

Completeness

Both halves are explicit: the 'what' is the concrete capability list, and the 'when' is a dedicated "Triggers on…" clause with concrete trigger phrases plus additional scenario triggers ("when a content team is shipping sloppy work, when AI-co-authored content is reaching publish unaudited"). This matches the anchor-5 example structure of explicit what-and-when with concrete triggers.

5 / 5

Trigger Term Quality

"Triggers on editorial QA, content review, pre-publish review, content audit, content QA process, AI-content audit, hallucination check, content sampling, programmatic QA" gives strong natural coverage, but common variations users would say ("fact-check", "proofread", "pre-publish checklist") are missing. Not a 5 because the anchor requires comprehensive synonym coverage; clearly above the midpoint because ten explicit trigger phrases plus four scenario triggers go well beyond 'a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

The pre-publish gate niche ("verifies before publish") is distinct from sibling content-suite skills, and the description actively disambiguates: "use `brand-voice` when the voice system itself needs defining or documenting." Triggers are QA-specific (audit, hallucination check, sampling), minimizing wrong-skill activation.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

rampstackco/claude-skills

Path

dist/codex/.agents/skills/editorial-qa/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.