ubiquitous-language

Extracts domain terminology from conversations into a DDD ubiquitous language glossary file.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/j172/bid --skill ubiquitous-language-j172
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ubiquitous-language
Source: https://github.com/j172/bid/tree/main/agent/skills/ubiquitous-language
Command: npx skills add https://github.com/j172/bid --skill ubiquitous-language-j172

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Conversations about a domain often use inconsistent, ambiguous, or overloaded terminology, causing misalignment between developers and domain experts. This Skill scans the current conversation, detects terminology conflicts, and produces a canonical DDD-style glossary saved as UBIQUITOUS_LANGUAGE.md. ## Core Features & Use Cases - Term Extraction & Canonicalization: Identifies domain-relevant nouns, verbs, and concepts, picks one canonical term per concept, and lists rejected aliases. - Ambiguity Detection: Flags words used for multiple concepts (e.g., "account" meaning both Customer and User) with explicit recommendations. - Structured Glossary Output: Writes grouped term tables, relationship statements, a dev/domain-expert example dialogue, and a flagged-ambiguities section to UBIQUITOUS_LANGUAGE.md. - Use Case: During a DDD modeling session about order fulfillment, invoke the Skill to consolidate all discussed terms into a shared glossary that the whole team can reference. ## Quick Start Ask the assistant to build a ubiquitous language glossary from our conversation and save it to UBIQUITOUS_LANGUAGE.md.

Frequently Asked Questions about ubiquitous-language

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 Skill during or after a domain discussion. It scans the conversation for domain terms, resolves synonyms and ambiguities, and writes a structured glossary with definitions, aliases, and relationships to UBIQUITOUS_LANGUAGE.md.

What is a ubiquitous language in domain-driven design?

A ubiquitous language is a shared, precise vocabulary agreed upon by developers and domain experts in DDD. This Skill formalizes that vocabulary into grouped term tables, relationship statements, and an example dialogue showing correct usage.

How does the glossary handle ambiguous or duplicate terms?

The Skill picks one canonical term per concept and lists rejected alternatives as aliases to avoid. Words used for multiple distinct concepts are called out in a dedicated Flagged Ambiguities section with a clear recommendation.

Can I update the glossary as the conversation continues?

Yes. Re-invoking the Skill reads the existing UBIQUITOUS_LANGUAGE.md, merges new terms, updates evolved definitions, re-flags new ambiguities, and rewrites the example dialogue to incorporate the new vocabulary.

What terms are excluded from the ubiquitous language glossary?

Generic programming concepts like arrays, functions, and endpoints are excluded unless they carry domain-specific meaning. Module and class names are also skipped unless they are meaningful to domain experts.