domain-glossary

Extracts domain terms from conversations and writes a DDD ubiquitous language glossary to DOMAIN_GLOSSARY.md.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/ssttkkl/finance-tracker --skill domain-glossary-ssttkkl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: domain-glossary
Source: https://github.com/ssttkkl/finance-tracker/tree/main/.agents/skills/domain-glossary
Command: npx skills add https://github.com/ssttkkl/finance-tracker --skill domain-glossary-ssttkkl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Conversations about a product or system often use overloaded or inconsistent terms ("account", "user", "customer"), causing misalignment between developers and domain experts. This Skill turns an ongoing conversation into a DDD-style ubiquitous language glossary with canonical terms, tight definitions, and flagged ambiguities. ## Core Features & Use Cases - Term Extraction and Canonicalization: Scans the conversation and attached docs for domain-relevant nouns and verbs, picks one canonical term per concept, and lists aliases to avoid. - Ambiguity Detection: Identifies words used for multiple concepts and synonyms used for the same concept, recording them in a "Flagged ambiguities" section. - Living Glossary File: Writes or updates DOMAIN_GLOSSARY.md with grouped term tables, a Relationships section, and an example dialogue; re-runs merge new terms and mark entries as "(new)" or "(updated)". - Use Case: During a fintech project kickoff, run the skill after a requirements discussion to produce a shared glossary distinguishing Account, Workspace, and Session before writing the domain model. ## Quick Start Ask the assistant to run the domain-glossary skill on the current conversation to generate a DOMAIN_GLOSSARY.md file with canonical terms and definitions.

Frequently Asked Questions about domain-glossary

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a ubiquitous language glossary from a conversation?

Invoke the domain-glossary skill during or after a domain discussion. It scans the conversation for domain-relevant terms, picks canonical names, and writes grouped definition tables to DOMAIN_GLOSSARY.md in the working directory.

What is a DDD ubiquitous language glossary?

It is a shared vocabulary document where each domain concept has one canonical term and a one-sentence definition. It helps developers and domain experts use identical language in code, documentation, and conversation.

Can I re-run the glossary skill as the conversation evolves?

Yes. On re-runs it reads the existing DOMAIN_GLOSSARY.md, merges new terms, updates evolved definitions, and marks entries as "(new)" or "(updated)" while refreshing flagged ambiguities and the example dialogue.

Does the glossary include generic technical terms?

No. The skill ignores generic infrastructure vocabulary like array, function, or endpoint unless the term carries specific domain meaning in the current context. Only domain-relevant nouns, verbs, and concepts are included.

How are ambiguous or overloaded terms handled?

Ambiguous terms are recorded in a "Flagged ambiguities" section with a clear recommendation. The skill picks one canonical word per concept and moves conflicting alternatives into an "aliases to avoid" column.