Knowledge Management

What it does

This skill enables AI agents to create, organize, and maintain support knowledge base (KB) articles that are designed to solve customer problems efficiently. It focuses on writing clear, searchable content with a structure optimized for quick comprehension and problem resolution, ultimately aiming to reduce the volume of support tickets. The skill incorporates specific formatting rules and search optimization techniques to ensure articles are easily discoverable and helpful to users.

When to use it

• Generating step-by-step guides ("How-to" articles) for completing tasks.
• Creating troubleshooting articles to address specific customer issues or symptoms.
• Developing FAQ entries that answer common customer questions in plain language.
• Documenting known issues and providing workarounds for users experiencing problems.
• Organizing existing information into a structured, searchable knowledge base format.

Key capabilities

• Article Structure: Enforces specific elements like Title, Overview, Body, Related Articles, and Metadata.
• Formatting Standards: Dictates the use of headers (H2, H3), lists (numbered & bulleted), bolding, code blocks, tables, and callouts for clarity.
• Search Optimization: Provides guidance on title best practices, keyword optimization, and using customer language.
• Opening Sentence Formula: Suggests specific sentence structures to begin articles based on their type (How-to, Troubleshooting, FAQ, Known Issue).
• Article Type Expertise: Supports the creation of How-to, Troubleshooting, and FAQ article types.

Example prompts

• "Write a 'How-to' article explaining how to configure SSO with Okta."
• "Create a troubleshooting article for users seeing a blank page on the dashboard."
• "Draft an FAQ entry answering the question: 'How do I export my data?'"

Tips & gotchas

• Focus on Customer Language: Avoid internal jargon and use terms customers actually search for.
• Specificity is Key: Titles should be specific, including tool names or exact error messages.
• Searchability First: Prioritize optimizing articles for search to ensure they are easily found by users.