Does it overwrite existing manual definitions?

No, the skill is designed to skip terms that already exist in the glossary, ensuring your custom manual definitions remain intact.

Which file formats does the skill scan?

It primarily scans YAML manifest files like skill.yaml and agent.yaml, as well as Markdown files (.md) within your documentation directory.

Can I preview changes before updating the glossary file?

Yes, you can use the dry_run parameter to generate a summary and JSON output of all proposed changes without writing to the glossary.md file.

How are definitions generated for unknown terms?

The skill uses a library of predefined definitions for common technical terms and can generate contextual definitions based on usage patterns found in the manifest metadata.

Glossary Expansion & Documentation

Name: Glossary Expansion & Documentation
Author: epieczko

byepieczko

Content Management

Automatically maintains and enriches project glossaries by extracting technical terms from manifests and markdown documentation.

About

The docs.expand.glossary skill streamlines documentation workflows by scanning project manifests and markdown files to identify undefined technical terms. It automatically generates concise definitions for common technical attributes and organizes them alphabetically within your glossary file, ensuring consistent terminology across the Betty ecosystem. This tool is essential for maintaining comprehensive, up-to-date documentation without the manual overhead of tracking every new field, runtime, or configuration option added during the development process.

Key Features

Automated manifest scanning for field names, types, and values
Documentation analysis to identify undocumented capitalized phrases
0 GitHub stars
Predefined definitions for standard technical statuses and runtimes
Alphabetical glossary organization and smart update management
Dry-run mode for auditing changes before modifying files

Use Cases

Maintaining consistency in technical terminology across large documentation sets
Synchronizing glossary definitions with new skill or agent manifest fields
Automating the creation of a centralized project dictionary for onboarding developers

About

Key Features

Automated manifest scanning for field names, types, and values
Documentation analysis to identify undocumented capitalized phrases
0 GitHub stars
Predefined definitions for standard technical statuses and runtimes
Alphabetical glossary organization and smart update management
Dry-run mode for auditing changes before modifying files

Use Cases

Maintaining consistency in technical terminology across large documentation sets
Synchronizing glossary definitions with new skill or agent manifest fields
Automating the creation of a centralized project dictionary for onboarding developers