| name | thesaurus-generate |
| 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"] |
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.
