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

0•

Content Management

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

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

01Automated manifest scanning for field names, types, and values

02Documentation analysis to identify undocumented capitalized phrases

030 GitHub stars

04Predefined definitions for standard technical statuses and runtimes

05Alphabetical glossary organization and smart update management

06Dry-run mode for auditing changes before modifying files

Use Cases

01Maintaining consistency in technical terminology across large documentation sets

02Synchronizing glossary definitions with new skill or agent manifest fields

03Automating the creation of a centralized project dictionary for onboarding developers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add epieczko/betty docs.expand.glossary

For use in Claude.ai and ChatGPT

Download Skill