new

refresh

memory/content/

• Reads: the brief, target keywords, page intent, entity inputs,

  memory/projections/narrative.json

  , and

  memory/projections/claims.json

  (new); those same truth projections plus candidate URL/content, traffic/ranking history, publish/update dates, and competitor examples (refresh).
• Writes: a user-facing content deliverable and, with permission, a dated artifact under

  memory/content/content-writer/

  ; unresolved durable claims are submitted through

  registry-events.py

  as authorized

  operation: propose

  events.
• Done when: (new) the draft satisfies target intent with natural keyword use, H1/H2 structure, meta description, one snippet-targetable block, and evidence-safe claims; (refresh) decay drivers and concrete updates are documented; both modes report

  narrative_canon_id

  ,

  narrative_canon_version

  ,

  claims_projection_offset

  , and

  dependency_status

  .
• Primary next skill: content-quality-auditor to gate the draft or refreshed page before publishing.

Emit the standard shape from skill-contract.md §Handoff Summary Format, including the Narrative/claims dependency tuple.

1. Gather Requirements — confirm primary/secondary keywords, word count, content type, audience, intent, tone, CTA, and competitors.
2. Load CORE-EEAT Constraints — apply the 16 high-weight items (C01/C02/C03/C06/C10, O01/O02/O06/O08/O09/O10, R01/R02/R04/R07, E07).
3. Research and Plan — analyze the SERP format and depth, map keyword variants, and pick the differentiating angle.
4. Create Optimized Title — 2-3 options, each with length, keyword position, and rationale; keyword-led and intent-aligned.
5. Write Meta Description — one recommended line with keyword, value proposition, and CTA.
6. Structure and Write — H1 → hook intro (keyword early) → H2/H3 matching intent → FAQ → conclusion with recap + next step.
7. Apply On-Page Best Practices — keyword in title/H1/first 100 words/one H2/conclusion (no stuffing); 3-5 sentence paragraphs; tables/lists/bolding where they aid scanning; FAQ answers 40-60 words.
8. Add Internal / External Links — 2-5 internal links with descriptive anchors; 2-3 authoritative external links tied to specific claims.
9. Final SEO + CORE-EEAT Self-Check — score the 10 SEO factors, auto-fix small issues into a

   ### Changes Made

   table, and surface decisions that still need the user.

1. CORE-EEAT Quick Score — estimate all 8 dimensions, prioritize red/yellow areas, and hand full scoring to content-quality-auditor when needed.
2. Identify Refresh Candidates — use age, dated claims, declining traffic, lost rankings, broken links, SERP shifts, and missing topics. Numeric decline trigger: flag a page when organic traffic drops more than 30% against its trailing baseline (the page's own median over the prior comparable window — e.g., last 28 days vs the 28 before, or YoY for seasonal pages). Mark the drop Measured from analytics, Estimated otherwise. See references/content-decay-signals.md for the severity thresholds and composite decay score.
3. Analyze Page-Level Decay — compare 6-month-old vs current performance, keyword deltas, SERP intent, competitor updates, and the why-refresh rationale.
4. Define Updates Needed — capture outdated elements, competitor/PAA gaps, SEO updates, GEO updates, links, images, sources, and dates.
5. Create Refresh Plan — specify title, structure, new sections, refreshed statistics, internal/external links, images, and validation requirements.
6. Write Refresh Content — draft updated intro, replacement sections, refreshed facts, FAQ answers, and a

   ### Changes Made

   block.
7. Optimize for GEO — add 40-60 word definitions, quotable standalone statements, Q&A, and dated citations.
8. Set Republishing Strategy — published-date update for 50%+ new content, last-updated date for 20-50%, original date for <20%; update schema, sitemap

   lastmod

   , cache, and Search Console; read back traffic and rankings at 7/14/28/56 days against a control set of un-refreshed pages — see measurement-protocol.md.
9. Create Refresh Report — summarize completed changes, expected outcomes, owners, next review date, and open loops.

• (refresh) A page is decayed enough that a rewrite may beat a refresh (outdated premise, intent shift, or >50% content stale) — state the finding and ask: (1) refresh in place, or (2) rewrite as net-new via

  --mode new

  .
• (either) No target keyword and no existing URL are provided and none is inferable from context — present the two starting options rather than guessing a topic.

• Missing analytics/ranking history — score decay from on-page signals (dated claims, broken links, stale stats), label findings Estimated, and proceed.
• A "refresh" request with no existing URL — note the mismatch once and run

  --mode new

  .
• Which republish-date treatment to apply — follow the Step 8 thresholds without asking.
• Which competitor pages to deep-dive when several are named — pick the top-ranking 3 and proceed.

• Instructions Detail — new-mode workflow, the 16 CORE-EEAT constraints, issue classification, and self-check format
• SEO Writing Checklist — on-page checklist, snippet patterns, and copy-start template
• Title Formulas — headline formulas and CTR patterns
• Content Structure Templates — how-to, comparison, listicle, pillar, review, and FAQ blueprints
• Content Decay Signals — decay indicators, severity thresholds, composite decay score, refresh-vs-rewrite and retirement rules
• Refresh Templates — compact templates for refresh steps 2-9
• Refresh Example & Checklist — full worked refresh example and pre/post-refresh checklist
• Measurement Protocol — refresh readback windows (7/14/28/56 days) and judging impact against a control
• Humanizer Slop Check — pre-publish self-check that strips AI-slop phrasing before handoff

• Primary: content-quality-auditor — gate the draft (new) or re-score the refreshed page (refresh) before publishing.
• Conditional: geo-content-optimizer when the draft is ready but AI-citation/GEO readiness is the open question.

max-depth: 3