/generate-thesaurus

type: Skill
name: generate-thesaurus
description: Generate controlled vocabulary thesaurus for content domains. Creates comprehensive thesauri with preferred terms, broader/narrower/related terms.
required_roles:
  scribe: roles/scribe.editor
personas: [information-architect, technical-writer, content-strategist]
generated:
  by: process:google-labs-jules
  at: 2026-01-29T21:19:07Z

Generate Thesaurus Skill

Generate a controlled vocabulary thesaurus for a specified content domain or directory. This skill analyzes content to identify key terms and structures them into a thesaurus with relationships (broader, narrower, related terms).

Inputs

• `PATH` - The directory or file path to analyze (e.g., "/docs/security")
• `RECURSIVE` - (Optional) Boolean, whether to include subdirectories (default: true)
• `OUTPUT_FORMAT` - (Optional) Format of the output: "markdown", "yaml", "json", "csv" (default: "markdown")

Workflow

Step 1: Content Analysis

Analyze the content at `PATH` to identify frequently used terms, concepts, and entities. This involves scanning documentation files (Markdown, Text, etc.) to extract potential vocabulary candidates.

Step 2: Term Extraction & Relationship Mapping

Identify relationships between terms based on context and standard taxonomies:

• **Preferred Terms**: The standard term to be used (e.g., "Multi-Factor Authentication" instead of "MFA").
• **Broader Terms**: More general concepts (e.g., "Access Control" is broader than "Authentication").
• **Narrower Terms**: More specific sub-concepts (e.g., "Biometrics" is narrower than "Authentication").
• **Related Terms**: Associative relationships (e.g., "Identity Management" is related to "Authentication").

Step 3: Thesaurus Generation

Format the collected terms and relationships into the requested `OUTPUT_FORMAT`.

**Example Output (Markdown):**

# Security Thesaurus

## Authentication
*   **Scope Note**: verification of the identity of a user, process, or device
*   **Broader Term**: Access Control
*   **Narrower Terms**: Multi-Factor Authentication, Single Sign-On
*   **Related Terms**: Authorization, Identity Management

Required Outputs

A `THESAURUS_DOCUMENT` in the specified `OUTPUT_FORMAT` containing:

• List of terms
• Relationships (BT, NT, RT)
• Scope notes (definitions)
• Synonyms or "Use For" entries

Quick Reference

• **Purpose**: Ensure consistent terminology and improve content findability.
• **Best Practice**: Include scope notes for ambiguous terms.
• **Standards**: Follows ISO 25964 standards for thesaurus construction where applicable.