跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
视频与音频

outline-architect

Designs H2/H3 outline with explicit per-section word budgets, table placements (≥2 with one in front 50%), image/video slot markers, FAQ count, abstract seed, takeaways seeds, Citation Capsule requirement per H2. Loads format-specific template. Critical pre-build step. Use whenever building an article — after format + angle picked, before section-drafter parallel dispatch.

XuanRanL · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add XuanRanL/loamwright-SEO-Skill --skill outline-architect

技能说明


name: outline-architect description: Designs H2/H3 outline with explicit per-section word budgets, table placements (≥2 with one in front 50%), image/video slot markers, FAQ count, abstract seed, takeaways seeds, Citation Capsule requirement per H2. Loads format-specific template. Critical pre-build step. Use whenever building an article — after format + angle picked, before section-drafter parallel dispatch. allowed-tools: [Read, Write, Bash]

Outline Architect

Converts (format + angle + research) into a structured outline that section-drafter can parallelize across.

HARD REQUIREMENT — every outline ends with References

Every outline this skill produces MUST include, as the final sections[] entry (preceded by "Further Reading" if a Further Reading section is desired):

// ... earlier content sections ...
{
  "index": N-2,
  "h2": "Further Reading",                  // OPTIONAL; if present, MUST come BEFORE References
  "word_budget": 100,
  "section_intent": "Internal links to companion pillars + 1-3 narrative external pointers",
  "citation_capsule_required": false
},
{
  "index": N-1,
  "h2": "References",                       // MANDATORY for every format
  "word_budget": 200,                       // accommodates 8-10 APA-7 entries
  "section_intent": "APA-7 numbered list of every external source cited in body; link-resolvable URLs/DOIs; ≥1 peer-reviewed when available",
  "needs_table": false,
  "image_slot": false,
  "citation_capsule_required": false,
  "is_references_block": true
}

The article signature paragraph is appended at publish time by subskills/publish/wordpress-publisher/ from projects/{slug}/CLAUDE.md — it is NOT a section in the outline (it's a single <hr /> + <p class="article-signature"> after the References block).

The "Further Reading" prose paragraph is OPTIONAL. The "References" <ol> block is MANDATORY for every format — all 24 templates/*.md declare ## References as the closer. An outline that omits References will fail downstream verification at the publish phase and trigger a forced rebuild — emit the section even if citations.json is empty at outline time (the build phase populates it).

Inputs

  • state.brief.word_count_target
  • angle.json (format_id + title + persona + modifiers)
  • research.json (paa, semantic_clusters, competitor_titles, content_gaps)
  • templates/{format_id}.md (24 formats, each with skeleton structure)
  • references/seo/blog-formats-2026.md (format-specific Body structure)

Output

workspace/{task_id}/outline.json per schemas/outline.schema.json:

{
  "abstract_seed": "After testing 23 rods over 87 trips, we ranked the top 10 fishing rods for 2026.",
  "tldr_seed": "The G.Loomis NRX+ is our top pick at $549. For tight budgets, Ugly Stik Elite at $35 punches above its weight.",
  "takeaways_seeds": [
    "Choose action based on lure weight, not species (saves $100 misbuy)",
    "Graphite vs fiberglass: 70/30 rule by use case",
    "Best Fishing Rods 2026: G.Loomis NRX+ overall winner",
    "Ugly Stik Elite wins under $50",
    "Avoid these 3 marketing tricks rod brands use"
  ],
  "sections": [
    {
      "index": 0,
      "h2": "Why fishing rod selection matters more than gear cost",
      "h3s": ["What changed in 2025-26", "How rod quality affects catch rate"],
      "word_budget": 450,
      "needs_table": false,
      "image_slot": true,
      "youtube_slot": false,
      "section_intent": "Establish stakes; hook reader; introduce testing methodology",
      "primary_keyword_density_target": 0.012,
      "is_featured_snippet_target": false,
      "citation_capsule_required": true
    },
    {
      "index": 1,
      "h2": "How we tested 23 rods (methodology)",
      "h3s": ["Test conditions", "Rating criteria", "Disqualifications"],
      "word_budget": 500,
      "needs_table": true,
      "image_slot": false,
      "section_intent": "E-E-A-T Experience signal; tabulate test criteria",
      "primary_keyword_density_target": 0.005,
      "citation_capsule_required": true
    },
    {
      "index": 2,
      "h2": "10 Best Fishing Rods for 2026 (ranked)",
      "h3s": ["#1 G.Loomis NRX+", "#2 St. Croix...", "#3...", "#10..."],
      "word_budget": 3500,
      "needs_table": true,
      "image_slot": true,
      "youtube_slot": false,
      "section_intent": "Core listicle body; product evaluation per item",
      "primary_keyword_density_target": 0.010
    },
    ... (more sections)
  ],
  "faq": {
    "count": 7,
    "seed_questions": [
      "What's the best fishing rod under $100?",
      "How do I choose between graphite and fiberglass?",
      "Is the G.Loomis NRX+ worth the price?",
      "What rod action should beginners use?",
      "How often should I replace my fishing rod?",
      "Does rod length matter for kayak fishing?",
      "Are budget rods (under $50) usable for saltwater?"
    ],
    "paa_alignment_pct": 0.71
  },
  "total_word_budget": 6200,
  "expected_h2_count": 8,
  "expected_table_count": 3,
  "expected_image_count": 6
}

PAA contract (v3.35): faq.paa_alignment_pct is the outline's ESTIMATE only. The real ">=60% of FAQ from research.paa" contract is MEASURED ON THE DRAFT by the mandatory paa-alignment-check stage (scripts/lint/paa_alignment_check.py). Keep seed_questions in ORIGINAL PAA wording so the draft passes.

Hard constraints

  1. Word budgets sum to [word_count_target × 0.95, word_count_target × 1.05]
  2. Section count between 4 and 15
  3. ≥2 sections with needs_table: true, with at least 1 in the FIRST HALF (sections[index] < total/2)
  4. FAQ count 5-15, and ≥60% must come from research.paa
  5. Per-section word_budget: each between 150 and 2500
  6. citation_capsule_required: true on every content section (excludes Abstract / ToC / References)
  7. image_slot: true on exactly state.brief.image_count − 1 sections (the cover is NOT an inline slot: image_count counts
阅读完整来源 ↗