Claude-skill-registry generating-glossaries-and-definitions
Builds product and industry glossaries with SEO-optimized definitions. Use when the user asks about glossary creation, term definitions, jargon explanations, knowledge bases, or terminology documentation.
install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/glossary-definition-generator" ~/.claude/skills/majiayu000-claude-skill-registry-generating-glossaries-and-definitions && rm -rf "$T"
manifest:
skills/data/glossary-definition-generator/SKILL.mdsource content
Glossary & Definition Generator
When to use this skill
- User asks to create a glossary
- User needs term definitions
- User wants to explain jargon
- User mentions terminology documentation
- User needs a knowledge base of terms
Workflow
- Identify terms to define
- Research accurate definitions
- Write SEO-optimized entries
- Link related terms
- Format for target output
- Validate completeness
Instructions
Step 1: Term Collection
Gather terms from these sources:
| Source | Method |
|---|---|
| Product documentation | Extract technical terms |
| Customer support tickets | Find confusing jargon |
| Competitor glossaries | Identify industry standards |
| Search queries | Check what users search |
| Internal team | Collect tribal knowledge |
Create a term inventory:
## Term Inventory | Term | Category | Priority | Status | | ------ | ---------- | ------------ | -------- | | [Term] | [Category] | High/Med/Low | To write | | [Term] | [Category] | High/Med/Low | Draft |
Prioritization criteria:
- High: Core product/industry terms users must understand
- Medium: Common terms that appear frequently
- Low: Advanced/niche terms for power users
Step 2: Definition Structure
Each glossary entry should include:
## [Term] **Definition:** [Clear, concise explanation in 1-2 sentences] **Example:** [Real-world usage or context] **Related terms:** [Link to connected entries] **Also known as:** [Synonyms or abbreviations]
Step 3: Writing Definitions
Definition formulas:
| Type | Formula | Example |
|---|---|---|
| Simple | "[Term] is [category] that [function]." | "An API is a set of protocols that allows software applications to communicate." |
| Technical | "[Term] refers to [technical description]. It [purpose]." | "Latency refers to the delay between a request and response. It affects user experience." |
| Comparison | "[Term] is similar to [known concept], but [difference]." | "A CMS is similar to a word processor, but designed for web content." |
Writing guidelines:
- Lead with the simplest explanation
- Avoid circular definitions (don't use the term to define itself)
- Include the "why it matters" context
- Target 50-150 words per definition
- Write for the least technical reader
Step 4: SEO Optimization
Featured Snippet Targeting
Structure definitions for position zero:
## What is [Term]? [Term] is [40-60 word definition that directly answers the question].
Keyword Integration
| Element | Optimization |
|---|---|
| H1/H2 | "What is [Term]?" or "[Term] Definition" |
| First sentence | Include term within first 10 words |
| Meta title | "[Term]: Definition, Examples & Guide" |
| Meta description | "Learn what [term] means, why it matters, and see examples. Simple explanation of [term] for beginners." |
| URL | |
Schema Markup
{ "@context": "https://schema.org", "@type": "DefinedTerm", "name": "[Term]", "description": "[Definition]", "inDefinedTermSet": { "@type": "DefinedTermSet", "name": "[Company] Glossary" } }
Step 5: Related Term Linking
Create a relationship map:
## Term Relationships ### [Term A] - **Parent:** [Broader concept] - **Children:** [More specific terms] - **Siblings:** [Related same-level terms] - **See also:** [Loosely related terms]
Linking rules:
- Link on first mention of related term
- 3-5 related terms per entry
- Ensure bidirectional links
- Group related terms in categories
Step 6: Category Organization
Structure glossary by topic:
## Glossary Categories ### Getting Started - [Basic term 1] - [Basic term 2] ### [Product Feature] - [Feature term 1] - [Feature term 2] ### Technical - [Technical term 1] - [Technical term 2] ### Industry - [Industry term 1] - [Industry term 2]
Step 7: Output Formats
Website Glossary Page
# [Industry/Product] Glossary A comprehensive guide to [industry] terminology. ## A ### [Term starting with A] [Definition] **Related:** [Links] ## B ### [Term starting with B] [Definition] **Related:** [Links] [Continue A-Z structure]
Individual Term Pages
# What is [Term]? [Definition paragraph - 50-100 words] ## How [Term] Works [Explanation with examples - 100-200 words] ## Why [Term] Matters [Business/practical context - 50-100 words] ## [Term] Examples - **Example 1:** [Description] - **Example 2:** [Description] ## Related Terms - [[Related Term 1]](/glossary/related-term-1) - [[Related Term 2]](/glossary/related-term-2) ## FAQ **Q: [Common question about term]?** A: [Answer]
Downloadable Resource
# [Industry] Terminology Guide ## Introduction [Brief overview of why this glossary exists] ## Quick Reference | Term | Definition | | -------- | ------------------ | | [Term 1] | [Brief definition] | | [Term 2] | [Brief definition] | ## Full Definitions ### [Term 1] [Complete definition with examples] ### [Term 2] [Complete definition with examples] ## Index [Alphabetical list with page numbers]
Widget/Tooltip Format
{ "terms": [ { "term": "[Term]", "definition": "[Short definition - max 100 chars]", "url": "/glossary/[term-slug]" } ] }
Output Format
# Glossary: [Industry/Product] ## Overview **Total terms:** [#] **Categories:** [List] **Target audience:** [Audience] --- ## Terms ### [Term 1] **Definition:** [Clear explanation] **Example:** [Usage example] **Related terms:** [Term 2], [Term 3] **Also known as:** [Synonyms] --- ### [Term 2] **Definition:** [Clear explanation] **Example:** [Usage example] **Related terms:** [Term 1], [Term 4] --- ## Category Index ### [Category 1] - [Term] - [Term] ### [Category 2] - [Term] - [Term] --- ## SEO Metadata | Term | Meta Title | Meta Description | | -------- | ---------- | ---------------- | | [Term 1] | [Title] | [Description] | | [Term 2] | [Title] | [Description] |
Validation
Before completing:
- All priority terms defined
- Definitions are clear and accurate
- No circular definitions
- Related terms linked bidirectionally
- Categories logically organized
- SEO elements included
- Consistent formatting throughout
- Spelling and grammar checked
Error Handling
- Term already exists: Check for duplicates; merge or differentiate entries.
- Definition too technical: Simplify language; add "in other words" explanation.
- No related terms: Review category; every term should connect to at least one other.
- Conflicting definitions: Research authoritative sources; note if term has multiple meanings.
Resources
- Schema.org DefinedTerm - Structured data reference
- Google Search Central - SEO guidance
- Merriam-Webster - Definition style reference
- Hemingway Editor - Readability checking