003 Name Skill 8a2b1ebc

---
name: pages-glossary
description: When the user wants to create, optimize, or audit glossary page content and structure. Also use when the user mentions "glossary," "definitions," "terminology," or "industry terms."
metadata:
  version: 1.0.0
---

# Pages: Glossary

Guides glossary page structure, content, and internal linking for SEO.

**When invoking**: On **first use**, if helpful, open with 1-2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.

## Initial Assessment

**Check for product marketing context first:** If `.claude/product-marketing-context.md` or `.cursor/product-marketing-context.md` exists, read it for industry terms and customer language.

Identify:
1. **Domain**: SEO, marketing, tech, industry-specific
2. **Audience**: Beginners, practitioners, both
3. **Content volume**: Number of terms

## Best Practices

### Structure

| Element | Purpose |
|---------|---------|
| **Alphabetical index** | A-Z or by category |
| **Term + definition** | Clear, concise explanation |
| **Related terms** | Cross-links within glossary |
| **Internal links** | Link to relevant blog/content |
| **Search** | Help users find terms |

### Definition Quality

- **Clear**: Jargon-free where possible
- **Concise**: One paragraph typical
- **Context**: How term is used in your domain
- **Examples**: When helpful

### Internal Linking Strategy

- **Anchor text**: Descriptive, keyword-rich; avoid "click here"
- **Variation**: Mix anchor phrases; don't repeat identical text
- **Placement**: Higher on page = more valuable
- **Relevance**: Link to most valuable next content
- **Avoid orphans**: Ensure every term page has inbound links

### SEO Benefits

- **Topic clusters**: Glossary as hub; links to and from pillar content; see seo-content-content-strategy
- **Long-tail**: Definition queries, "what is X"
- **Crawlability**: Reduces depth; distributes authority
- **User engagement**: Helps users understand; keeps them on site

### Maintenance

- **New terms**: Add as content expands
- **Audit links**: Periodically check internal links
- **Update**: Keep definitions current

## Output Format

- **Structure** (index, layout)
- **Term** template (definition format)
- **Internal linking** plan
- **SEO** metadata
- **Schema**: DefinedTerm or similar if applicable

## Related Skills

- **components-url-slug**: URL slug for glossary terms (e.g. /glossary/term-slug); 3-5 words
- **seo-on-page-internal-links**: Glossary is internal linking hub
- **seo-content-content-strategy**: Glossary supports content clusters
- **pages-blog**: Link between glossary and blog
- **seo-on-page-title, seo-on-page-description, seo-on-page-metadata**: Glossary page metadata