Agent skill
knowledge-management-title-best-practices
Sub-skill of knowledge-management: Title Best Practices (+2).
Install this agent skill to your Project
npx add-skill https://github.com/vamseeachanta/workspace-hub/tree/main/.claude/skills/_archive/business/customer-support/knowledge-management/title-best-practices
SKILL.md
Title Best Practices (+2)
Title Best Practices
| Good Title | Bad Title | Why |
|---|---|---|
| "How to configure SSO with Okta" | "SSO Setup" | Specific, includes the tool name customers search for |
| "Fix: Dashboard shows blank page" | "Dashboard Issue" | Includes the symptom customers experience |
| "API rate limits and quotas" | "API Information" | Includes the specific terms customers search for |
| "Error: 'Connection refused' when importing data" | "Import Problems" | Includes the exact error message |
Keyword Optimization
- Include exact error messages -- customers copy-paste error text into search
- Use customer language, not internal terminology -- "can't log in" not "authentication failure"
- Include common synonyms -- "delete/remove", "dashboard/home page", "export/download"
- Add alternate phrasings -- address the same issue from different angles in the overview
- Tag with product areas -- make sure category and tags match how customers think about the product
Opening Sentence Formula
Start every article with a sentence that restates the problem or task in plain language:
- How-to: "This guide shows you how to [accomplish X]."
- Troubleshooting: "If you're seeing [symptom], this article explains how to fix it."
- FAQ: "[Question in the customer's words]? Here's the answer."
- Known issue: "Some users are experiencing [symptom]. Here's what we know and how to work around it."
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
vamseeachanta/workspace-hub
gsd-complete-milestone
Archive completed milestone and prepare for next version
vamseeachanta/workspace-hub
gsd-reapply-patches
Reapply local modifications after a GSD update
vamseeachanta/workspace-hub
gsd-verify-work
Validate built features through conversational UAT
vamseeachanta/workspace-hub
gsd-thread
Manage persistent context threads for cross-session work
vamseeachanta/workspace-hub
clinical-trial-protocol
Generate clinical trial protocols for medical devices or drugs through a modular, waypoint-based architecture with research-only and full protocol modes.
vamseeachanta/workspace-hub
single-cell-rna-qc
Performs quality control on single-cell RNA-seq data (.h5ad or .h5 files) using scverse best practices with MAD-based filtering and comprehensive visualizations.
Didn't find tool you were looking for?