[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-anthropic-kb-article":3,"mdc-bge1qh-key":34,"related-org-anthropic-kb-article":1470,"related-repo-anthropic-kb-article":1657},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":29,"sourceUrl":32,"mdContent":33},"kb-article","draft knowledge base articles","Draft a knowledge base article from a resolved issue or common question. Use when a ticket resolution is worth documenting for self-service, the same question keeps coming up, a workaround needs to be published, or a known issue should be communicated to customers.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"anthropic","Anthropic","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fanthropic.png","anthropics",[13,17,20],{"name":14,"slug":15,"type":16},"Writing","writing","tag",{"name":18,"slug":19,"type":16},"Customer Support","customer-support",{"name":21,"slug":22,"type":16},"Knowledge Base","knowledge-base",22885,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins","2026-04-06T17:58:53.761569",null,2736,[],{"repoUrl":24,"stars":23,"forks":27,"topics":30,"description":31},[],"Open source repository of plugins primarily intended for knowledge workers to use in Claude Cowork","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Ftree\u002FHEAD\u002Fcustomer-support\u002Fskills\u002Fkb-article","---\nname: kb-article\ndescription: Draft a knowledge base article from a resolved issue or common question. Use when a ticket resolution is worth documenting for self-service, the same question keeps coming up, a workaround needs to be published, or a known issue should be communicated to customers.\nargument-hint: \"\u003Cresolved issue or ticket>\"\n---\n\n# \u002Fkb-article\n\n> If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](..\u002F..\u002FCONNECTORS.md).\n\nDraft a publish-ready knowledge base article from a resolved support issue, common question, or documented workaround. Structures the content for searchability and self-service.\n\n## Usage\n\n```\n\u002Fkb-article \u003Cresolved issue, ticket reference, or topic description>\n```\n\nExamples:\n- `\u002Fkb-article How to configure SSO with Okta — resolved this for 3 customers last month`\n- `\u002Fkb-article Ticket #4521 — customer couldn't export data over 10k rows`\n- `\u002Fkb-article Common question: how to set up webhook notifications`\n- `\u002Fkb-article Known issue: dashboard charts not loading on Safari 16`\n\n## Workflow\n\n### 1. Understand the Source Material\n\nParse the input to identify:\n\n- **What was the problem?** The original issue, question, or error\n- **What was the solution?** The resolution, workaround, or answer\n- **Who does this affect?** User type, plan level, or configuration\n- **How common is this?** One-off or recurring issue\n- **What article type fits best?** How-to, troubleshooting, FAQ, known issue, or reference (see article types below)\n\nIf a ticket reference is provided, look up the full context:\n\n- **~~support platform**: Pull the ticket thread, resolution, and any internal notes\n- **~~knowledge base**: Check if a similar article already exists (update vs. create new)\n- **~~project tracker**: Check if there's a related bug or feature request\n\n### 2. Draft the Article\n\nUsing the article structure, formatting standards, and searchability best practices below:\n\n- Follow the template for the chosen article type (how-to, troubleshooting, FAQ, known issue, or reference)\n- Apply the searchability best practices: customer-language title, plain-language opening sentence, exact error messages, common synonyms\n- Keep it scannable: headers, numbered steps, short paragraphs\n\n### 3. Generate the Article\n\nPresent the draft with metadata:\n\n```\n## KB Article Draft\n\n**Title:** [Article title]\n**Type:** [How-to \u002F Troubleshooting \u002F FAQ \u002F Known Issue \u002F Reference]\n**Category:** [Product area or topic]\n**Tags:** [Searchable tags]\n**Audience:** [All users \u002F Admins \u002F Developers \u002F Specific plan]\n\n---\n\n[Full article content — using the appropriate template below]\n\n---\n\n### Publishing Notes\n- **Source:** [Ticket #, customer conversation, or internal discussion]\n- **Existing articles to update:** [If this overlaps with existing content]\n- **Review needed from:** [SME or team if technical accuracy needs verification]\n- **Suggested review date:** [When to revisit for accuracy]\n```\n\n### 4. Offer Next Steps\n\nAfter generating the article:\n- \"Want me to check if a similar article already exists in your ~~knowledge base?\"\n- \"Should I adjust the technical depth for a different audience?\"\n- \"Want me to draft a companion article (e.g., a how-to to go with this troubleshooting guide)?\"\n- \"Should I create an internal-only version with additional technical detail?\"\n\n---\n\n## Article Structure and Formatting Standards\n\n### Universal Article Elements\n\nEvery KB article should include:\n\n1. **Title**: Clear, searchable, describes the outcome or problem (not internal jargon)\n2. **Overview**: 1-2 sentences explaining what this article covers and who it's for\n3. **Body**: Structured content appropriate to the article type\n4. **Related articles**: Links to relevant companion content\n5. **Metadata**: Category, tags, audience, last updated date\n\n### Formatting Rules\n\n- **Use headers (H2, H3)** to break content into scannable sections\n- **Use numbered lists** for sequential steps\n- **Use bullet lists** for non-sequential items\n- **Use bold** for UI element names, key terms, and emphasis\n- **Use code blocks** for commands, API calls, error messages, and configuration values\n- **Use tables** for comparisons, options, or reference data\n- **Use callouts\u002Fnotes** for warnings, tips, and important caveats\n- **Keep paragraphs short** — 2-4 sentences max\n- **One idea per section** — if a section covers two topics, split it\n\n## Writing for Searchability\n\nArticles are useless if customers can't find them. Optimize every article for search:\n\n### Title Best Practices\n\n| Good Title | Bad Title | Why |\n|------------|-----------|-----|\n| \"How to configure SSO with Okta\" | \"SSO Setup\" | Specific, includes the tool name customers search for |\n| \"Fix: Dashboard shows blank page\" | \"Dashboard Issue\" | Includes the symptom customers experience |\n| \"API rate limits and quotas\" | \"API Information\" | Includes the specific terms customers search for |\n| \"Error: 'Connection refused' when importing data\" | \"Import Problems\" | Includes the exact error message |\n\n### Keyword Optimization\n\n- **Include exact error messages** — customers copy-paste error text into search\n- **Use customer language**, not internal terminology — \"can't log in\" not \"authentication failure\"\n- **Include common synonyms** — \"delete\u002Fremove\", \"dashboard\u002Fhome page\", \"export\u002Fdownload\"\n- **Add alternate phrasings** — address the same issue from different angles in the overview\n- **Tag with product areas** — make sure category and tags match how customers think about the product\n\n### Opening Sentence Formula\n\nStart every article with a sentence that restates the problem or task in plain language:\n\n- **How-to**: \"This guide shows you how to [accomplish X].\"\n- **Troubleshooting**: \"If you're seeing [symptom], this article explains how to fix it.\"\n- **FAQ**: \"[Question in the customer's words]? Here's the answer.\"\n- **Known issue**: \"Some users are experiencing [symptom]. Here's what we know and how to work around it.\"\n\n## Article Type Templates\n\n### How-to Articles\n\n**Purpose**: Step-by-step instructions for accomplishing a task.\n\n**Structure**:\n```\n# How to [accomplish task]\n\n[Overview — what this guide covers and when you'd use it]\n\n## Prerequisites\n- [What's needed before starting]\n\n## Steps\n### 1. [Action]\n[Instruction with specific details]\n\n### 2. [Action]\n[Instruction]\n\n## Verify It Worked\n[How to confirm success]\n\n## Common Issues\n- [Issue]: [Fix]\n\n## Related Articles\n- [Links]\n```\n\n**Best practices**:\n- Start each step with a verb\n- Include the specific path: \"Go to Settings > Integrations > API Keys\"\n- Mention what the user should see after each step (\"You should see a green confirmation banner\")\n- Test the steps yourself or verify with a recent ticket resolution\n\n### Troubleshooting Articles\n\n**Purpose**: Diagnose and resolve a specific problem.\n\n**Structure**:\n```\n# [Problem description — what the user sees]\n\n## Symptoms\n- [What the user observes]\n\n## Cause\n[Why this happens — brief, non-jargon explanation]\n\n## Solution\n### Option 1: [Primary fix]\n[Steps]\n\n### Option 2: [Alternative if Option 1 doesn't work]\n[Steps]\n\n## Prevention\n[How to avoid this in the future]\n\n## Still Having Issues?\n[How to get help]\n```\n\n**Best practices**:\n- Lead with symptoms, not causes — customers search for what they see\n- Provide multiple solutions when possible (most likely fix first)\n- Include a \"Still having issues?\" section that points to support\n- If the root cause is complex, keep the customer-facing explanation simple\n\n### FAQ Articles\n\n**Purpose**: Quick answer to a common question.\n\n**Structure**:\n```\n# [Question — in the customer's words]\n\n[Direct answer — 1-3 sentences]\n\n## Details\n[Additional context, nuance, or explanation if needed]\n\n## Related Questions\n- [Link to related FAQ]\n- [Link to related FAQ]\n```\n\n**Best practices**:\n- Answer the question in the first sentence\n- Keep it concise — if the answer needs a walkthrough, it's a how-to, not an FAQ\n- Group related FAQs and link between them\n\n### Known Issue Articles\n\n**Purpose**: Document a known bug or limitation with a workaround.\n\n**Structure**:\n```\n# [Known Issue]: [Brief description]\n\n**Status:** [Investigating \u002F Workaround Available \u002F Fix In Progress \u002F Resolved]\n**Affected:** [Who\u002Fwhat is affected]\n**Last updated:** [Date]\n\n## Symptoms\n[What users experience]\n\n## Workaround\n[Steps to work around the issue, or \"No workaround available\"]\n\n## Fix Timeline\n[Expected fix date or current status]\n\n## Updates\n- [Date]: [Update]\n```\n\n**Best practices**:\n- Keep the status current — nothing erodes trust faster than a stale known issue article\n- Update the article when the fix ships and mark as resolved\n- If resolved, keep the article live for 30 days for customers still searching the old symptoms\n\n## Review and Maintenance Cadence\n\nKnowledge bases decay without maintenance. Follow this schedule:\n\n| Activity | Frequency | Who |\n|----------|-----------|-----|\n| **New article review** | Before publishing | Peer review + SME for technical content |\n| **Accuracy audit** | Quarterly | Support team reviews top-traffic articles |\n| **Stale content check** | Monthly | Flag articles not updated in 6+ months |\n| **Known issue updates** | Weekly | Update status on all open known issues |\n| **Analytics review** | Monthly | Check which articles have low helpfulness ratings or high bounce rates |\n| **Gap analysis** | Quarterly | Identify top ticket topics without KB articles |\n\n### Article Lifecycle\n\n1. **Draft**: Written, needs review\n2. **Published**: Live and available to customers\n3. **Needs update**: Flagged for revision (product change, feedback, or age)\n4. **Archived**: No longer relevant but preserved for reference\n5. **Retired**: Removed from the knowledge base\n\n### When to Update vs. Create New\n\n**Update existing** when:\n- The product changed and steps need refreshing\n- The article is mostly right but missing a detail\n- Feedback indicates customers are confused by a specific section\n- A better workaround or solution was found\n\n**Create new** when:\n- A new feature or product area needs documentation\n- A resolved ticket reveals a gap — no article exists for this topic\n- The existing article covers too many topics and should be split\n- A different audience needs the same information explained differently\n\n## Linking and Categorization Taxonomy\n\n### Category Structure\n\nOrganize articles into a hierarchy that matches how customers think:\n\n```\nGetting Started\n├── Account setup\n├── First-time configuration\n└── Quick start guides\n\nFeatures & How-tos\n├── [Feature area 1]\n├── [Feature area 2]\n└── [Feature area 3]\n\nIntegrations\n├── [Integration 1]\n├── [Integration 2]\n└── API reference\n\nTroubleshooting\n├── Common errors\n├── Performance issues\n└── Known issues\n\nBilling & Account\n├── Plans and pricing\n├── Billing questions\n└── Account management\n```\n\n### Linking Best Practices\n\n- **Link from troubleshooting to how-to**: \"For setup instructions, see [How to configure X]\"\n- **Link from how-to to troubleshooting**: \"If you encounter errors, see [Troubleshooting X]\"\n- **Link from FAQ to detailed articles**: \"For a full walkthrough, see [Guide to X]\"\n- **Link from known issues to workarounds**: Keep the chain from problem to solution short\n- **Use relative links** within the KB — they survive restructuring better than absolute URLs\n- **Avoid circular links** — if A links to B, B shouldn't link back to A unless both are genuinely useful entry points\n\n## KB Writing Best Practices\n\n1. Write for the customer who is frustrated and searching for an answer — be clear, direct, and helpful\n2. Every article should be findable through search using the words a customer would type\n3. Test your articles — follow the steps yourself or have someone unfamiliar with the topic follow them\n4. Keep articles focused — one problem, one solution. Split if an article is growing too long\n5. Maintain aggressively — a wrong article is worse than no article\n6. Track what's missing — every ticket that could have been a KB article is a content gap\n7. Measure impact — articles that don't get traffic or don't reduce tickets need to be improved or retired\n",{"data":35,"body":37},{"name":4,"description":6,"argument-hint":36},"\u003Cresolved issue or ticket>",{"type":38,"children":39},"root",[40,48,67,72,79,92,97,138,144,151,156,210,215,248,254,259,277,283,288,297,303,308,331,335,341,347,352,406,412,505,511,516,522,627,633,686,692,697,768,774,780,790,800,809,818,841,847,856,864,873,881,904,910,919,927,936,944,962,968,977,985,994,1002,1020,1026,1031,1182,1188,1241,1247,1257,1280,1289,1312,1318,1324,1329,1338,1344,1426,1432],{"type":41,"tag":42,"props":43,"children":44},"element","h1",{"id":4},[45],{"type":46,"value":47},"text","\u002Fkb-article",{"type":41,"tag":49,"props":50,"children":51},"blockquote",{},[52],{"type":41,"tag":53,"props":54,"children":55},"p",{},[56,58,65],{"type":46,"value":57},"If you see unfamiliar placeholders or need to check which tools are connected, see ",{"type":41,"tag":59,"props":60,"children":62},"a",{"href":61},"..\u002F..\u002FCONNECTORS.md",[63],{"type":46,"value":64},"CONNECTORS.md",{"type":46,"value":66},".",{"type":41,"tag":53,"props":68,"children":69},{},[70],{"type":46,"value":71},"Draft a publish-ready knowledge base article from a resolved support issue, common question, or documented workaround. Structures the content for searchability and self-service.",{"type":41,"tag":73,"props":74,"children":76},"h2",{"id":75},"usage",[77],{"type":46,"value":78},"Usage",{"type":41,"tag":80,"props":81,"children":85},"pre",{"className":82,"code":84,"language":46},[83],"language-text","\u002Fkb-article \u003Cresolved issue, ticket reference, or topic description>\n",[86],{"type":41,"tag":87,"props":88,"children":90},"code",{"__ignoreMap":89},"",[91],{"type":46,"value":84},{"type":41,"tag":53,"props":93,"children":94},{},[95],{"type":46,"value":96},"Examples:",{"type":41,"tag":98,"props":99,"children":100},"ul",{},[101,111,120,129],{"type":41,"tag":102,"props":103,"children":104},"li",{},[105],{"type":41,"tag":87,"props":106,"children":108},{"className":107},[],[109],{"type":46,"value":110},"\u002Fkb-article How to configure SSO with Okta — resolved this for 3 customers last month",{"type":41,"tag":102,"props":112,"children":113},{},[114],{"type":41,"tag":87,"props":115,"children":117},{"className":116},[],[118],{"type":46,"value":119},"\u002Fkb-article Ticket #4521 — customer couldn't export data over 10k rows",{"type":41,"tag":102,"props":121,"children":122},{},[123],{"type":41,"tag":87,"props":124,"children":126},{"className":125},[],[127],{"type":46,"value":128},"\u002Fkb-article Common question: how to set up webhook notifications",{"type":41,"tag":102,"props":130,"children":131},{},[132],{"type":41,"tag":87,"props":133,"children":135},{"className":134},[],[136],{"type":46,"value":137},"\u002Fkb-article Known issue: dashboard charts not loading on Safari 16",{"type":41,"tag":73,"props":139,"children":141},{"id":140},"workflow",[142],{"type":46,"value":143},"Workflow",{"type":41,"tag":145,"props":146,"children":148},"h3",{"id":147},"_1-understand-the-source-material",[149],{"type":46,"value":150},"1. Understand the Source Material",{"type":41,"tag":53,"props":152,"children":153},{},[154],{"type":46,"value":155},"Parse the input to identify:",{"type":41,"tag":98,"props":157,"children":158},{},[159,170,180,190,200],{"type":41,"tag":102,"props":160,"children":161},{},[162,168],{"type":41,"tag":163,"props":164,"children":165},"strong",{},[166],{"type":46,"value":167},"What was the problem?",{"type":46,"value":169}," The original issue, question, or error",{"type":41,"tag":102,"props":171,"children":172},{},[173,178],{"type":41,"tag":163,"props":174,"children":175},{},[176],{"type":46,"value":177},"What was the solution?",{"type":46,"value":179}," The resolution, workaround, or answer",{"type":41,"tag":102,"props":181,"children":182},{},[183,188],{"type":41,"tag":163,"props":184,"children":185},{},[186],{"type":46,"value":187},"Who does this affect?",{"type":46,"value":189}," User type, plan level, or configuration",{"type":41,"tag":102,"props":191,"children":192},{},[193,198],{"type":41,"tag":163,"props":194,"children":195},{},[196],{"type":46,"value":197},"How common is this?",{"type":46,"value":199}," One-off or recurring issue",{"type":41,"tag":102,"props":201,"children":202},{},[203,208],{"type":41,"tag":163,"props":204,"children":205},{},[206],{"type":46,"value":207},"What article type fits best?",{"type":46,"value":209}," How-to, troubleshooting, FAQ, known issue, or reference (see article types below)",{"type":41,"tag":53,"props":211,"children":212},{},[213],{"type":46,"value":214},"If a ticket reference is provided, look up the full context:",{"type":41,"tag":98,"props":216,"children":217},{},[218,228,238],{"type":41,"tag":102,"props":219,"children":220},{},[221,226],{"type":41,"tag":163,"props":222,"children":223},{},[224],{"type":46,"value":225},"~~support platform",{"type":46,"value":227},": Pull the ticket thread, resolution, and any internal notes",{"type":41,"tag":102,"props":229,"children":230},{},[231,236],{"type":41,"tag":163,"props":232,"children":233},{},[234],{"type":46,"value":235},"~~knowledge base",{"type":46,"value":237},": Check if a similar article already exists (update vs. create new)",{"type":41,"tag":102,"props":239,"children":240},{},[241,246],{"type":41,"tag":163,"props":242,"children":243},{},[244],{"type":46,"value":245},"~~project tracker",{"type":46,"value":247},": Check if there's a related bug or feature request",{"type":41,"tag":145,"props":249,"children":251},{"id":250},"_2-draft-the-article",[252],{"type":46,"value":253},"2. Draft the Article",{"type":41,"tag":53,"props":255,"children":256},{},[257],{"type":46,"value":258},"Using the article structure, formatting standards, and searchability best practices below:",{"type":41,"tag":98,"props":260,"children":261},{},[262,267,272],{"type":41,"tag":102,"props":263,"children":264},{},[265],{"type":46,"value":266},"Follow the template for the chosen article type (how-to, troubleshooting, FAQ, known issue, or reference)",{"type":41,"tag":102,"props":268,"children":269},{},[270],{"type":46,"value":271},"Apply the searchability best practices: customer-language title, plain-language opening sentence, exact error messages, common synonyms",{"type":41,"tag":102,"props":273,"children":274},{},[275],{"type":46,"value":276},"Keep it scannable: headers, numbered steps, short paragraphs",{"type":41,"tag":145,"props":278,"children":280},{"id":279},"_3-generate-the-article",[281],{"type":46,"value":282},"3. Generate the Article",{"type":41,"tag":53,"props":284,"children":285},{},[286],{"type":46,"value":287},"Present the draft with metadata:",{"type":41,"tag":80,"props":289,"children":292},{"className":290,"code":291,"language":46},[83],"## KB Article Draft\n\n**Title:** [Article title]\n**Type:** [How-to \u002F Troubleshooting \u002F FAQ \u002F Known Issue \u002F Reference]\n**Category:** [Product area or topic]\n**Tags:** [Searchable tags]\n**Audience:** [All users \u002F Admins \u002F Developers \u002F Specific plan]\n\n---\n\n[Full article content — using the appropriate template below]\n\n---\n\n### Publishing Notes\n- **Source:** [Ticket #, customer conversation, or internal discussion]\n- **Existing articles to update:** [If this overlaps with existing content]\n- **Review needed from:** [SME or team if technical accuracy needs verification]\n- **Suggested review date:** [When to revisit for accuracy]\n",[293],{"type":41,"tag":87,"props":294,"children":295},{"__ignoreMap":89},[296],{"type":46,"value":291},{"type":41,"tag":145,"props":298,"children":300},{"id":299},"_4-offer-next-steps",[301],{"type":46,"value":302},"4. Offer Next Steps",{"type":41,"tag":53,"props":304,"children":305},{},[306],{"type":46,"value":307},"After generating the article:",{"type":41,"tag":98,"props":309,"children":310},{},[311,316,321,326],{"type":41,"tag":102,"props":312,"children":313},{},[314],{"type":46,"value":315},"\"Want me to check if a similar article already exists in your ~~knowledge base?\"",{"type":41,"tag":102,"props":317,"children":318},{},[319],{"type":46,"value":320},"\"Should I adjust the technical depth for a different audience?\"",{"type":41,"tag":102,"props":322,"children":323},{},[324],{"type":46,"value":325},"\"Want me to draft a companion article (e.g., a how-to to go with this troubleshooting guide)?\"",{"type":41,"tag":102,"props":327,"children":328},{},[329],{"type":46,"value":330},"\"Should I create an internal-only version with additional technical detail?\"",{"type":41,"tag":332,"props":333,"children":334},"hr",{},[],{"type":41,"tag":73,"props":336,"children":338},{"id":337},"article-structure-and-formatting-standards",[339],{"type":46,"value":340},"Article Structure and Formatting Standards",{"type":41,"tag":145,"props":342,"children":344},{"id":343},"universal-article-elements",[345],{"type":46,"value":346},"Universal Article Elements",{"type":41,"tag":53,"props":348,"children":349},{},[350],{"type":46,"value":351},"Every KB article should include:",{"type":41,"tag":353,"props":354,"children":355},"ol",{},[356,366,376,386,396],{"type":41,"tag":102,"props":357,"children":358},{},[359,364],{"type":41,"tag":163,"props":360,"children":361},{},[362],{"type":46,"value":363},"Title",{"type":46,"value":365},": Clear, searchable, describes the outcome or problem (not internal jargon)",{"type":41,"tag":102,"props":367,"children":368},{},[369,374],{"type":41,"tag":163,"props":370,"children":371},{},[372],{"type":46,"value":373},"Overview",{"type":46,"value":375},": 1-2 sentences explaining what this article covers and who it's for",{"type":41,"tag":102,"props":377,"children":378},{},[379,384],{"type":41,"tag":163,"props":380,"children":381},{},[382],{"type":46,"value":383},"Body",{"type":46,"value":385},": Structured content appropriate to the article type",{"type":41,"tag":102,"props":387,"children":388},{},[389,394],{"type":41,"tag":163,"props":390,"children":391},{},[392],{"type":46,"value":393},"Related articles",{"type":46,"value":395},": Links to relevant companion content",{"type":41,"tag":102,"props":397,"children":398},{},[399,404],{"type":41,"tag":163,"props":400,"children":401},{},[402],{"type":46,"value":403},"Metadata",{"type":46,"value":405},": Category, tags, audience, last updated date",{"type":41,"tag":145,"props":407,"children":409},{"id":408},"formatting-rules",[410],{"type":46,"value":411},"Formatting Rules",{"type":41,"tag":98,"props":413,"children":414},{},[415,425,435,445,455,465,475,485,495],{"type":41,"tag":102,"props":416,"children":417},{},[418,423],{"type":41,"tag":163,"props":419,"children":420},{},[421],{"type":46,"value":422},"Use headers (H2, H3)",{"type":46,"value":424}," to break content into scannable sections",{"type":41,"tag":102,"props":426,"children":427},{},[428,433],{"type":41,"tag":163,"props":429,"children":430},{},[431],{"type":46,"value":432},"Use numbered lists",{"type":46,"value":434}," for sequential steps",{"type":41,"tag":102,"props":436,"children":437},{},[438,443],{"type":41,"tag":163,"props":439,"children":440},{},[441],{"type":46,"value":442},"Use bullet lists",{"type":46,"value":444}," for non-sequential items",{"type":41,"tag":102,"props":446,"children":447},{},[448,453],{"type":41,"tag":163,"props":449,"children":450},{},[451],{"type":46,"value":452},"Use bold",{"type":46,"value":454}," for UI element names, key terms, and emphasis",{"type":41,"tag":102,"props":456,"children":457},{},[458,463],{"type":41,"tag":163,"props":459,"children":460},{},[461],{"type":46,"value":462},"Use code blocks",{"type":46,"value":464}," for commands, API calls, error messages, and configuration values",{"type":41,"tag":102,"props":466,"children":467},{},[468,473],{"type":41,"tag":163,"props":469,"children":470},{},[471],{"type":46,"value":472},"Use tables",{"type":46,"value":474}," for comparisons, options, or reference data",{"type":41,"tag":102,"props":476,"children":477},{},[478,483],{"type":41,"tag":163,"props":479,"children":480},{},[481],{"type":46,"value":482},"Use callouts\u002Fnotes",{"type":46,"value":484}," for warnings, tips, and important caveats",{"type":41,"tag":102,"props":486,"children":487},{},[488,493],{"type":41,"tag":163,"props":489,"children":490},{},[491],{"type":46,"value":492},"Keep paragraphs short",{"type":46,"value":494}," — 2-4 sentences max",{"type":41,"tag":102,"props":496,"children":497},{},[498,503],{"type":41,"tag":163,"props":499,"children":500},{},[501],{"type":46,"value":502},"One idea per section",{"type":46,"value":504}," — if a section covers two topics, split it",{"type":41,"tag":73,"props":506,"children":508},{"id":507},"writing-for-searchability",[509],{"type":46,"value":510},"Writing for Searchability",{"type":41,"tag":53,"props":512,"children":513},{},[514],{"type":46,"value":515},"Articles are useless if customers can't find them. Optimize every article for search:",{"type":41,"tag":145,"props":517,"children":519},{"id":518},"title-best-practices",[520],{"type":46,"value":521},"Title Best Practices",{"type":41,"tag":523,"props":524,"children":525},"table",{},[526,550],{"type":41,"tag":527,"props":528,"children":529},"thead",{},[530],{"type":41,"tag":531,"props":532,"children":533},"tr",{},[534,540,545],{"type":41,"tag":535,"props":536,"children":537},"th",{},[538],{"type":46,"value":539},"Good Title",{"type":41,"tag":535,"props":541,"children":542},{},[543],{"type":46,"value":544},"Bad Title",{"type":41,"tag":535,"props":546,"children":547},{},[548],{"type":46,"value":549},"Why",{"type":41,"tag":551,"props":552,"children":553},"tbody",{},[554,573,591,609],{"type":41,"tag":531,"props":555,"children":556},{},[557,563,568],{"type":41,"tag":558,"props":559,"children":560},"td",{},[561],{"type":46,"value":562},"\"How to configure SSO with Okta\"",{"type":41,"tag":558,"props":564,"children":565},{},[566],{"type":46,"value":567},"\"SSO Setup\"",{"type":41,"tag":558,"props":569,"children":570},{},[571],{"type":46,"value":572},"Specific, includes the tool name customers search for",{"type":41,"tag":531,"props":574,"children":575},{},[576,581,586],{"type":41,"tag":558,"props":577,"children":578},{},[579],{"type":46,"value":580},"\"Fix: Dashboard shows blank page\"",{"type":41,"tag":558,"props":582,"children":583},{},[584],{"type":46,"value":585},"\"Dashboard Issue\"",{"type":41,"tag":558,"props":587,"children":588},{},[589],{"type":46,"value":590},"Includes the symptom customers experience",{"type":41,"tag":531,"props":592,"children":593},{},[594,599,604],{"type":41,"tag":558,"props":595,"children":596},{},[597],{"type":46,"value":598},"\"API rate limits and quotas\"",{"type":41,"tag":558,"props":600,"children":601},{},[602],{"type":46,"value":603},"\"API Information\"",{"type":41,"tag":558,"props":605,"children":606},{},[607],{"type":46,"value":608},"Includes the specific terms customers search for",{"type":41,"tag":531,"props":610,"children":611},{},[612,617,622],{"type":41,"tag":558,"props":613,"children":614},{},[615],{"type":46,"value":616},"\"Error: 'Connection refused' when importing data\"",{"type":41,"tag":558,"props":618,"children":619},{},[620],{"type":46,"value":621},"\"Import Problems\"",{"type":41,"tag":558,"props":623,"children":624},{},[625],{"type":46,"value":626},"Includes the exact error message",{"type":41,"tag":145,"props":628,"children":630},{"id":629},"keyword-optimization",[631],{"type":46,"value":632},"Keyword Optimization",{"type":41,"tag":98,"props":634,"children":635},{},[636,646,656,666,676],{"type":41,"tag":102,"props":637,"children":638},{},[639,644],{"type":41,"tag":163,"props":640,"children":641},{},[642],{"type":46,"value":643},"Include exact error messages",{"type":46,"value":645}," — customers copy-paste error text into search",{"type":41,"tag":102,"props":647,"children":648},{},[649,654],{"type":41,"tag":163,"props":650,"children":651},{},[652],{"type":46,"value":653},"Use customer language",{"type":46,"value":655},", not internal terminology — \"can't log in\" not \"authentication failure\"",{"type":41,"tag":102,"props":657,"children":658},{},[659,664],{"type":41,"tag":163,"props":660,"children":661},{},[662],{"type":46,"value":663},"Include common synonyms",{"type":46,"value":665}," — \"delete\u002Fremove\", \"dashboard\u002Fhome page\", \"export\u002Fdownload\"",{"type":41,"tag":102,"props":667,"children":668},{},[669,674],{"type":41,"tag":163,"props":670,"children":671},{},[672],{"type":46,"value":673},"Add alternate phrasings",{"type":46,"value":675}," — address the same issue from different angles in the overview",{"type":41,"tag":102,"props":677,"children":678},{},[679,684],{"type":41,"tag":163,"props":680,"children":681},{},[682],{"type":46,"value":683},"Tag with product areas",{"type":46,"value":685}," — make sure category and tags match how customers think about the product",{"type":41,"tag":145,"props":687,"children":689},{"id":688},"opening-sentence-formula",[690],{"type":46,"value":691},"Opening Sentence Formula",{"type":41,"tag":53,"props":693,"children":694},{},[695],{"type":46,"value":696},"Start every article with a sentence that restates the problem or task in plain language:",{"type":41,"tag":98,"props":698,"children":699},{},[700,718,735,752],{"type":41,"tag":102,"props":701,"children":702},{},[703,708,710,716],{"type":41,"tag":163,"props":704,"children":705},{},[706],{"type":46,"value":707},"How-to",{"type":46,"value":709},": \"This guide shows you how to ",{"type":41,"tag":711,"props":712,"children":713},"span",{},[714],{"type":46,"value":715},"accomplish X",{"type":46,"value":717},".\"",{"type":41,"tag":102,"props":719,"children":720},{},[721,726,728,733],{"type":41,"tag":163,"props":722,"children":723},{},[724],{"type":46,"value":725},"Troubleshooting",{"type":46,"value":727},": \"If you're seeing ",{"type":41,"tag":711,"props":729,"children":730},{},[731],{"type":46,"value":732},"symptom",{"type":46,"value":734},", this article explains how to fix it.\"",{"type":41,"tag":102,"props":736,"children":737},{},[738,743,745,750],{"type":41,"tag":163,"props":739,"children":740},{},[741],{"type":46,"value":742},"FAQ",{"type":46,"value":744},": \"",{"type":41,"tag":711,"props":746,"children":747},{},[748],{"type":46,"value":749},"Question in the customer's words",{"type":46,"value":751},"? Here's the answer.\"",{"type":41,"tag":102,"props":753,"children":754},{},[755,760,762,766],{"type":41,"tag":163,"props":756,"children":757},{},[758],{"type":46,"value":759},"Known issue",{"type":46,"value":761},": \"Some users are experiencing ",{"type":41,"tag":711,"props":763,"children":764},{},[765],{"type":46,"value":732},{"type":46,"value":767},". Here's what we know and how to work around it.\"",{"type":41,"tag":73,"props":769,"children":771},{"id":770},"article-type-templates",[772],{"type":46,"value":773},"Article Type Templates",{"type":41,"tag":145,"props":775,"children":777},{"id":776},"how-to-articles",[778],{"type":46,"value":779},"How-to Articles",{"type":41,"tag":53,"props":781,"children":782},{},[783,788],{"type":41,"tag":163,"props":784,"children":785},{},[786],{"type":46,"value":787},"Purpose",{"type":46,"value":789},": Step-by-step instructions for accomplishing a task.",{"type":41,"tag":53,"props":791,"children":792},{},[793,798],{"type":41,"tag":163,"props":794,"children":795},{},[796],{"type":46,"value":797},"Structure",{"type":46,"value":799},":",{"type":41,"tag":80,"props":801,"children":804},{"className":802,"code":803,"language":46},[83],"# How to [accomplish task]\n\n[Overview — what this guide covers and when you'd use it]\n\n## Prerequisites\n- [What's needed before starting]\n\n## Steps\n### 1. [Action]\n[Instruction with specific details]\n\n### 2. [Action]\n[Instruction]\n\n## Verify It Worked\n[How to confirm success]\n\n## Common Issues\n- [Issue]: [Fix]\n\n## Related Articles\n- [Links]\n",[805],{"type":41,"tag":87,"props":806,"children":807},{"__ignoreMap":89},[808],{"type":46,"value":803},{"type":41,"tag":53,"props":810,"children":811},{},[812,817],{"type":41,"tag":163,"props":813,"children":814},{},[815],{"type":46,"value":816},"Best practices",{"type":46,"value":799},{"type":41,"tag":98,"props":819,"children":820},{},[821,826,831,836],{"type":41,"tag":102,"props":822,"children":823},{},[824],{"type":46,"value":825},"Start each step with a verb",{"type":41,"tag":102,"props":827,"children":828},{},[829],{"type":46,"value":830},"Include the specific path: \"Go to Settings > Integrations > API Keys\"",{"type":41,"tag":102,"props":832,"children":833},{},[834],{"type":46,"value":835},"Mention what the user should see after each step (\"You should see a green confirmation banner\")",{"type":41,"tag":102,"props":837,"children":838},{},[839],{"type":46,"value":840},"Test the steps yourself or verify with a recent ticket resolution",{"type":41,"tag":145,"props":842,"children":844},{"id":843},"troubleshooting-articles",[845],{"type":46,"value":846},"Troubleshooting Articles",{"type":41,"tag":53,"props":848,"children":849},{},[850,854],{"type":41,"tag":163,"props":851,"children":852},{},[853],{"type":46,"value":787},{"type":46,"value":855},": Diagnose and resolve a specific problem.",{"type":41,"tag":53,"props":857,"children":858},{},[859,863],{"type":41,"tag":163,"props":860,"children":861},{},[862],{"type":46,"value":797},{"type":46,"value":799},{"type":41,"tag":80,"props":865,"children":868},{"className":866,"code":867,"language":46},[83],"# [Problem description — what the user sees]\n\n## Symptoms\n- [What the user observes]\n\n## Cause\n[Why this happens — brief, non-jargon explanation]\n\n## Solution\n### Option 1: [Primary fix]\n[Steps]\n\n### Option 2: [Alternative if Option 1 doesn't work]\n[Steps]\n\n## Prevention\n[How to avoid this in the future]\n\n## Still Having Issues?\n[How to get help]\n",[869],{"type":41,"tag":87,"props":870,"children":871},{"__ignoreMap":89},[872],{"type":46,"value":867},{"type":41,"tag":53,"props":874,"children":875},{},[876,880],{"type":41,"tag":163,"props":877,"children":878},{},[879],{"type":46,"value":816},{"type":46,"value":799},{"type":41,"tag":98,"props":882,"children":883},{},[884,889,894,899],{"type":41,"tag":102,"props":885,"children":886},{},[887],{"type":46,"value":888},"Lead with symptoms, not causes — customers search for what they see",{"type":41,"tag":102,"props":890,"children":891},{},[892],{"type":46,"value":893},"Provide multiple solutions when possible (most likely fix first)",{"type":41,"tag":102,"props":895,"children":896},{},[897],{"type":46,"value":898},"Include a \"Still having issues?\" section that points to support",{"type":41,"tag":102,"props":900,"children":901},{},[902],{"type":46,"value":903},"If the root cause is complex, keep the customer-facing explanation simple",{"type":41,"tag":145,"props":905,"children":907},{"id":906},"faq-articles",[908],{"type":46,"value":909},"FAQ Articles",{"type":41,"tag":53,"props":911,"children":912},{},[913,917],{"type":41,"tag":163,"props":914,"children":915},{},[916],{"type":46,"value":787},{"type":46,"value":918},": Quick answer to a common question.",{"type":41,"tag":53,"props":920,"children":921},{},[922,926],{"type":41,"tag":163,"props":923,"children":924},{},[925],{"type":46,"value":797},{"type":46,"value":799},{"type":41,"tag":80,"props":928,"children":931},{"className":929,"code":930,"language":46},[83],"# [Question — in the customer's words]\n\n[Direct answer — 1-3 sentences]\n\n## Details\n[Additional context, nuance, or explanation if needed]\n\n## Related Questions\n- [Link to related FAQ]\n- [Link to related FAQ]\n",[932],{"type":41,"tag":87,"props":933,"children":934},{"__ignoreMap":89},[935],{"type":46,"value":930},{"type":41,"tag":53,"props":937,"children":938},{},[939,943],{"type":41,"tag":163,"props":940,"children":941},{},[942],{"type":46,"value":816},{"type":46,"value":799},{"type":41,"tag":98,"props":945,"children":946},{},[947,952,957],{"type":41,"tag":102,"props":948,"children":949},{},[950],{"type":46,"value":951},"Answer the question in the first sentence",{"type":41,"tag":102,"props":953,"children":954},{},[955],{"type":46,"value":956},"Keep it concise — if the answer needs a walkthrough, it's a how-to, not an FAQ",{"type":41,"tag":102,"props":958,"children":959},{},[960],{"type":46,"value":961},"Group related FAQs and link between them",{"type":41,"tag":145,"props":963,"children":965},{"id":964},"known-issue-articles",[966],{"type":46,"value":967},"Known Issue Articles",{"type":41,"tag":53,"props":969,"children":970},{},[971,975],{"type":41,"tag":163,"props":972,"children":973},{},[974],{"type":46,"value":787},{"type":46,"value":976},": Document a known bug or limitation with a workaround.",{"type":41,"tag":53,"props":978,"children":979},{},[980,984],{"type":41,"tag":163,"props":981,"children":982},{},[983],{"type":46,"value":797},{"type":46,"value":799},{"type":41,"tag":80,"props":986,"children":989},{"className":987,"code":988,"language":46},[83],"# [Known Issue]: [Brief description]\n\n**Status:** [Investigating \u002F Workaround Available \u002F Fix In Progress \u002F Resolved]\n**Affected:** [Who\u002Fwhat is affected]\n**Last updated:** [Date]\n\n## Symptoms\n[What users experience]\n\n## Workaround\n[Steps to work around the issue, or \"No workaround available\"]\n\n## Fix Timeline\n[Expected fix date or current status]\n\n## Updates\n- [Date]: [Update]\n",[990],{"type":41,"tag":87,"props":991,"children":992},{"__ignoreMap":89},[993],{"type":46,"value":988},{"type":41,"tag":53,"props":995,"children":996},{},[997,1001],{"type":41,"tag":163,"props":998,"children":999},{},[1000],{"type":46,"value":816},{"type":46,"value":799},{"type":41,"tag":98,"props":1003,"children":1004},{},[1005,1010,1015],{"type":41,"tag":102,"props":1006,"children":1007},{},[1008],{"type":46,"value":1009},"Keep the status current — nothing erodes trust faster than a stale known issue article",{"type":41,"tag":102,"props":1011,"children":1012},{},[1013],{"type":46,"value":1014},"Update the article when the fix ships and mark as resolved",{"type":41,"tag":102,"props":1016,"children":1017},{},[1018],{"type":46,"value":1019},"If resolved, keep the article live for 30 days for customers still searching the old symptoms",{"type":41,"tag":73,"props":1021,"children":1023},{"id":1022},"review-and-maintenance-cadence",[1024],{"type":46,"value":1025},"Review and Maintenance Cadence",{"type":41,"tag":53,"props":1027,"children":1028},{},[1029],{"type":46,"value":1030},"Knowledge bases decay without maintenance. Follow this schedule:",{"type":41,"tag":523,"props":1032,"children":1033},{},[1034,1055],{"type":41,"tag":527,"props":1035,"children":1036},{},[1037],{"type":41,"tag":531,"props":1038,"children":1039},{},[1040,1045,1050],{"type":41,"tag":535,"props":1041,"children":1042},{},[1043],{"type":46,"value":1044},"Activity",{"type":41,"tag":535,"props":1046,"children":1047},{},[1048],{"type":46,"value":1049},"Frequency",{"type":41,"tag":535,"props":1051,"children":1052},{},[1053],{"type":46,"value":1054},"Who",{"type":41,"tag":551,"props":1056,"children":1057},{},[1058,1079,1100,1121,1142,1162],{"type":41,"tag":531,"props":1059,"children":1060},{},[1061,1069,1074],{"type":41,"tag":558,"props":1062,"children":1063},{},[1064],{"type":41,"tag":163,"props":1065,"children":1066},{},[1067],{"type":46,"value":1068},"New article review",{"type":41,"tag":558,"props":1070,"children":1071},{},[1072],{"type":46,"value":1073},"Before publishing",{"type":41,"tag":558,"props":1075,"children":1076},{},[1077],{"type":46,"value":1078},"Peer review + SME for technical content",{"type":41,"tag":531,"props":1080,"children":1081},{},[1082,1090,1095],{"type":41,"tag":558,"props":1083,"children":1084},{},[1085],{"type":41,"tag":163,"props":1086,"children":1087},{},[1088],{"type":46,"value":1089},"Accuracy audit",{"type":41,"tag":558,"props":1091,"children":1092},{},[1093],{"type":46,"value":1094},"Quarterly",{"type":41,"tag":558,"props":1096,"children":1097},{},[1098],{"type":46,"value":1099},"Support team reviews top-traffic articles",{"type":41,"tag":531,"props":1101,"children":1102},{},[1103,1111,1116],{"type":41,"tag":558,"props":1104,"children":1105},{},[1106],{"type":41,"tag":163,"props":1107,"children":1108},{},[1109],{"type":46,"value":1110},"Stale content check",{"type":41,"tag":558,"props":1112,"children":1113},{},[1114],{"type":46,"value":1115},"Monthly",{"type":41,"tag":558,"props":1117,"children":1118},{},[1119],{"type":46,"value":1120},"Flag articles not updated in 6+ months",{"type":41,"tag":531,"props":1122,"children":1123},{},[1124,1132,1137],{"type":41,"tag":558,"props":1125,"children":1126},{},[1127],{"type":41,"tag":163,"props":1128,"children":1129},{},[1130],{"type":46,"value":1131},"Known issue updates",{"type":41,"tag":558,"props":1133,"children":1134},{},[1135],{"type":46,"value":1136},"Weekly",{"type":41,"tag":558,"props":1138,"children":1139},{},[1140],{"type":46,"value":1141},"Update status on all open known issues",{"type":41,"tag":531,"props":1143,"children":1144},{},[1145,1153,1157],{"type":41,"tag":558,"props":1146,"children":1147},{},[1148],{"type":41,"tag":163,"props":1149,"children":1150},{},[1151],{"type":46,"value":1152},"Analytics review",{"type":41,"tag":558,"props":1154,"children":1155},{},[1156],{"type":46,"value":1115},{"type":41,"tag":558,"props":1158,"children":1159},{},[1160],{"type":46,"value":1161},"Check which articles have low helpfulness ratings or high bounce rates",{"type":41,"tag":531,"props":1163,"children":1164},{},[1165,1173,1177],{"type":41,"tag":558,"props":1166,"children":1167},{},[1168],{"type":41,"tag":163,"props":1169,"children":1170},{},[1171],{"type":46,"value":1172},"Gap analysis",{"type":41,"tag":558,"props":1174,"children":1175},{},[1176],{"type":46,"value":1094},{"type":41,"tag":558,"props":1178,"children":1179},{},[1180],{"type":46,"value":1181},"Identify top ticket topics without KB articles",{"type":41,"tag":145,"props":1183,"children":1185},{"id":1184},"article-lifecycle",[1186],{"type":46,"value":1187},"Article Lifecycle",{"type":41,"tag":353,"props":1189,"children":1190},{},[1191,1201,1211,1221,1231],{"type":41,"tag":102,"props":1192,"children":1193},{},[1194,1199],{"type":41,"tag":163,"props":1195,"children":1196},{},[1197],{"type":46,"value":1198},"Draft",{"type":46,"value":1200},": Written, needs review",{"type":41,"tag":102,"props":1202,"children":1203},{},[1204,1209],{"type":41,"tag":163,"props":1205,"children":1206},{},[1207],{"type":46,"value":1208},"Published",{"type":46,"value":1210},": Live and available to customers",{"type":41,"tag":102,"props":1212,"children":1213},{},[1214,1219],{"type":41,"tag":163,"props":1215,"children":1216},{},[1217],{"type":46,"value":1218},"Needs update",{"type":46,"value":1220},": Flagged for revision (product change, feedback, or age)",{"type":41,"tag":102,"props":1222,"children":1223},{},[1224,1229],{"type":41,"tag":163,"props":1225,"children":1226},{},[1227],{"type":46,"value":1228},"Archived",{"type":46,"value":1230},": No longer relevant but preserved for reference",{"type":41,"tag":102,"props":1232,"children":1233},{},[1234,1239],{"type":41,"tag":163,"props":1235,"children":1236},{},[1237],{"type":46,"value":1238},"Retired",{"type":46,"value":1240},": Removed from the knowledge base",{"type":41,"tag":145,"props":1242,"children":1244},{"id":1243},"when-to-update-vs-create-new",[1245],{"type":46,"value":1246},"When to Update vs. Create New",{"type":41,"tag":53,"props":1248,"children":1249},{},[1250,1255],{"type":41,"tag":163,"props":1251,"children":1252},{},[1253],{"type":46,"value":1254},"Update existing",{"type":46,"value":1256}," when:",{"type":41,"tag":98,"props":1258,"children":1259},{},[1260,1265,1270,1275],{"type":41,"tag":102,"props":1261,"children":1262},{},[1263],{"type":46,"value":1264},"The product changed and steps need refreshing",{"type":41,"tag":102,"props":1266,"children":1267},{},[1268],{"type":46,"value":1269},"The article is mostly right but missing a detail",{"type":41,"tag":102,"props":1271,"children":1272},{},[1273],{"type":46,"value":1274},"Feedback indicates customers are confused by a specific section",{"type":41,"tag":102,"props":1276,"children":1277},{},[1278],{"type":46,"value":1279},"A better workaround or solution was found",{"type":41,"tag":53,"props":1281,"children":1282},{},[1283,1288],{"type":41,"tag":163,"props":1284,"children":1285},{},[1286],{"type":46,"value":1287},"Create new",{"type":46,"value":1256},{"type":41,"tag":98,"props":1290,"children":1291},{},[1292,1297,1302,1307],{"type":41,"tag":102,"props":1293,"children":1294},{},[1295],{"type":46,"value":1296},"A new feature or product area needs documentation",{"type":41,"tag":102,"props":1298,"children":1299},{},[1300],{"type":46,"value":1301},"A resolved ticket reveals a gap — no article exists for this topic",{"type":41,"tag":102,"props":1303,"children":1304},{},[1305],{"type":46,"value":1306},"The existing article covers too many topics and should be split",{"type":41,"tag":102,"props":1308,"children":1309},{},[1310],{"type":46,"value":1311},"A different audience needs the same information explained differently",{"type":41,"tag":73,"props":1313,"children":1315},{"id":1314},"linking-and-categorization-taxonomy",[1316],{"type":46,"value":1317},"Linking and Categorization Taxonomy",{"type":41,"tag":145,"props":1319,"children":1321},{"id":1320},"category-structure",[1322],{"type":46,"value":1323},"Category Structure",{"type":41,"tag":53,"props":1325,"children":1326},{},[1327],{"type":46,"value":1328},"Organize articles into a hierarchy that matches how customers think:",{"type":41,"tag":80,"props":1330,"children":1333},{"className":1331,"code":1332,"language":46},[83],"Getting Started\n├── Account setup\n├── First-time configuration\n└── Quick start guides\n\nFeatures & How-tos\n├── [Feature area 1]\n├── [Feature area 2]\n└── [Feature area 3]\n\nIntegrations\n├── [Integration 1]\n├── [Integration 2]\n└── API reference\n\nTroubleshooting\n├── Common errors\n├── Performance issues\n└── Known issues\n\nBilling & Account\n├── Plans and pricing\n├── Billing questions\n└── Account management\n",[1334],{"type":41,"tag":87,"props":1335,"children":1336},{"__ignoreMap":89},[1337],{"type":46,"value":1332},{"type":41,"tag":145,"props":1339,"children":1341},{"id":1340},"linking-best-practices",[1342],{"type":46,"value":1343},"Linking Best Practices",{"type":41,"tag":98,"props":1345,"children":1346},{},[1347,1364,1380,1396,1406,1416],{"type":41,"tag":102,"props":1348,"children":1349},{},[1350,1355,1357,1362],{"type":41,"tag":163,"props":1351,"children":1352},{},[1353],{"type":46,"value":1354},"Link from troubleshooting to how-to",{"type":46,"value":1356},": \"For setup instructions, see ",{"type":41,"tag":711,"props":1358,"children":1359},{},[1360],{"type":46,"value":1361},"How to configure X",{"type":46,"value":1363},"\"",{"type":41,"tag":102,"props":1365,"children":1366},{},[1367,1372,1374,1379],{"type":41,"tag":163,"props":1368,"children":1369},{},[1370],{"type":46,"value":1371},"Link from how-to to troubleshooting",{"type":46,"value":1373},": \"If you encounter errors, see ",{"type":41,"tag":711,"props":1375,"children":1376},{},[1377],{"type":46,"value":1378},"Troubleshooting X",{"type":46,"value":1363},{"type":41,"tag":102,"props":1381,"children":1382},{},[1383,1388,1390,1395],{"type":41,"tag":163,"props":1384,"children":1385},{},[1386],{"type":46,"value":1387},"Link from FAQ to detailed articles",{"type":46,"value":1389},": \"For a full walkthrough, see ",{"type":41,"tag":711,"props":1391,"children":1392},{},[1393],{"type":46,"value":1394},"Guide to X",{"type":46,"value":1363},{"type":41,"tag":102,"props":1397,"children":1398},{},[1399,1404],{"type":41,"tag":163,"props":1400,"children":1401},{},[1402],{"type":46,"value":1403},"Link from known issues to workarounds",{"type":46,"value":1405},": Keep the chain from problem to solution short",{"type":41,"tag":102,"props":1407,"children":1408},{},[1409,1414],{"type":41,"tag":163,"props":1410,"children":1411},{},[1412],{"type":46,"value":1413},"Use relative links",{"type":46,"value":1415}," within the KB — they survive restructuring better than absolute URLs",{"type":41,"tag":102,"props":1417,"children":1418},{},[1419,1424],{"type":41,"tag":163,"props":1420,"children":1421},{},[1422],{"type":46,"value":1423},"Avoid circular links",{"type":46,"value":1425}," — if A links to B, B shouldn't link back to A unless both are genuinely useful entry points",{"type":41,"tag":73,"props":1427,"children":1429},{"id":1428},"kb-writing-best-practices",[1430],{"type":46,"value":1431},"KB Writing Best Practices",{"type":41,"tag":353,"props":1433,"children":1434},{},[1435,1440,1445,1450,1455,1460,1465],{"type":41,"tag":102,"props":1436,"children":1437},{},[1438],{"type":46,"value":1439},"Write for the customer who is frustrated and searching for an answer — be clear, direct, and helpful",{"type":41,"tag":102,"props":1441,"children":1442},{},[1443],{"type":46,"value":1444},"Every article should be findable through search using the words a customer would type",{"type":41,"tag":102,"props":1446,"children":1447},{},[1448],{"type":46,"value":1449},"Test your articles — follow the steps yourself or have someone unfamiliar with the topic follow them",{"type":41,"tag":102,"props":1451,"children":1452},{},[1453],{"type":46,"value":1454},"Keep articles focused — one problem, one solution. Split if an article is growing too long",{"type":41,"tag":102,"props":1456,"children":1457},{},[1458],{"type":46,"value":1459},"Maintain aggressively — a wrong article is worse than no article",{"type":41,"tag":102,"props":1461,"children":1462},{},[1463],{"type":46,"value":1464},"Track what's missing — every ticket that could have been a KB article is a content gap",{"type":41,"tag":102,"props":1466,"children":1467},{},[1468],{"type":46,"value":1469},"Measure impact — articles that don't get traffic or don't reduce tickets need to be improved or retired",{"items":1471,"total":1656},[1472,1493,1507,1519,1538,1551,1572,1592,1604,1619,1627,1640],{"slug":1473,"name":1473,"fn":1474,"description":1475,"org":1476,"tags":1477,"stars":1490,"repoUrl":1491,"updatedAt":1492},"algorithmic-art","create algorithmic art with p5.js","Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1478,1481,1484,1487],{"name":1479,"slug":1480,"type":16},"Creative","creative",{"name":1482,"slug":1483,"type":16},"Design","design",{"name":1485,"slug":1486,"type":16},"Generative Art","generative-art",{"name":1488,"slug":1489,"type":16},"JavaScript","javascript",161831,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fskills","2026-04-06T17:56:15.455818",{"slug":1494,"name":1494,"fn":1495,"description":1496,"org":1497,"tags":1498,"stars":1490,"repoUrl":1491,"updatedAt":1506},"brand-guidelines","apply Anthropic brand colors and typography","Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1499,1502,1503],{"name":1500,"slug":1501,"type":16},"Branding","branding",{"name":1482,"slug":1483,"type":16},{"name":1504,"slug":1505,"type":16},"Typography","typography","2026-04-06T17:56:05.042852",{"slug":1508,"name":1508,"fn":1509,"description":1510,"org":1511,"tags":1512,"stars":1490,"repoUrl":1491,"updatedAt":1518},"canvas-design","create posters and visual art as PNG or PDF","Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1513,1514,1515],{"name":1479,"slug":1480,"type":16},{"name":1482,"slug":1483,"type":16},{"name":1516,"slug":1517,"type":16},"PDF","pdf","2026-04-06T17:56:03.794732",{"slug":1520,"name":1520,"fn":1521,"description":1522,"org":1523,"tags":1524,"stars":1490,"repoUrl":1491,"updatedAt":1537},"claude-api","build apps with the Claude API","Reference for the Claude API \u002F Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration.\nTRIGGER — read BEFORE opening the target file; don't skip because it \"looks like a one-liner\" — whenever: the prompt names Claude\u002FAnthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing\u002Fmodel choice\u002Flimits\u002Fcaching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent\u002FMCP\u002Ftool-definition\u002Fmulti-agent\u002FRAG\u002FLLM-judge\u002Fcomputer-use; generate\u002Fsummarize\u002Fextract\u002Fclassify\u002Frewrite\u002Fconverse over NL; debugging refusals\u002Fcutoffs\u002Fstreaming\u002Ftool-calls\u002Ftokens).\nSKIP only when another provider is being worked on (overrides all triggers): OpenAI\u002FGPT\u002FGemini\u002FLlama\u002FMistral\u002FCohere\u002FOllama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1525,1528,1529,1532,1534],{"name":1526,"slug":1527,"type":16},"Agents","agents",{"name":9,"slug":8,"type":16},{"name":1530,"slug":1531,"type":16},"Anthropic SDK","anthropic-sdk",{"name":1533,"slug":1520,"type":16},"Claude API",{"name":1535,"slug":1536,"type":16},"LLM","llm","2026-07-28T05:36:08.213335",{"slug":1539,"name":1539,"fn":1540,"description":1541,"org":1542,"tags":1543,"stars":1490,"repoUrl":1491,"updatedAt":1550},"doc-coauthoring","co-author documentation and technical specs","Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1544,1547],{"name":1545,"slug":1546,"type":16},"Documentation","documentation",{"name":1548,"slug":1549,"type":16},"Technical Writing","technical-writing","2026-04-06T17:56:14.18897",{"slug":1552,"name":1552,"fn":1553,"description":1554,"org":1555,"tags":1556,"stars":1490,"repoUrl":1491,"updatedAt":1571},"docx","create and edit Word documents","Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1557,1560,1562,1565,1568],{"name":1558,"slug":1559,"type":16},"Documents","documents",{"name":1561,"slug":1552,"type":16},"DOCX",{"name":1563,"slug":1564,"type":16},"Office","office",{"name":1566,"slug":1567,"type":16},"Templates","templates",{"name":1569,"slug":1570,"type":16},"Word","word","2026-07-18T05:16:23.136271",{"slug":1573,"name":1573,"fn":1574,"description":1575,"org":1576,"tags":1577,"stars":1490,"repoUrl":1491,"updatedAt":1591},"frontend-design","design production-grade frontend interfaces","Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1578,1579,1582,1585,1588],{"name":1482,"slug":1483,"type":16},{"name":1580,"slug":1581,"type":16},"Frontend","frontend",{"name":1583,"slug":1584,"type":16},"React","react",{"name":1586,"slug":1587,"type":16},"Tailwind CSS","tailwind-css",{"name":1589,"slug":1590,"type":16},"UI Components","ui-components","2026-04-06T17:56:16.723469",{"slug":1593,"name":1593,"fn":1594,"description":1595,"org":1596,"tags":1597,"stars":1490,"repoUrl":1491,"updatedAt":1603},"internal-comms","write internal company communications","A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1598,1601,1602],{"name":1599,"slug":1600,"type":16},"Communications","communications",{"name":1566,"slug":1567,"type":16},{"name":14,"slug":15,"type":16},"2026-04-06T17:56:20.695522",{"slug":1605,"name":1605,"fn":1606,"description":1607,"org":1608,"tags":1609,"stars":1490,"repoUrl":1491,"updatedAt":1618},"mcp-builder","build MCP servers","Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node\u002FTypeScript (MCP SDK).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1610,1611,1614,1615],{"name":1526,"slug":1527,"type":16},{"name":1612,"slug":1613,"type":16},"API Development","api-development",{"name":1535,"slug":1536,"type":16},{"name":1616,"slug":1617,"type":16},"MCP","mcp","2026-04-06T17:56:10.357665",{"slug":1517,"name":1517,"fn":1620,"description":1621,"org":1622,"tags":1623,"stars":1490,"repoUrl":1491,"updatedAt":1626},"read edit and manipulate PDF files","Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text\u002Ftables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting\u002Fdecrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1624,1625],{"name":1558,"slug":1559,"type":16},{"name":1516,"slug":1517,"type":16},"2026-04-06T17:56:02.483316",{"slug":1628,"name":1628,"fn":1629,"description":1630,"org":1631,"tags":1632,"stars":1490,"repoUrl":1491,"updatedAt":1639},"pptx","create and edit PowerPoint presentations","Use this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1633,1636],{"name":1634,"slug":1635,"type":16},"PowerPoint","powerpoint",{"name":1637,"slug":1638,"type":16},"Presentations","presentations","2026-07-18T05:16:24.1471",{"slug":1641,"name":1641,"fn":1642,"description":1643,"org":1644,"tags":1645,"stars":1490,"repoUrl":1491,"updatedAt":1655},"skill-creator","create and optimize agent skills","Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1646,1647,1648,1651,1654],{"name":1526,"slug":1527,"type":16},{"name":1545,"slug":1546,"type":16},{"name":1649,"slug":1650,"type":16},"Evals","evals",{"name":1652,"slug":1653,"type":16},"Performance","performance",{"name":1548,"slug":1549,"type":16},"2026-04-19T06:45:40.804",490,{"items":1658,"total":1765},[1659,1673,1689,1705,1721,1740,1752],{"slug":1660,"name":1660,"fn":1661,"description":1662,"org":1663,"tags":1664,"stars":23,"repoUrl":24,"updatedAt":1672},"accessibility-review","run WCAG accessibility audits","Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with \"audit accessibility\", \"check a11y\", \"is this accessible?\", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1665,1668,1669],{"name":1666,"slug":1667,"type":16},"Accessibility","accessibility",{"name":1482,"slug":1483,"type":16},{"name":1670,"slug":1671,"type":16},"WCAG","wcag","2026-04-06T17:58:05.682394",{"slug":1674,"name":1674,"fn":1675,"description":1676,"org":1677,"tags":1678,"stars":23,"repoUrl":24,"updatedAt":1688},"account-research","research accounts for sales intel","Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with \"research [company]\", \"look up [person]\", \"intel on [prospect]\", \"who is [name] at [company]\", or \"tell me about [company]\".",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1679,1682,1685],{"name":1680,"slug":1681,"type":16},"CRM","crm",{"name":1683,"slug":1684,"type":16},"Research","research",{"name":1686,"slug":1687,"type":16},"Sales","sales","2026-04-06T17:56:41.410418",{"slug":1690,"name":1690,"fn":1691,"description":1692,"org":1693,"tags":1694,"stars":23,"repoUrl":24,"updatedAt":1704},"analyze","answer data questions and run analyses","Answer data questions -- from quick lookups to full analyses. Use when looking up a single metric, investigating what's driving a trend or drop, comparing segments over time, or preparing a formal data report for stakeholders.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1695,1698,1701],{"name":1696,"slug":1697,"type":16},"Analytics","analytics",{"name":1699,"slug":1700,"type":16},"Data Analysis","data-analysis",{"name":1702,"slug":1703,"type":16},"SQL","sql","2026-04-06T17:57:21.593647",{"slug":1706,"name":1706,"fn":1707,"description":1708,"org":1709,"tags":1710,"stars":23,"repoUrl":24,"updatedAt":1720},"architecture","create and evaluate architecture decision records","Create or evaluate an architecture decision record (ADR). Use when choosing between technologies (e.g., Kafka vs SQS), documenting a design decision with trade-offs and consequences, reviewing a system design proposal, or designing a new component from requirements and constraints.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1711,1714,1716,1717],{"name":1712,"slug":1713,"type":16},"ADR","adr",{"name":1715,"slug":1706,"type":16},"Architecture",{"name":1545,"slug":1546,"type":16},{"name":1718,"slug":1719,"type":16},"Engineering","engineering","2026-04-06T17:57:49.26444",{"slug":1722,"name":1722,"fn":1723,"description":1724,"org":1725,"tags":1726,"stars":23,"repoUrl":24,"updatedAt":1739},"audit-support","support SOX 404 control testing","Support SOX 404 compliance with control testing methodology, sample selection, and documentation standards. Use when generating testing workpapers, selecting audit samples, classifying control deficiencies, or preparing for internal or external audits.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1727,1730,1733,1736],{"name":1728,"slug":1729,"type":16},"Audit","audit",{"name":1731,"slug":1732,"type":16},"Finance","finance",{"name":1734,"slug":1735,"type":16},"Regulatory Compliance","regulatory-compliance",{"name":1737,"slug":1738,"type":16},"SOX","sox","2026-04-06T17:57:36.714815",{"slug":1741,"name":1741,"fn":1742,"description":1743,"org":1744,"tags":1745,"stars":23,"repoUrl":24,"updatedAt":1751},"brand-review","review content against brand voice","Review content against your brand voice, style guide, and messaging pillars, flagging deviations by severity with specific before\u002Fafter fixes. Use when checking a draft before it ships, when auditing copy for voice consistency and terminology, or when screening for unsubstantiated claims, missing disclaimers, and other legal flags.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1746,1747,1750],{"name":1500,"slug":1501,"type":16},{"name":1748,"slug":1749,"type":16},"Marketing","marketing",{"name":14,"slug":15,"type":16},"2026-04-06T17:58:19.548331",{"slug":1753,"name":1753,"fn":1754,"description":1755,"org":1756,"tags":1757,"stars":23,"repoUrl":24,"updatedAt":1764},"brand-voice-enforcement","enforce brand voice in content","This skill applies brand guidelines to content creation. It should be used when the user asks to \"write an email\", \"draft a proposal\", \"create a pitch deck\", \"write a LinkedIn post\", \"draft a presentation\", \"write a Slack message\", \"draft sales content\", or any content creation request where brand voice should be applied. Also triggers on \"on-brand\", \"brand voice\", \"enforce voice\", \"apply brand guidelines\", \"brand-aligned content\", \"write in our voice\", \"use our brand tone\", \"make this sound like us\", \"rewrite this in our tone\", or \"this doesn't sound on-brand\". Not for generating guidelines from scratch (use guideline-generation) or discovering brand materials (use discover-brand).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1758,1759,1760,1763],{"name":1500,"slug":1501,"type":16},{"name":1599,"slug":1600,"type":16},{"name":1761,"slug":1762,"type":16},"Content Creation","content-creation",{"name":14,"slug":15,"type":16},"2026-04-06T18:00:23.528956",200]