product-help-center

Help Center Design

Design public help centers, in-app self-service, and AI-consumable documentation systems.

Use this skill when the user needs one of these outcomes:

• pick or compare a help center, docs, or support-AI platform
• design or audit taxonomy, navigation, article standards, and governance
• plan retrieval-first support AI with citations, tool permissions, and escalation
• make docs easier for humans, search, and AI agents to consume

Workflow

1. Classify the surface
   • Support help center, developer docs portal, internal knowledge base, in-app guidance, or hybrid.
2. Define audience and risk
   • End users, admins, developers, agents, regulated customers, multilingual audiences.
3. Choose the operating model
   • Human-authored docs only, retrieval-first support AI, or agentic support with approved tools.
4. Design information architecture
   • Category structure, navigation, search strategy, metadata, URL rules, and versioning.
5. Standardize content
   • Article types, writing rules, visual rules, and reusable templates.
6. Instrument quality
   • Search analytics, self-service outcomes, citation quality, handoff quality, and freshness signals.
7. Run knowledge operations
   • Owners, review cadences, release-driven updates, and stale-content remediation.

Expected outputs:

• help center or docs platform recommendation with rationale
• taxonomy map, metadata schema, and article backlog
• support AI design with sources, escalation policy, and guardrails
• operating model for ownership, QA, and measurement

ASCII Flow

Help center or support-docs request
  -> Classify surface: help center, developer docs, KB, in-app, or hybrid
  -> Define audience, risk, locale, and support context
  -> Choose operating model
     +-- human-authored docs
     +-- retrieval-first support AI
     +-- agentic support with approved tools
  -> Design IA, taxonomy, metadata, URLs, search, and versioning
  -> Standardize article types and templates
  -> Add measurement: search, self-service, citations, handoff, freshness
  -> Assign owners, review cadence, migration plan, and stale-content loop

Quick Reference

Surface Selection

Content Type Decision Matrix

Platform Selection Rules

• Recommend support suites when ticketing, SLAs, handoff, and compliance are first-class requirements.
• Recommend docs portals when the main problem is structured product or API documentation.
• Treat Notion as acceptable for lightweight internal knowledge and early-stage public docs, not as a durable default for serious public help centers.
• Verify pricing, packaging, plan limits, and current AI features before making final vendor recommendations.
• Zendesk consolidated AI agent tiers in mid-2026: the Essential/Advanced distinction is being removed, with advanced AI features (agentic reasoning, multi-step procedures, external API integrations) included across Suite and Support plans. Legacy Essential functionality reaches end-of-life December 2026. Verify current plan structure before advising on AI agent capabilities.
• Intercom Fin (2026) supports multi-channel deployment (web, iOS, Android, Email, WhatsApp, SMS, Facebook, Instagram), persona customization, and plan/locale-aware content targeting. Pricing is resolution-based; verify current rates.

See platform-guides.md for current platform-fit rules and sources.json for preferred sources.

2026 Default Guidance

Durable Shifts

AI-First Principles

1. Retrieval before generation.
2. Citations before confidence claims.
3. Clarify or escalate before guessing.
4. Tool access by explicit permission, not by default.
5. Knowledge freshness matters as much as model quality.
6. Support AI needs QA, monitoring, and rollback paths.

AI-Consumable Docs Principles

• Publish stable canonical URLs and clear page titles.
• Keep one main task or concept per page.
• Use headings, tables, lists, and exact error strings.
• Expose machine-friendly surfaces when relevant: markdown export, API references, MCP servers, llms.txt, llms-full.txt, and agent-facing indexes.
• Treat llms.txt as additive and emerging, not a replacement for good IA, search, or structured docs.

See ai-consumable-docs.md for the AI-docs layer.

Answer Engine Optimization (AEO)

Help center content is a primary source for AI answer engines (ChatGPT, Perplexity, Gemini, Claude). Two complementary layers improve citation and retrieval:

• Page-level markup: use FAQPage, HowTo, and Article schema.org types on help articles. FAQs and step-by-step lists are the formats AI models favour most; explicit schema reinforces what the content is.
• Site-level signaling: publish llms.txt and llms-full.txt at a well-known URL to indicate canonical structure and priority pages to AI crawlers. As of mid-2026, adoption is growing but support is uneven — treat it as a fast-growing signal rather than a guaranteed channel.
• Content shape: short declarative answers at the top of each article (before procedural detail) improve extraction by AI answer engines. Use exact product names, error strings, and version numbers — AI engines retrieve verbatim matches better than paraphrases.
• Canonical hygiene: one canonical URL per fact; avoid duplicate content across help center and marketing site, which splits AI citation confidence.

These optimizations compound with good IA and structured markup; neither replaces the other.

Help Center Architecture

Category Structure Rules

HIERARCHY RULES
- Prefer 2 levels; use 3 only when the product genuinely needs it
- Top-level categories: usually 5-8
- Organize by user goal, not internal org chart
- Separate end-user help from developer docs when the audiences differ
- Keep billing, security, troubleshooting, and release notes easy to find

Recommended Top-Level Categories

DEFAULT STRUCTURE
1. Getting Started
2. Core Workflows
3. Integrations
4. Account, Billing, and Security
5. Troubleshooting
6. Developers or API
7. Release Notes / What's New
8. Contact / Escalation

Navigation Patterns

• Search is always above the fold.
• Breadcrumbs and related articles are standard.
• Every troubleshooting article includes an escalation path.
• Every how-to article includes prerequisites, result state, and next steps.
• Versioned products need explicit version selectors or version labels.

Article Standards

• Keep the core set small: how-to, troubleshooting, conceptual, FAQ, reference, release note.
• Include exact UI labels, feature names, and error strings.
• Remove marketing language from support content.
• Use screenshots only when they materially reduce ambiguity; keep them current.
• Make every article independently understandable to users and retrieval systems.

Use article-templates.md for templates and taxonomy-patterns.md for IA patterns.

Support AI Design

Retrieval-First Support Flow

USER QUESTION
  -> classify intent and risk
  -> retrieve from approved sources
  -> answer with citations
  -> clarify if evidence is weak or ambiguous
  -> hand off or execute only if policy allows
  -> log outcome and quality signals

Resolution Modes

Guardrails

• Approved sources list.
• Tool permission matrix by task.
• Escalation triggers for low evidence, high risk, or repeated failure.
• Citation requirement for factual claims.
• Simulation and QA before live traffic increases.

See ai-integration.md for implementation patterns.

Metrics & Quality

Core Measures

AI-Specific Measures

• unresolved-intent rate
• citation rate
• tool-call success rate
• reopen-after-AI rate
• stale-source hit rate
• handoff acceptance rate

Do not use fixed ROI or benchmark numbers unless the user asks for them and you verify current data. Use the measurement framework in metrics-optimization.md.

Judgment Beyond the Checklist

A checklist audit catches missing articles and broken links. It does not catch these failure modes, which matter more and require judgment:

• Deflection-vs-resolution gap: a falling contact rate can mean users are self-serving successfully, or it can mean the contact path got harder to find, an AI assistant is stalling instead of escalating, or frustrated users are churning silently instead of reopening. Never trust a deflection or containment number without a paired resolution-quality signal. See Where Deflection Targets Backfire.
• Content debt vs. content gaps: high ticket volume on a topic with an existing, accurate, recently-reviewed article is usually not a missing-content problem — it is a mismatch between the article and how users describe the issue, or a sign of competing information architectures from past redesigns. Diagnose debt before assigning more writing. See Content Debt Diagnosis.
• Shallow AI grounding: a citation on an AI answer does not mean the answer is correct — chunking can separate a rule from its exception, retrieval can return the right fact for the wrong plan or version, and synthesis across two accurate sources can produce an inaccurate combined claim. Citation rate alone will not catch any of this; it requires human review of cited claims against source text. See Grounding Quality Judgment.

Knowledge Operations

Operate the help center like a product:

• assign an owner per category and per high-impact article set
• tie content updates to releases, incidents, and high-volume search gaps
• review zero-result searches, escalation-after-view, and low-rated articles on a set cadence
• maintain one canonical source per fact domain where possible

See knowledge-ops.md, content-migration-guide.md, multilingual-support.md, and accessibility-standards.md.

Navigation

Trend Awareness Protocol

When the user asks for recommendations involving vendors, AI features, pricing, or platform relevance:

• run a fresh web search
• prefer official docs and product pages first
• use independent comparisons only as support, not as the decision anchor
• report source links and note dates for volatile claims

Priority source order:

1. Official docs and product pages
2. Official protocol/spec pages
3. High-quality independent comparisons
4. Vendor blogs and SEO content as secondary evidence only

Fact-Checking

• Verify current pricing, plan limits, AI capabilities, and product naming before final answers.
• Prefer primary sources for platform behavior and protocol details.
• If web access is unavailable, say so and mark volatile guidance as unverified.

Learnings Loop

Before applying this skill on a non-trivial task, read learnings.consolidated.md in this directory (and learnings.md if present).

After applying it, if you encountered a pattern worth remembering, a mistake worth preventing, or a domain fact that surprised you, append one dated bullet to learnings.md via agents-skills-feedback-loop/scripts/append_learning.py. Do not modify SKILL.md itself.