# Knowledge Management Universal Article Elements

> Sub-skill of knowledge-management: Universal Article Elements (+1).

- Skill: `vamseeachanta/knowledge-management-universal-article-elements` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/knowledge-management-universal-article-elements`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/knowledge-management-universal-article-elements/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/knowledge-management-universal-article-elements

---


# Universal Article Elements (+1)

## Universal Article Elements


Every KB article should include:

1. **Title**: Clear, searchable, describes the outcome or problem (not internal jargon)
2. **Overview**: 1-2 sentences explaining what this article covers and who it's for
3. **Body**: Structured content appropriate to the article type
4. **Related articles**: Links to relevant companion content
5. **Metadata**: Category, tags, audience, last updated date


## Formatting Rules


- **Use headers (H2, H3)** to break content into scannable sections
- **Use numbered lists** for sequential steps
- **Use bullet lists** for non-sequential items
- **Use bold** for UI element names, key terms, and emphasis
- **Use code blocks** for commands, API calls, error messages, and configuration values
- **Use tables** for comparisons, options, or reference data
- **Use callouts/notes** for warnings, tips, and important caveats
- **Keep paragraphs short** -- 2-4 sentences max
- **One idea per section** -- if a section covers two topics, split it