spk-doctrine-glossary

Curate canonical glossary terms, aliases, and terminology drift checks for Spec Kitty projects.

1.6k|156|Updated Oct 9, 2025
One-click install
npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-doctrine-glossary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spk-doctrine-glossary
Source: https://github.com/Priivacy-ai/spec-kitty/tree/main/src/charter/offering/skills/spk-doctrine-glossary
Command: npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-doctrine-glossary

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams working on spec-driven development often lose control of domain language: the same concept gets multiple names, aliases drift apart, and specs, plans, and docs become inconsistent. This Skill keeps glossary terminology canonical and consistent across the repository.

Core Features & Use Cases

  • Term Classification: Classify each glossary change as a new term, alias, conflict, drift, or usage correction before applying it.
  • Targeted Updates: Update or apply terminology without rewriting unrelated documentation.
  • Cross-Artifact Consistency: Feed canonical domain language back into spec, plan, and documentation workflows.
  • Use Case: A reviewer notices "work package" and "task bundle" used interchangeably across specs. Use this Skill to classify the conflict, pick the canonical term, and propagate the correction.

Quick Start

Ask the assistant to review the project glossary for terminology drift and propose canonical terms for any conflicting aliases.

Frequently Asked Questions about spk-doctrine-glossary

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

FAQPage Schema
How do I manage glossary terminology in a spec-driven development workflow?

Locate the active glossary context, classify each change as a new term, alias, conflict, drift, or usage correction, then apply the update. Canonical terms are fed back into spec, plan, and documentation artifacts to keep language consistent.

How to detect terminology drift across specs and documentation?

Terminology drift is detected by comparing current usage against the canonical glossary and classifying deviations as drift or conflicts. The Skill then applies corrections to the affected terms without rewriting unrelated documents.

What is the difference between an alias and a terminology conflict?

An alias is an accepted alternative name mapped to a canonical term, while a conflict occurs when two terms compete for the same concept without resolution. The Skill classifies each case so aliases are recorded and conflicts are resolved to a single canonical term.

Can I use this glossary workflow with the legacy spec-kitty-glossary-context skill?

Yes, the Skill defines spec-kitty-glossary-context as a legacy alias for detailed glossary workflows and field guides. When that skill is available, it can be used for more in-depth glossary operations.

When should I not use a glossary curation skill?

Avoid it for one-off documents or projects without shared domain language, where maintaining a canonical glossary adds overhead without benefit. It is designed for repositories where specs, plans, and docs must stay terminologically consistent.