rampstackco/claude-skills / skills/content-brief-authoring
content-brief-authoring
VerifiedHow to author a content brief that actually guides a writer (human or AI) to produce a piece that ranks, converts, or both. Per-piece editorial brief: target keyword and cluster, search intent, audience and JTBD, heading structure, entity coverage for AEO/GEO, internal linking strategy, success criteria. The middle path between thin briefs (a keyword and a deadline) and thick briefs (a 4-page document nobody reads). Triggers on content brief, brief the writer, brief the article, brief authoring, content brief template, brief audit, per-piece brief, editorial brief, target keyword brief, search intent brief. Also triggers when briefing a human writer or an AI agent on a single content piece.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 364 B |
| SKILL.md | skill md | 22.0 KB |
| references/brief-governance-patterns.md | markdown | 5.9 KB |
| references/brief-templates.md | markdown | 7.6 KB |
| references/common-brief-failures.md | markdown | 7.6 KB |
| references/entity-coverage-checklist.md | markdown | 5.6 KB |
| references/heading-structure-patterns.md | markdown | 5.3 KB |
| references/internal-linking-strategy.md | markdown | 5.5 KB |
| references/search-intent-classification.md | markdown | 4.7 KB |
| references/writer-handoff-protocols.md | markdown | 6.0 KB |
references/internal-linking-strategy.md
View on GitHub# Internal linking strategy
Outbound and inbound linking patterns, orphan-content prevention, self-cannibalization check.
---
## Two link directions to specify
Every brief specifies links in two directions.
**Outbound from this piece.** 3 to 5 pages this piece should link to. Anchor text and target page named explicitly. The writer is not deciding internal links during drafting; the strategist already knows the cluster and which pieces should reinforce each other.
**Inbound to this piece, post-publish.** 1 to 3 existing pages that should add a link to this piece after it publishes. This is a follow-up task queued in the brief, not a request to the writer.
---
## Outbound link selection
The cluster pieces. The brief lists the supporting cluster pieces this piece should link to, with anchor text that matches each target's primary keyword.
**Example for a pillar piece on "experimentation analytics dashboards":**
> **Outbound links (writer integrates)**
>
> 1. Link to "CUPED variance reduction" (cluster piece) using anchor "CUPED" or "variance reduction with CUPED" in the methodology H2.
> 2. Link to "warehouse-native experimentation" (sister pillar) using anchor "warehouse-native experimentation" in the platform-vs-warehouse comparison H2.
> 3. Link to "feature flag tools comparison" (commercial-intent piece) using anchor "feature flag tools" in the deployment H2.
> 4. Link to "data warehouse setup" (foundation piece) using anchor "data warehouse" in the prerequisites H2.
The discipline: anchor text matches the target's primary keyword. Generic anchors ("click here," "this article") do not pass ranking signals; keyword anchors do.
---
## Inbound link queue
The brief queues 1 to 3 existing pages that should add a link to the new piece after it publishes. The strategist updates these as part of the publish checklist.
**Example continuing the same pillar:**
> **Inbound link updates (post-publish task)**
>
> 1. Update "feature flagging" pillar to link to the new piece in the "measuring feature impact" section using anchor "experimentation analytics dashboards."
> 2. Update "PostHog vs Statsig" comparison to link to the new piece in the analytics-comparison H2.
> 3. Update homepage "Resources" section to add the new piece to the "Pillars" list.
The inbound queue prevents the orphan-content failure mode.
---
## The orphan-content failure mode
Symptom: piece publishes, no other piece links to it, search engines deprioritize it, AI engines do not see it as cluster-anchored.
Cause: internal linking was an afterthought, handled by the writer or by SEO at publish time without strategic intent. The writer linked out to 3 pages because the brief said to; nobody linked back in because nobody owned that task.
Fix: the brief queues the inbound updates explicitly. The publish checklist includes the inbound updates as a tracked task. Without a tracked task, the inbound updates do not happen; without inbound links, the piece is an orphan.
The "5-link rule" diagnostic. Every published piece should have at least 5 internal links pointing to it within 30 days of publish. If a piece has fewer than 5 inbound links at the 30-day check, audit the inbound queue and add the missing links.
---
## The self-cannibalization check
Before briefing a new piece, check whether it would compete with an existing piece for the same keyword cluster.
**The check.** Search the site for the target keyword. If an existing piece is in the top 5 of internal search results, flag it.
**Three options when self-cannibalization is detected:**
1. **Consolidate.** Merge the planned piece into the existing piece. Update the existing piece with the new angle, the new entities, the new examples. Keep one URL ranking; do not split ranking authority across two URLs.
2. **Differentiate.** Sharpen the angle of the new piece so it does not compete. The existing piece covers "what is feature flagging"; the new piece covers "feature flag rollout strategies for enterprise teams." Different intent, different audience, different SERP target.
3. **Kill one.** Determine which piece serves the cluster better. Redirect the loser to the winner. This is rare and usually signals the program does not have clear pillar structure.
The discipline: flag self-cannibalization in the brief, not after the piece is written. Late detection is the expensive failure mode; the writer has already invested hours that now have to be either rewritten or thrown away.
---
## Brief field: how to populate internal linking
> **Internal linking**
>
> **Outbound (3 specified, 2 optional)**
> - Required: link to "CUPED variance reduction" with anchor "CUPED" in methodology H2
> - Required: link to "warehouse-native experimentation" with anchor "warehouse-native" in comparison H2
> - Required: link to "feature flag tools 2026" with anchor "feature flag tools" in deployment H2
> - Optional: link to "data warehouse setup" with anchor "data warehouse" in prerequisites H2 (writer's call based on flow)
> - Optional: link to "experiment-design skill" with anchor "experiment design" in introduction (writer's call)
>
> **Inbound (post-publish, queued)**
> - Update "feature flagging" pillar (insert link in section 4)
> - Update "PostHog vs Statsig" comparison (insert link in analytics-comparison H2)
>
> **Self-cannibalization check**
> - Existing pieces on adjacent keywords: "experiment dashboards introduction" (different angle, no conflict)
> - No conflict; proceed with brief
The brief is explicit about what is required, what is optional (writer chooses), and what is queued for post-publish. Three layers of discipline.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |