skills/wesleysmits/agent-skills/generating-glossaries-and-definitions

generating-glossaries-and-definitions

SKILL.md

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 /glossary/[term-slug]

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

Weekly Installs
3
GitHub Stars
2
First Seen
Jan 24, 2026
Installed on
opencode3
gemini-cli3
codex3
cursor3
codebuddy2
claude-code2