Skip to content

AgriciDaniel/claude-blog / skills/blog

Full-lifecycle blog engine with 31 sub-skills, 12 templates, 100-point scoring, and 5 agents. Routes requests to the right sub-skill: writing, rewriting, analysis, outlines, audits, schema, charts, images, repurposing, AI citation SEO, FLOW prompts, topic clusters, and multilingual publishing. Optimized for Google rankings, E-E-A-T, and AI citations. Supports any platform. Use when the user asks to create, revise, analyze, plan, translate, localize, audit, or repurpose blog content, or invokes a /blog subcommand. Do not activate merely because the word "blog" appears in an unrelated coding, theme-debugging, database, log-analysis, or definition request.

templates/faq-knowledge.md

View on GitHub
# Template: FAQ / Knowledge Base

**Template ID:** faq-knowledge
**Target Length:** 1,500-2,000 words
**Content Type:** Comprehensive FAQ organized by category with extractable answers
**Primary Search Intent:** Informational ("what is," "how does," "why does," "can I," "should I")

## When to Use This Template

Use this template when:
- A topic generates many recurring questions across forums, support channels, or search
- Each question can be answered clearly and directly without a fixed word band
- The content needs to be optimized for Google Featured Snippets and AI citations
- Search queries are phrased as questions ("how do I," "what is the difference between," "why does")
- You want to create a linkable reference page that other content can point to

Do NOT use this template for:
- Step-by-step instructions (use tutorial)
- Timely event analysis (use news-analysis)
- Original data studies (use data-research)
- Topics with fewer than 10 meaningful questions (too thin for this format)

**SEO Note:** This template is optimized for visible, self-contained Q&A passages.
Visible Q&A can support extraction for snippets and AI citations, but FAQPage
schema does not cause Featured Snippets and should be secondary to Article,
Person, Organization, and BreadcrumbList schema.

---

## Title Format

```
[Topic]: Frequently Asked Questions ([Year])
```

**Examples:**
- "Claude Code: Frequently Asked Questions (2026)"
- "AI-Assisted Code Review: Frequently Asked Questions (2026)"
- "Technical Blog SEO: Frequently Asked Questions (2026)"

**Title Rules:**
- Name the topic explicitly
- Include "Frequently Asked Questions" (exact phrase for search matching)
- Include the year (signals freshness; update annually)
- Keep under 60 characters for full SERP display when possible

**Alternative Title Formats:**
- "[Topic] FAQ: [N] Questions Answered ([Year])"
- "[Topic] for [Audience]: [N] Common Questions Answered ([Year])"
- "[Topic] Explained: [N] Common Questions Answered"

---

## Section-by-Section Structure

---

### Introduction (100-150 words)

[ANSWER-FIRST] Introduce the topic and establish why these questions matter.
Use a verified statistic only when it materially improves that explanation.

```markdown
# [Topic]: Frequently Asked Questions ([Year])

[ANSWER-FIRST] [Topic] is [one-sentence definition or description]. [Why it matters in 1 sentence].

[STAT when useful: data point about the topic's relevance - adoption rate, search volume, market size, or frequency of these questions]

This FAQ covers the [N] most common questions about [topic], organized into [N] categories:

1. **[Category 1 Name]** - [What these questions cover]
2. **[Category 2 Name]** - [What these questions cover]
3. **[Category 3 Name]** - [What these questions cover]
4. **[Category 4 Name]** - [What these questions cover]

[INFO-GAIN: why this FAQ exists - what gap it fills vs. existing resources, or what unique perspective it brings]

> **Last updated:** [Date]. [How often this page is updated].
```

**Rules:**
- The introduction should be skimmable - readers will jump to their question
- Include a table of contents via the category list
- State when the page was last updated (trust signal)
- Include a stat to establish the topic's relevance when one is available and sourced

---

### FAQ Category 1: "Getting Started" Questions (count by reader need)

Foundational questions for newcomers. Each question is an H2.

```markdown
## Getting Started with [Topic]

### What is [topic/tool/concept]?

[ANSWER-FIRST] [Topic] is [clear, jargon-free definition sized to the concept]. [Add context about its purpose or primary use case when helpful].

[STAT: adoption or usage data point that validates relevance]

[INTERNAL-LINK: link to introductory guide or overview content for readers who need more depth]

---

### Who should use [topic/tool]?

[ANSWER-FIRST] [Topic] is best suited for [specific audience] who need to [specific outcome]. [One sentence about who it's NOT for, to help readers self-select].

**Ideal for:**
- [Audience segment 1]: [Why]
- [Audience segment 2]: [Why]

**Not ideal for:**
- [Audience segment]: [Why not]

---

### How do I get started with [topic]?

[ANSWER-FIRST] To get started with [topic], [first step in one sentence]. [Second step]. The entire setup takes approximately [time].

[INTERNAL-LINK: link to detailed setup tutorial]

---

### How much does [topic/tool] cost?

[ANSWER-FIRST] [Topic/tool] [pricing summary - free, freemium, paid tiers in one sentence]. [One sentence about what the free tier includes or what the pricing is based on].

[STAT: pricing comparison or value benchmark if relevant]

[INTERNAL-LINK: link to detailed pricing comparison or guide if available]
```

---

### FAQ Category 2: "How It Works" Questions (count by reader need)

Functional questions about mechanics and capabilities.

```markdown
## How [Topic] Works

### How does [topic/feature] work?

[ANSWER-FIRST] [Topic/feature] works by [mechanism explained completely without unnecessary jargon]. [Add technical detail for readers who need depth].

[VISUAL: simple-diagram showing how it works, if applicable]

[INTERNAL-LINK: link to technical deep-dive content]

---

### What is the difference between [A] and [B]?

[ANSWER-FIRST] The main difference is [key distinction in one sentence]. [A] is [characteristic], while [B] is [characteristic].

| Feature | [A] | [B] |
|---------|-----|-----|
| [Comparison point 1] | [A's value] | [B's value] |
| [Comparison point 2] | [A's value] | [B's value] |
| [Comparison point 3] | [A's value] | [B's value] |
| **Best for** | [Use case] | [Use case] |

[STAT: usage or performance data comparing A and B if available]

---

### Can [topic/tool] do [specific capability]?

[ANSWER-FIRST] [Yes/No], [topic/tool] [can/cannot] [capability] [because reason in one sentence]. [One sentence about workarounds or alternatives if "no," or limitations if "yes"].

---

### What are the limitations of [topic/tool]?

[ANSWER-FIRST] The main limitations of [topic/tool] are [top 2-3 limitations in one sentence]. [One sentence about whether these limitations are being addressed].

**Current limitations:**
1. **[Limitation 1]:** [Brief explanation]
2. **[Limitation 2]:** [Brief explanation]
3. **[Limitation 3]:** [Brief explanation]

[INFO-GAIN: honest assessment based on hands-on experience - what the marketing doesn't tell you]
```

---

### FAQ Category 3: "Common Problems" Questions (count by reader need)

Troubleshooting questions for users who are stuck.

```markdown
## Common Problems & Solutions

### Why is [topic/tool] [not working / slow / showing error]?

[ANSWER-FIRST] The most common cause of [problem] is [root cause in one sentence]. [One-sentence fix].

**Common causes and fixes:**

| Cause | Fix |
|-------|-----|
| [Cause 1] | [Fix 1] |
| [Cause 2] | [Fix 2] |
| [Cause 3] | [Fix 3] |

[INTERNAL-LINK: link to detailed troubleshooting guide]

---

### How do I fix [specific error message]?

[ANSWER-FIRST] [Error message] typically means [what it means]. Fix it by [specific action in one sentence].

```[language]
# [Fix command or code]
[specific fix]
```

[STAT: how common this error is, if data is available]

---

### How do I migrate from [old tool/version] to [new tool/version]?

[ANSWER-FIRST] To migrate from [old] to [new], [high-level steps in one sentence]. The migration takes approximately [time] for a typical [project/setup].

**Migration steps:**
1. [Step 1]
2. [Step 2]
3. [Step 3]

[INTERNAL-LINK: link to detailed migration tutorial]

---

### Where can I get help with [topic/tool]?

[ANSWER-FIRST] The best places to get help with [topic/tool] are [top 2-3 resources]. [One sentence about response times or community quality].

**Help resources:**
- **[Resource 1]:** [Description and link]
- **[Resource 2]:** [Description and link]
- **[Resource 3]:** [Description and link]
```

---

### FAQ Category 4: "Advanced" Questions (count by reader need)

Questions from experienced users looking for deeper understanding.

```markdown
## Advanced Topics

### How do I [advanced use case]?

[ANSWER-FIRST] To [advanced use case], [approach in one sentence]. This requires [prerequisite knowledge/setup].

[Brief technical explanation - 2-3 sentences]

```[language]
# Example implementation
[code snippet showing the approach]
```

[INTERNAL-LINK: link to advanced tutorial covering this in detail]

[INFO-GAIN: expert tip or non-obvious approach based on real-world experience]

---

### What are the best practices for [topic] in production?

[ANSWER-FIRST] The top [N] best practices for [topic] in production are [brief list in one sentence]. [One sentence about why these matter].

1. **[Practice 1]:** [Brief explanation with rationale]
2. **[Practice 2]:** [Brief explanation with rationale]
3. **[Practice 3]:** [Brief explanation with rationale]

[STAT: data point about the impact of following these practices - error reduction, performance improvement, etc.]

---

### How does [topic] compare to [alternative] for [specific use case]?

[ANSWER-FIRST] For [specific use case], [topic] is [better/worse/comparable] to [alternative] because [key reason]. [One sentence nuance].

| Criterion | [Topic] | [Alternative] |
|-----------|---------|---------------|
| [Criterion 1] | [Rating/value] | [Rating/value] |
| [Criterion 2] | [Rating/value] | [Rating/value] |
| [Criterion 3] | [Rating/value] | [Rating/value] |
| **Verdict** | [Summary] | [Summary] |

[INTERNAL-LINK: link to detailed comparison content]
```

---

### Related Resources (100 words)

```markdown
## Related Resources

Explore these resources for deeper coverage of [topic]:

- **[Detailed guide title]** - [One-sentence description] [INTERNAL-LINK]
- **[Tutorial title]** - [One-sentence description] [INTERNAL-LINK]
- **[Comparison/review title]** - [One-sentence description] [INTERNAL-LINK]
- **[Official documentation]** - [One-sentence description with external link]
- **[Community/forum]** - [One-sentence description with external link]
```

**Rules:**
- Mix internal links (your content) with external links (official docs, communities)
- Prioritize internal links - this is a hub page
- Keep descriptions to one sentence each

---

### Still Have Questions? (50 words)

```markdown
## Still Have Questions?

Didn't find what you're looking for? [Contact method - e.g., "Leave a comment below," "Join our community at [link]," "Reach out on [platform]"]. We update this FAQ [frequency - monthly/quarterly] based on reader questions.

[IMAGE: optional call-to-action graphic or community badge]
```

---

## Structured Data Notes

FAQPage schema is optional entity markup for visible Q&A. Article or BlogPosting,
Person, Organization, and BreadcrumbList remain the baseline. When FAQPage is
used, generate valid JSON-LD from the visible questions:

```json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "[Question text]",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "[Answer text - use the ANSWER-FIRST sentence + supporting detail]"
      }
    }
  ]
}
```

**Rules:**
- If FAQPage is generated, include every visible H2 question in the schema
- Use the [ANSWER-FIRST] text as the answer in the schema
- Schema may include all visible FAQ questions when JSON size remains reasonable
- Test FAQPage with Schema.org Validator and validate entity consistency. Use
  Google's Rich Results Test only for page types eligible for Google rich results.

---

## Content Checklist

Before publishing, verify:

- [ ] Title includes topic name, "Frequently Asked Questions," and year
- [ ] Introduction includes a stat about the topic's relevance when available and sourced
- [ ] Questions are organized into 3-4 logical categories
- [ ] Every question is phrased exactly as users would search it
- [ ] Every answer opens with [ANSWER-FIRST] (direct answer in first sentence)
- [ ] Each answer is complete and self-contained; length alone does not pass or fail
- [ ] Each answer is extractable as a standalone snippet (no "as mentioned above" references)
- [ ] Question count follows demonstrated reader need without padding
- [ ] Statistics are optional, material to an answer, and verified when used
- [ ] At least 2 [INFO-GAIN] markers with original experience or insight
- [ ] At least 6 [INTERNAL-LINK] zones connecting to detailed content
- [ ] At least 1 [VISUAL] marker (comparison table or diagram)
- [ ] Related Resources section has 3-5 links
- [ ] "Still Have Questions?" section with clear contact/community path
- [ ] FAQPage structured data is optional and generated only from visible Q&A
- [ ] No answer references another answer (each must stand alone)
- [ ] All answers are clear enough to stand alone in search snippets or AI citations
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall