Content Semantics Stinger

---
name: "content-semantics-stinger"
description: "Quantified reading-level estimate (Flesch Reading Ease/Grade Level) plus a subjective ICP-relevancy score per crawled page, kept in separate sections. Wave W5."
license: AGPL-3.0-or-later
compatibility: "Claude Code, Cursor, ChatGPT Codex, Claude Cowork."
metadata:
  hive-tier: stinger
  hive-drone: content-semantics-wasp-drone
  research-window: "2026-08-18 (single sweep, two clusters: seo-standards, aeo-and-answer-engines)"
  primary-surface: external-website-audit
---

# Content Semantics Stinger

> **Forge status:** stages 1-6 complete (Topic, Research, Distillation, References, Guides, final authorship). Stage 7 (registration/deployment sync) has not run. Every content-quality/AEO claim below traces to `references/research/raw/` via the distillation at `references/research/distilled-content-semantics.md`. One explicit exception, stated wherever it matters: the Flesch Reading Ease / Flesch-Kincaid Grade Level formula this pair uses to satisfy PRD-010 AC-1 is NOT sourced from this Stinger's research archive (that archive has zero readability-formula coverage, confirmed in the distillation's own section 8 gap note); it is a well-established public-domain formula applied as this Stinger's own judgment call, disclosed as such in `references/scripts/reading-level.py`'s docstring and in guide 1.

You are equipping **content-semantics-wasp-drone**, part of the Website
Auditor by Legion Code Inc. plugin. Full scope and acceptance criteria:
[prd-010-content-semantics](../../library/requirements/backlog/prd-010-content-semantics/prd-010-content-semantics-index.md).

## Purpose

Produce the run's `03-seo/content-semantics.md` sub-audit: a quantified,
formula-shown reading-level estimate for every crawled page, and a
separately-labeled `[subjective]` ICP-relevancy score per page against the
ICP `icp-positioning-stinger` already determined. These are two
independent findings about the same page and must never be merged into one
number or one section; a page can be effortlessly readable and completely
off-ICP, or dense and jargon-heavy yet exactly on-ICP for a technical
buyer persona.

## When to use

- Wave W5 of every audit run, reading `site-data/` and `02-positioning/`
  (both read-only)
- Distinguishing a genuinely low-reading-level page from one that is
  merely off-ICP; the two are commonly conflated and this Stinger exists
  specifically to keep them apart
- Judging whether a page clears Google's stated "non-commodity content"
  bar as one input to the ICP-relevancy score

## When not to use

- Technical structure, metadata, indexation, or internal-link-graph
  analysis of the same pages. That is `technical-seo-stinger`'s and
  `internal-linking-stinger`'s scope respectively.
- Determining the site's niche, ICP, or conversion-action taxonomy from
  scratch. That is `icp-positioning-stinger`'s scope; this Stinger applies
  its output, never re-derives it.
- Crawling or fetching a page not already in `site-data/`. This Stinger
  never crawls; that is `site-crawler-wasp-drone`'s job.

## Procedure

1. Run `references/scripts/reading-level.py` against `site-data/*.md` to
   produce the quantified reading-level estimate (word/sentence/syllable
   counts, Flesch Reading Ease, Flesch-Kincaid Grade) per page, stating the
   formula-choice grounding caveat explicitly. See
   `guides/01-reading-level-scoring.md`.
2. Read `02-positioning/`'s ICP and conversion-action taxonomy (do not
   re-derive it) and apply `references/templates/icp-relevancy-scoring-
   rubric-template.md` to score every page's `[subjective]` ICP-relevancy,
   including the non-commodity-content check. See
   `guides/02-icp-relevancy-scoring.md`.
3. Observe and report the supporting content-structure signals (lead-
   paragraph length against both cited ranges, heading structure, schema
   presence) that inform the ICP-relevancy judgment, each with its
   sourcing caveat. See `guides/03-content-structure-signals.md`.
4. Assemble `03-seo/content-semantics.md` from
   `references/templates/content-semantics-report-template.md`, keeping
   the quantified and subjective sections clearly separate, fill the
   findings-register rows, and log any rejected/reframed candidate. See
   `guides/04-report-assembly.md`.

## References map

- `references/research/distilled-content-semantics.md`, load when a claim
  needs verification, or to check section 8's gap list before assuming
  this archive covers something it does not (readability formulas,
  ICP-scoring methodology).
- `references/research/raw/`, load when tracing a distilled claim back to
  its primary source.
- `references/scripts/reading-level.py`, run once per audit against
  `site-data/*.md`; do not hand-count words, sentences, or syllables. Its
  docstring carries the formula-grounding caveat in full.
- `references/templates/content-semantics-report-template.md`, load when
  assembling `03-seo/content-semantics.md`.
- `references/templates/icp-relevancy-scoring-rubric-template.md`, load
  when scoring the `[subjective]` ICP-relevancy checkpoint; bridges the
  build plan's universal zero-to-six scale to this specific checkpoint.
- `guides/01-reading-level-scoring.md` through
  `guides/04-report-assembly.md`, load in order for a full pass; each maps
  to one section of the report template.

## Related drones and stingers

- [icp-positioning-stinger](../icp-positioning-stinger) - owns the ICP,
  niche, and conversion-action taxonomy this Stinger applies to score
  page-level relevancy. Read its output, never duplicate its taxonomy.
- [internal-linking-stinger](../internal-linking-stinger) - sibling
  wave-W5 Stinger over the same `site-data/`, link-structure analysis
  rather than copy quality; runs concurrently, no write contention.
- [technical-seo-stinger](../technical-seo-stinger) - owns the technical
  structure, metadata, and indexation sub-audit for the same page set;
  content quality (this Stinger) and technical structure are scored
  separately per the build plan's weight table.
- [content-semantics-wasp-drone](../../agents/content-semantics-wasp-drone.md) -
  this Stinger's paired Drone.

## Critical Directive

- You must read all files and context contained within your skill.
- In the event your core knowledge does not provide sufficient guidance you must make every attempt to search the internet, related knowledge base documentation files, and other available resources to supplement your knowledge prior to proceeding with your task.
- Additional related skills can be found here:
  - [icp-positioning-stinger](../icp-positioning-stinger) - ICP and conversion-action taxonomy this Stinger applies but does not own.
  - [internal-linking-stinger](../internal-linking-stinger) - sibling wave-W5 Stinger, link structure rather than copy quality.
  - [technical-seo-stinger](../technical-seo-stinger) - technical structure/metadata sub-audit over the same page set.

## Ship Gate

Ship Gate removed: research-only stinger, produces no committable code.
This Stinger's output is a findings report (`03-seo/content-semantics.md`)
written to the target audit workspace outside this repository; it never
proposes a diff or a commit to this plugin's own tracked source, so the
security-stinger / quality-stinger / github-repo-health-stinger close-out
sequence does not apply.