opencode-skills-collection 4.0.64 → 4.0.65

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. package/bundled-skills/.antigravity-install-manifest.json +3 -1
  2. package/bundled-skills/antigravity-maintainer-batch-release/SKILL.md +1 -1
  3. package/bundled-skills/seo-aeo-blog-writer/SKILL.md +140 -59
  4. package/bundled-skills/seo-aeo-content-cluster/SKILL.md +180 -61
  5. package/bundled-skills/seo-aeo-content-quality-auditor/SKILL.md +221 -64
  6. package/bundled-skills/seo-aeo-content-quality-auditor/references/seo-audit-checklist.md +63 -0
  7. package/bundled-skills/seo-aeo-internal-linking/SKILL.md +220 -59
  8. package/bundled-skills/seo-aeo-keyword-research/SKILL.md +297 -76
  9. package/bundled-skills/seo-aeo-landing-page-writer/SKILL.md +116 -83
  10. package/bundled-skills/seo-aeo-meta-description-generator/SKILL.md +316 -62
  11. package/bundled-skills/seo-aeo-orchestrator/SKILL.md +281 -0
  12. package/bundled-skills/seo-aeo-schema-generator/SKILL.md +302 -68
  13. package/bundled-skills/seo-aeo-schema-generator/references/aggregate-rating-schema.json +8 -0
  14. package/bundled-skills/seo-aeo-schema-generator/references/article-schema.json +10 -0
  15. package/bundled-skills/seo-aeo-schema-generator/references/breadcrumb-schema.json +5 -0
  16. package/bundled-skills/seo-aeo-schema-generator/references/faq-schema.json +5 -0
  17. package/bundled-skills/seo-aeo-schema-generator/references/howto-schema.json +7 -0
  18. package/bundled-skills/seo-aeo-schema-generator/references/organization-schema.json +7 -0
  19. package/bundled-skills/seo-aeo-schema-generator/references/product-schema.json +8 -0
  20. package/bundled-skills/seo-aeo-schema-generator/references/review-schema.json +8 -0
  21. package/bundled-skills/seo-aeo-schema-generator/references/webpage-schema.json +7 -0
  22. package/bundled-skills/seo-aeo-schema-generator/references/website-schema.json +7 -0
  23. package/bundled-skills/youtube-transcript-skills/SKILL.md +110 -0
  24. package/package.json +1 -1
  25. package/skills_index.json +65 -8
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "updatedAt": "2026-09-16T02:03:41.825Z",
3
+ "updatedAt": "2026-09-17T02:07:42.936Z",
4
4
  "entries": [
5
5
  "00-andruia-consultant",
6
6
  "007",
@@ -1698,6 +1698,7 @@
1698
1698
  "seo-aeo-keyword-research",
1699
1699
  "seo-aeo-landing-page-writer",
1700
1700
  "seo-aeo-meta-description-generator",
1701
+ "seo-aeo-orchestrator",
1701
1702
  "seo-aeo-schema-generator",
1702
1703
  "seo-audit",
1703
1704
  "seo-authority-builder",
@@ -2115,6 +2116,7 @@
2115
2116
  "youtube-seo-optimizer",
2116
2117
  "youtube-summarizer",
2117
2118
  "youtube-transcript",
2119
+ "youtube-transcript-skills",
2118
2120
  "zapier-make-patterns",
2119
2121
  "zcode-delegate",
2120
2122
  "zendesk-automation",
@@ -55,7 +55,7 @@ Before changing anything:
55
55
  - Use the repository validation, test, docs-security, source-credit, reference, warning-budget, and targeted app checks required by the changed files.
56
56
  - Fix deterministic policy failures in the source; do not wait for them as if they were flaky CI.
57
57
  - For source-only changed paths, a Git copy changes only its destination; renames change both paths. Preserve independent raw-record and blob safety checks and regressions for genuine generated-file mutations.
58
- - Treat `pr-policy` fork classification from the exact protected-base implementation as an unprivileged fail-fast gate before dependent work, never as approval authority. Install and resolve every dependency used by that classifier from the same protected-base worktree; never expose it to pull-request-controlled `node_modules`. `merge:batch` must still recompute the current trusted decision before approving any fork run or merging.
58
+ - Treat `pr-policy` fork classification from the exact protected-base implementation as an unprivileged fail-fast gate before dependent work, never as approval authority. Install and resolve every dependency used by that classifier from the same protected-base worktree; never expose it to pull-request-controlled `node_modules`. `merge:batch` must still recompute the current trusted decision before approving any fork run or merging. The intake allowlist also covers browser source under `apps/web-app/src/**` (`.css`, `.ts`, `.tsx`); those fork runs may be approved, but every web-app source change still requires an exact-head maintainer attestation before merge.
59
59
  - Treat `impact_profile` as shadow-only telemetry. It must not skip, downgrade, or satisfy any required check.
60
60
  - For ordinary source PRs, require `source-validation` to generate preview state once and `artifact-preview` to verify the manifest bound to the exact head and run identity. For canonical-sync PRs, rely on `pr-policy` exact-tree reproduction, keep `source-validation` lightweight, require `artifact-preview` to confirm no drift, and retain final CI and CodeQL on the merged `main` commit.
61
61
  - Keep timing observational and test sharding opt-in. Required CI must continue to run the full unsharded `npm run test`; deterministic local shards may be used only through `npm run test:local -- --shard-index N --shard-count M`.
@@ -1,93 +1,174 @@
1
1
  ---
2
2
  name: seo-aeo-blog-writer
3
- description: "Writes long-form blog posts with TL;DR block, definition sentence, comparison table, and 5-question FAQ for SEO ranking and AEO citation. Activate when the user wants to write a blog post, article, or long-form content piece."
3
+ description: "Writes search-intent-led long-form articles with answer-first structure, FAQ coverage, internal links, and conversion paths for SEO and AEO."
4
4
  risk: safe
5
5
  source: community
6
6
  date_added: "2026-04-01"
7
7
  ---
8
8
 
9
- # SEO-AEO Blog Writer
9
+ # Blog Writer Skill
10
+
11
+ ## Description
12
+ Activate this skill when the user wants to write a blog post, article, or
13
+ long-form content piece for SEO and AEO purposes. Trigger phrases include:
14
+ "write a blog post", "create an article", "generate blog content",
15
+ "write a long-form post about", "blog writer".
16
+
17
+ ## Input Format
18
+ ```json
19
+ {
20
+ "topic": "string — the main subject of the article",
21
+ "primary_keyword": "string — exact keyword to rank for",
22
+ "secondary_keywords": ["string", "string"],
23
+ "target_audience": "string — who is reading this",
24
+ "tone": "informational | conversational | authoritative | persuasive",
25
+ "word_count": "integer — minimum 800, maximum 3000, default 1500",
26
+ "cluster_context": "string — optional, paste content cluster output here",
27
+ "internal_link_targets": ["string — page/post titles to link to"],
28
+ "product_cta": "string — optional CTA and destination",
29
+ "search_intent_evidence": "string — optional observed SERP/API evidence",
30
+ "distribution_platforms": ["string — optional external platforms"]
31
+ }
32
+ ```
33
+
34
+ Write to the dominant search intent, not merely the keyword. The article should solve a recognizable problem and make the next product action clear without turning an informational article into an unsupported sales pitch.
35
+
36
+ ## Output Structure
37
+
38
+ The skill must always produce a blog post in this exact section order:
39
+ ```markdown
40
+ # [H1: Primary Keyword-Optimised Title]
41
+
42
+ > **TL;DR:** [2–3 sentence direct answer to the article's core question.
43
+ > This is the AEO extraction block — write it to be lifted by AI engines.]
44
+
45
+ ## Introduction
46
+ [Hook sentence. State the problem or question clearly in the first 2 lines.
47
+ Mention the primary keyword naturally within the first 100 words.]
10
48
 
11
- ## Overview
49
+ ---
50
+
51
+ ## [H2: What Is {Topic}]
52
+ [Definition block — write a single, clean, extractable definition sentence
53
+ as the very first line of this section. Follow with 2–3 paragraphs of context.]
54
+
55
+ ---
56
+
57
+ ## [H2: Why {Topic} Matters / The Core Problem]
58
+ [Establish relevance. Use bullet points or a numbered list in this section.]
59
+
60
+ ---
61
+
62
+ ## [H2: How {Topic} Works / Main Body Section]
63
+ [Deepest section. Use H3 subheadings for sub-concepts. Include at least
64
+ one comparison block formatted as a table if comparing two or more things.]
65
+
66
+ ### [H3: Sub-concept 1]
67
+ ### [H3: Sub-concept 2]
68
+ ### [H3: Sub-concept 3]
69
+
70
+ ---
71
+
72
+ ## [H2: Practical Steps / How To Section — if applicable]
73
+ [Numbered list of steps. Each step max 2 sentences. Scannable.]
74
+
75
+ ---
12
76
 
13
- Writes structured long-form blog posts (800–3000 words) that satisfy both SEO ranking signals and AEO citation requirements. Every post includes a TL;DR direct-answer block, a definition sentence, structured H2/H3 hierarchy, a comparison table where relevant, and exactly 5 FAQ entries written for AI extraction.
77
+ ## [H2: Common Mistakes / What To Avoid if applicable]
78
+ [Bullet list format. Short, punchy, extractable by AI.]
14
79
 
15
- Part of the [SEO-AEO Engine](https://github.com/mrprewsh/seo-aeo-engine).
80
+ ---
16
81
 
17
- ## When to Use This Skill
82
+ ## Frequently Asked Questions
18
83
 
19
- - Use when writing a cluster article from a content cluster map
20
- - Use when creating a long-form guide to build topical authority
21
- - Use when you need content that can be cited by AI engines like Perplexity or ChatGPT
22
- - Use when you need a blog post that follows a consistent, auditable structure
84
+ **Q: [Question using a long-tail keyword]**
85
+ A: [Direct answer, 2–3 sentences max. No fluff.]
23
86
 
24
- ## How It Works
87
+ **Q: [Question using a secondary keyword]**
88
+ A: [Direct answer.]
25
89
 
26
- ### Step 1: Write the TL;DR Block First
27
- Write a 2–3 sentence direct answer to the article's core question. Place it immediately after the H1 in a blockquote. This is the first block AI engines attempt to extract.
90
+ **Q: [Question the target audience commonly asks]**
91
+ A: [Direct answer.]
28
92
 
29
- ### Step 2: Build the Heading Skeleton
30
- Set H1, H2s (4–6), and H3s before writing any body content. The first H2 must be a "What Is" section with a clean definition sentence as its opening line.
93
+ **Q: [Question about cost, time, or comparison]**
94
+ A: [Direct answer.]
31
95
 
32
- ### Step 3: Write Body Sections
33
- Follow the section order: What Is → Why It Matters → How It Works (with H3 sub-concepts) → Practical Steps → Common Mistakes → FAQ → Conclusion.
96
+ **Q: [Question about a common misconception]**
97
+ A: [Direct answer.]
34
98
 
35
- ### Step 4: Write 5 FAQ Entries
36
- Use long-tail and secondary keywords as questions. Each answer must be under 50 words and self-contained — readable without any surrounding context.
99
+ ---
37
100
 
38
- ### Step 5: Run AEO and SEO Checklists
39
- Verify TL;DR presence, definition sentence, FAQ count, keyword placement, and heading structure before outputting.
101
+ ## Conclusion
102
+ [Restate the core answer from the TL;DR in new words.
103
+ One call to action sentence at the end.]
40
104
 
41
- ## Examples
105
+ ---
42
106
 
43
- ### Example: TL;DR Block
44
- How to Manage a Remote Engineering Team
107
+ ## Internal Links
108
+ [INTERNAL LINK: {internal_link_target_1}]
109
+ [INTERNAL LINK: {internal_link_target_2}]
45
110
 
46
- TL;DR: Managing a remote engineering team requires async
47
- communication tools, clear documentation standards, and
48
- timezone-aware sprint planning. Teams that nail these three
49
- areas ship consistently regardless of where members are located.
111
+ ## External Links
112
+ [EXTERNAL LINK: authoritative source relevant to primary keyword]
50
113
 
114
+ ## Product CTA
115
+ [CTA: relevant product action and destination]
51
116
 
52
- ### Example: FAQ Section
53
- Q: What is the biggest challenge of remote engineering teams?
54
- A: Async communication. Without shared hours, decisions slow down
55
- and context gets lost. Teams that document decisions in writing
56
- and use structured standup tools close this gap fastest.
57
- Q: How do you run a daily standup with a remote team?
58
- A: Use async video or text standups posted at the start of each
59
- member's day. Tools like Loom or Slack threads work well.
60
- Avoid live calls across more than 2 timezones.
117
+ ## External Distribution Notes
118
+ - [Platform]: [adaptation angle, canonical-link decision, and backlink target]
119
+ ```
61
120
 
62
- ## Best Practices
121
+ ---
63
122
 
64
- - **Do:** Write the TL;DR block before writing anything else — it anchors the article
65
- - **Do:** Make the "What Is" definition sentence extractable on its own — one clean sentence
66
- - ✅ **Do:** Use secondary keywords as FAQ questions to capture long-tail traffic
67
- - ❌ **Don't:** Write FAQ answers longer than 50 words — AI engines skip long answers
68
- - ❌ **Don't:** Use duplicate H2 headings anywhere in the article
69
- - ❌ **Don't:** Skip the comparison table if the topic involves comparing options
123
+ ## AEO Requirements
124
+ Every blog post produced by this skill MUST contain:
70
125
 
71
- ## Common Pitfalls
126
+ - [ ] A TL;DR block immediately after the H1
127
+ - [ ] A clean definition sentence as the first line of the "What Is" section
128
+ - [ ] At least one comparison table (if topic involves comparing options)
129
+ - [ ] Exactly 5 FAQ entries with direct, concise answers
130
+ - [ ] Bullet or numbered lists in at least 2 sections
131
+ - [ ] Primary keyword in: H1, first 100 words, at least one H2, meta description
132
+ - [ ] A relevant product CTA or next step is present when the article supports conversion
133
+ - [ ] Internal links connect the article to a foundational page and, where relevant, the product
72
134
 
73
- - **Problem:** TL;DR block is too vague to be extracted as a direct answer
74
- **Solution:** The TL;DR must answer the article's core question in 2–3 sentences. If it doesn't answer a specific question, rewrite it.
135
+ ---
75
136
 
76
- - **Problem:** FAQ answers reference "as mentioned above" or other context
77
- **Solution:** Every FAQ answer must stand completely alone — no references to other parts of the article.
137
+ ## SEO Requirements
78
138
 
79
- ## Related Skills
139
+ - H1: appears exactly once, contains primary keyword
140
+ - H2s: 4–6 per article, no keyword stuffing
141
+ - H3s: used only inside H2 sections, not standalone
142
+ - Word count: stay within the range specified in input; default 1500 words
143
+ - Keyword use: natural and intent-aligned; do not force a density percentage
144
+ - No duplicate headings
80
145
 
81
- - `@seo-aeo-content-cluster` — provides the topic and keyword for this article
82
- - `@seo-aeo-content-quality-auditor` — audits the completed post for SEO and AEO signals
83
- - `@seo-aeo-internal-linking` — maps links between this post and related pages
146
+ ---
84
147
 
85
- ## Additional Resources
148
+ ## Execution Steps
86
149
 
87
- - [SEO-AEO Engine Repository](https://github.com/mrprewsh/seo-aeo-engine)
88
- - [Full Blog Writer SKILL.md](https://github.com/mrprewsh/seo-aeo-engine/blob/main/.agent/skills/blog-writer/SKILL.md)
150
+ 1. Read `cluster_context` if provided — use it to decide which sub-topics
151
+ to cover and which to leave for linked cluster articles
152
+ 2. Review `search_intent_evidence` if provided and state the problem the article solves
153
+ 3. Write the TL;DR block first — this anchors the whole article's direction
154
+ 4. Build the heading skeleton before writing body content
155
+ 5. Write the definition block in the "What Is" section as a single sentence
156
+ 6. Write the FAQ section using long-tail and secondary keywords as questions
157
+ 7. Insert internal links at natural transition points, including a foundational page and product CTA where appropriate
158
+ 8. Add external-source suggestions only when they are authoritative and relevant
159
+ 9. Do a final keyword placement check against the SEO Requirements checklist
160
+ 10. Do a final AEO, conversion, and claim-verification pass before outputting
161
+
162
+ ---
163
+
164
+ ## Connected Skills
165
+ - Receives output from: `seo-aeo-content-cluster`
166
+ - Feeds output to: `seo-aeo-content-quality-auditor`, `seo-aeo-internal-linking`
167
+
168
+ ## When to Use
169
+
170
+ Use when creating or revising a long-form article intended to capture a specific search intent and guide readers toward a relevant next step.
89
171
 
90
172
  ## Limitations
91
- - Use this skill only when the task clearly matches the scope described above.
92
- - Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
93
- - Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
173
+
174
+ - Search performance depends on the actual site, competition, content quality, and indexing; this skill cannot guarantee rankings or traffic.
@@ -1,94 +1,213 @@
1
1
  ---
2
2
  name: seo-aeo-content-cluster
3
- description: "Builds a topical authority map with a pillar page, prioritised cluster articles, content types, internal link map, and content gap analysis. Activate when the user wants to build a content cluster, topic map, or content strategy."
3
+ description: "Builds a topical authority map from business goals, search intent, existing content, and gaps, then prioritises foundational and supporting pages."
4
4
  risk: safe
5
5
  source: community
6
6
  date_added: "2026-04-01"
7
7
  ---
8
8
 
9
- # SEO-AEO Content Cluster
9
+ # Content Cluster Skill
10
10
 
11
- ## Overview
11
+ ## Description
12
+ Activate this skill when the user wants to build topical authority around
13
+ a subject by mapping out a pillar page and its supporting cluster articles.
14
+ Trigger phrases include: "build a content cluster", "create a topic map",
15
+ "content pillar strategy", "what should I write about for [topic]",
16
+ "cluster: [topic]", "generate a content strategy for [niche]".
12
17
 
13
- Maps out a complete topical authority structure around a pillar keyword. Produces a pillar page definition, 8–15 cluster articles sorted into Priority 1/2/3 tiers, a content type for each, an internal link map, and a content gap analysis identifying AEO opportunities competitors are missing.
18
+ ---
19
+
20
+ ## Input Format
21
+ ```json
22
+ {
23
+ "pillar_topic": "string — the main subject to build authority around",
24
+ "primary_keyword": "string — the keyword the pillar page targets",
25
+ "target_audience": "string — who this content is for",
26
+ "existing_content": ["string — titles of pages/posts already published"],
27
+ "target_keywords": ["string — additional keywords to work into the cluster"],
28
+ "cluster_size": "integer — foundational pages to generate, 5–10, default 10",
29
+ "search_intent_evidence": "string — optional browser/API research",
30
+ "conversion_goal": "string — what the content should move readers to do"
31
+ }
32
+ ```
33
+
34
+ For a new website, produce 5–10 foundational pages, defaulting to 10 only when there are at least 10 distinct, defensible search intents. Do not create near-duplicate pages to hit the default. Every page must solve a problem, own a query, and lead to a relevant product or next step.
35
+
36
+ ---
37
+
38
+ ## Output Structure
39
+
40
+ The skill must always produce output in this exact format:
41
+ ```markdown
42
+ ## Pillar Page
43
+
44
+ | Field | Value |
45
+ |--------------------|--------------------------------------------|
46
+ | Title | [Pillar page title with primary keyword] |
47
+ | Primary Keyword | [keyword] |
48
+ | Search Intent | informational / transactional / commercial |
49
+ | Target Audience | [audience] |
50
+ | Page Type | Pillar — comprehensive, high-level guide |
51
+ | Word Count Target | 2500–4000 words |
52
+ | AEO Priority | High — this page anchors the whole cluster |
53
+
54
+ ---
55
+
56
+ ## Cluster Articles
57
+
58
+ ### Priority 1 — Write These First
59
+ These articles build the foundation. High search volume, clear intent.
60
+
61
+ | # | Title | Target Keyword | Intent | Content Type | Links To |
62
+ |---|------------------------------|----------------------|-----------------|------------------|------------------|
63
+ | 1 | [Article title] | [keyword] | informational | how-to guide | Pillar Page |
64
+ | 2 | [Article title] | [keyword] | informational | explainer | Pillar Page |
65
+ | 3 | [Article title] | [keyword] | commercial | comparison | Pillar Page |
66
+
67
+ ---
68
+
69
+ ### Priority 2 — Write These Second
70
+ These deepen authority. Medium volume, long-tail focus.
71
+
72
+ | # | Title | Target Keyword | Intent | Content Type | Links To |
73
+ |---|------------------------------|----------------------|-----------------|------------------|------------------|
74
+ | 4 | [Article title] | [keyword] | informational | listicle | Art. 1, Pillar |
75
+ | 5 | [Article title] | [keyword] | transactional | case study | Art. 3, Pillar |
76
+ | 6 | [Article title] | [keyword] | informational | FAQ page | Art. 1, Art. 2 |
77
+
78
+ ---
14
79
 
15
- Part of the [SEO-AEO Engine](https://github.com/mrprewsh/seo-aeo-engine).
80
+ ### Priority 3 Write These Last
81
+ Long-tail reinforcement. Lower volume, high conversion intent.
16
82
 
17
- ## When to Use This Skill
83
+ | # | Title | Target Keyword | Intent | Content Type | Links To |
84
+ |---|------------------------------|----------------------|-----------------|------------------|------------------|
85
+ | 7 | [Article title] | [keyword] | transactional | review | Pillar Page |
86
+ | 8 | [Article title] | [keyword] | informational | glossary | Art. 2, Art. 4 |
18
87
 
19
- - Use when building topical authority around a new subject
20
- - Use when you need to know what to write next to support a pillar page
21
- - Use when planning a content calendar for a niche
22
- - Use when you want to identify AEO content gaps competitors are missing
88
+ ---
89
+
90
+ ## Internal Link Map
91
+
92
+ Pillar Page
93
+ ├── Article 1 → links back to Pillar
94
+ ├── Article 2 → links back to Pillar
95
+ ├── Article 3 → links back to Pillar, links to Article 1
96
+ ├── Article 4 → links to Article 1, Pillar
97
+ ├── Article 5 → links to Article 3, Pillar
98
+ ├── Article 6 → links to Article 1, Article 2
99
+ ├── Article 7 → links to Pillar
100
+ └── Article 8 → links to Article 2, Article 4
101
+
102
+ Rule: Every cluster article must link back to the Pillar Page.
103
+ Rule: No orphan articles — every article links to at least one other article.
104
+
105
+ ## Foundational Page Plan
106
+
107
+ | # | Page / Article | Problem Solved | Primary Query | Intent | Product CTA | Supporting Links |
108
+ |---|----------------|----------------|---------------|--------|-------------|------------------|
109
+ | 1 | [title] | [problem] | [query] | [intent] | [CTA] | [targets] |
110
+
111
+ Use this section for the first publishing wave. The landing page, foundational pages, and later cluster articles must not compete for the same intent.
112
+
113
+ ## 20-Day Editorial Calendar
114
+
115
+ | Day | Topic / Title | Target Query | Search Intent | Article Format | Internal Link Target | External Distribution Candidate |
116
+ |-----|---------------|--------------|---------------|----------------|----------------------|--------------------------------|
117
+ | 1 | [title] | [query] | [intent] | [format] | [page] | [Medium/Hashnode/dev.to/other] |
23
118
 
24
- ## How It Works
119
+ Create 20 distinct topics after the foundation is mapped. Prefer topics that answer real questions, solve problems, support the product, and can be linked back to a foundational page.
25
120
 
26
- ### Step 1: Define the Pillar Page
27
- Set the primary keyword, target audience, and word count target (2500–4000 words) for the pillar page that anchors the cluster.
121
+ ---
28
122
 
29
- ### Step 2: Generate Cluster Articles
30
- Produce 8–15 subtopics sorted into three priority tiers:
31
- - **Priority 1** — High volume, clear intent. Write these first.
32
- - **Priority 2** — Medium volume, long-tail focus. Write second.
33
- - **Priority 3** — Low volume, high conversion intent. Write last.
123
+ ## Content Gap Analysis
34
124
 
35
- Assign each article a unique keyword, content type, search intent, and link map.
125
+ Topics the cluster covers that competitors likely miss:
126
+ - [Gap 1 — underserved angle on the pillar topic]
127
+ - [Gap 2 — long-tail question with no strong existing answer]
128
+ - [Gap 3 — AEO opportunity: question AI engines commonly surface]
36
129
 
37
- ### Step 3: Build Internal Link Map
38
- Every cluster article must link back to the pillar page. No orphan articles. Show the full tree of relationships.
130
+ Topics to deliberately exclude from this cluster
131
+ (belong to a different cluster):
132
+ - [Out-of-scope topic 1]
133
+ - [Out-of-scope topic 2]
39
134
 
40
- ### Step 4: Run Content Gap Analysis
41
- Identify angles that competitors likely miss — especially question-based AEO opportunities that AI engines commonly surface.
135
+ ---
42
136
 
43
- ## Examples
137
+ ## AEO Cluster Signals
44
138
 
45
- ### Example: Automated Budgeting Cluster
46
- Pillar: The Complete Guide to Automated Budgeting
47
- Priority 1:
139
+ At least 2 cluster articles must be structured as direct-answer pages:
140
+ - One FAQ page targeting 8–10 questions around the pillar topic
141
+ - One "What Is" explainer with a clean definition as the opening sentence
48
142
 
49
- How to Build a Budget That Actually Works | how-to guide
50
- Best Budgeting Apps Compared | comparison
51
- What Is Zero-Based Budgeting? | explainer ← AEO priority
143
+ These two articles have the highest probability of being
144
+ extracted by AI engines.
52
145
 
53
- Priority 2:
54
- 4. How to Automate Your Savings in 3 Steps | how-to guide
55
- 5. Budgeting for Millennials: What Nobody Tells You | opinion
56
- Link Map:
57
- Pillar ← Article 1, 2, 3, 4, 5
58
- Article 1 ↔ Article 4
59
- Article 2 → Article 3
60
- AEO Priority:
61
- ★ Article 3 — "What Is" format has highest AI extraction probability
62
- ★ Article 2 — comparison table will be lifted for product queries
146
+ ---
63
147
 
64
- ## Best Practices
148
+ ## Cluster Health Checklist
149
+
150
+ - [ ] Pillar page defined with clear keyword and intent
151
+ - [ ] 5–10 foundational pages generated, default 10 when justified
152
+ - [ ] Every article has a unique target keyword (no overlap)
153
+ - [ ] Every article assigned a content type
154
+ - [ ] Every article linked back to the Pillar Page
155
+ - [ ] No orphan articles in the link map
156
+ - [ ] At least one FAQ page in the cluster
157
+ - [ ] At least one comparison or case study article
158
+ - [ ] Content gap section completed
159
+ - [ ] Every foundational page has a distinct search intent and conversion path
160
+ - [ ] 20-day editorial calendar completed without cannibalizing existing pages
161
+ ```
65
162
 
66
- - ✅ **Do:** Assign every cluster article a unique target keyword — no overlap
67
- - ✅ **Do:** Include at least one FAQ page and one comparison article in every cluster
68
- - ✅ **Do:** Flag the 2 highest AEO-opportunity articles for priority writing
69
- - ❌ **Don't:** Let any article become an orphan — every article links to at least one other
70
- - ❌ **Don't:** Target the same keyword on both the pillar and a cluster article
163
+ ---
71
164
 
72
- ## Common Pitfalls
165
+ ## Content Types Available
73
166
 
74
- - **Problem:** Cluster articles all target similar keywords and cannibalise each other
75
- **Solution:** Run a uniqueness check — every article needs a distinct keyword with no semantic overlap.
167
+ When assigning content types, use only from this list:
76
168
 
77
- - **Problem:** No AEO content in the cluster
78
- **Solution:** At least 2 articles must be structured as direct-answer pages (FAQ or "What Is" explainer).
169
+ | Type | Best For |
170
+ |----------------|-------------------------------------------------|
171
+ | how-to guide | step-by-step processes |
172
+ | explainer | concept definitions and overviews |
173
+ | listicle | roundups, tools, resources |
174
+ | comparison | X vs Y, best options |
175
+ | case study | real-world application, results |
176
+ | FAQ page | question clusters, AEO targeting |
177
+ | review | product or service evaluation |
178
+ | glossary | terminology, definitions, long-tail keywords |
179
+ | opinion/take | thought leadership, contrarian angles |
79
180
 
80
- ## Related Skills
181
+ ---
81
182
 
82
- - `@seo-aeo-keyword-research` — provides the keyword foundation for the cluster
83
- - `@seo-aeo-blog-writer` — writes the Priority 1 cluster articles
84
- - `@seo-aeo-internal-linking` — builds the detailed link map from cluster output
183
+ ## Execution Steps
184
+
185
+ 1. Read `existing_content`mark any titles that already exist
186
+ so the cluster doesn't duplicate them
187
+ 2. Identify the pillar topic's full semantic territory —
188
+ what questions, angles, and sub-topics surround it
189
+ 3. Run a content gap pass — what angles are underserved
190
+ or missing entirely in this space
191
+ 4. Assign each subtopic a unique keyword with no overlap
192
+ between articles or with the pillar keyword
193
+ 5. Classify each subtopic's search intent before assigning content type
194
+ 6. Sort all subtopics into Priority 1, 2, and 3 tiers
195
+ based on search volume and foundational relevance
196
+ 7. Build the 5–10-page foundational plan before expanding to the 20-day calendar
197
+ 8. Build the internal link map — verify no orphan articles exist
198
+ 9. Flag the 2 highest AEO-opportunity articles in the cluster
199
+ 10. Complete the content gap section and editorial calendar before outputting
85
200
 
86
- ## Additional Resources
201
+ ---
202
+
203
+ ## Connected Skills
204
+ - Receives output from: `seo-aeo-keyword-research`
205
+ - Feeds output to: `seo-aeo-blog-writer`, `seo-aeo-internal-linking`
87
206
 
88
- - [SEO-AEO Engine Repository](https://github.com/mrprewsh/seo-aeo-engine)
89
- - [Full Content Cluster SKILL.md](https://github.com/mrprewsh/seo-aeo-engine/blob/main/.agent/skills/content-cluster/SKILL.md)
207
+ ## When to Use
208
+
209
+ Use when planning a pillar page, foundational pages, and supporting articles around a product, service, or topic.
90
210
 
91
211
  ## Limitations
92
- - Use this skill only when the task clearly matches the scope described above.
93
- - Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
94
- - Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
212
+
213
+ - A content map is a prioritisation aid, not measured demand or a guarantee that every proposed topic will rank.