Localized reading guide
kb-articlePurpose, usage and source
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.
Source retrieved:
- Source repository
- anthropics/knowledge-work-plugins
- SKILL.md
customer-support/skills/kb-article/SKILL.md- Repository stars
- 34,049
- Repository updated
- 2026-10-30
- Categories
- Documents
- Last collected
License: License file needs review
Workflow excerpts are reading aids, not executable instructions from Codez. No third-party Skill was run to produce this page.
The purpose and workflow passages below are upstream material, organized and translated for reading. They are distinct from the separately labeled Codez editorial analysis.
What this Skill does
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.
How the upstream workflow works
Usage
/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
4. Offer Next Steps
After generating the article: "Want me to check if a similar article already exists in your ~~knowledge base?" "Should I adjust the technical depth for a different audience?" "Want me to draft a companion article (e.g., a how-to to go with this troubleshooting guide)?"
Upstream passage · L77 ↗When to Update vs. Create New
Update existing when: The product changed and steps need refreshing The article is mostly right but missing a detail Feedback indicates customers are confused by a specific section
Upstream passage · L287 ↗/kb-article <resolved issue, ticket reference, or topic description>Requirements and setup
No short requirements passage was selected from this file. This does not mean the Skill has no dependencies. Check the repository setup instructions and referenced files.
Limits and quality checks
No separate limits passage was selected from this file. This does not mean the Skill is safe for every input or environment. Review the complete source and validate your own result.
Start with a safe trial
- Check the supported host and the repository installation instructions. Keep the Skill directory and its referenced scripts, assets and documentation together; SKILL.md alone may omit dependencies.
- Give the agent your real input, desired output and acceptance criteria. Invocation syntax and available tools depend on the host; this site does not assume a universal install command.
- Try the source workflow in a disposable project or on a copy. Review operations that change files, remote services or billable resources before allowing them.
- Validate the output against the source quality checks and your own requirements. A successful trigger or a high repository Star count does not establish a correct result.
Read further in the source
- /kb-article
- Usage
- 1. Understand the Source Material
- 2. Draft the Article
- 3. Generate the Article
- 4. Offer Next Steps
- Universal Article Elements
- Formatting Rules
- Writing for Searchability
- Keyword Optimization
- Opening Sentence Formula
- How-to Articles
- Troubleshooting Articles
- FAQ Articles
- Known Issue Articles
- Review and Maintenance Cadence
- Article Lifecycle
- When to Update vs. Create New
- Category Structure
- Linking Best Practices
- KB Writing Best Practices
Related Skills
Translation and scope
This reading guide selects passages from the pinned upstream SKILL.md. Translation is assisted. It is not a complete manual or a claim of tested compatibility. Read the original and its referenced files before use.
This introduction refers to the pinned version below; current repository activity and collection time are shown separately.
- Pinned source
- Read the original ↗
- Source retrieved
- Source commit
2574e29377c7173d0cecffef29a6ecbd7f8ccb5d- Source SHA-256
cfc300f5ecc5128910a8ff04514d565a45ca9178bf1dc2a40cc40e2ce4db9292