Agent skill · writing content · anthropics
kb-article
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.
Why this skill is useful
Provides a structured template and specific guidelines for drafting knowledge base articles that enhance the AI's ability to generate self-service documentation.
What it needs
About 8k tokens when loaded. Last updated 2026-08-07. 23,345 stars on the source repository.
What this skill does
/kb-article If you see unfamiliar placeholders or need to check which tools are connected, see CONNECTORS.md. 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. Usage Examples: /kb-article How to configure SSO with Okta — resolved this for 3 customers last month /kb-article Ticket #4521 — customer couldn't export data over 10k rows /kb-article Common question: how to set up webhook notifications /kb-article Known issue: dashboard charts not loading on Safari 16 Workflow 1. Understand the Source Material Parse the input to identify: What was the problem? The original issue, question, or error What was the solution? The resolution, workaround, or answer Who does this affect? User type, plan level, or configuration How common is this? One-off or recurring issue What article type fits best? How-to, troubleshooting, FAQ, known issue, or reference (see article types below) If a ticket reference is provided, look up the full context: ~~support platform: Pull the ticket thread, resolution, and any internal notes ~~knowledge base: Check if a similar article already exists (update vs. create new) ~~project tracker: Check if there's a related bug or feature request 2. Draft the Article Using the article structure, formatting standards, and searchability best practices below: Follow the template for the chosen article type (how-to, troubleshooting, FAQ, known issue, or reference) Apply the searchability best practices: customer-language title, plain-language opening sentence, exact error messages, common synonyms Keep it scannable: headers, numbered steps, short paragraphs 3. Generate the Article Present the draft with metadata: 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills anthropics/kb-article