К основному содержанию
скилл CX Codex

glossary-management — скилл для Claude Code: термины и установка

Скилл glossary-management для Claude Code ведёт глоссарий терминов и связывает его с Vale. Запускается при добавлении терминов, проверке формата или синхронизации словаря.

MIT 138 установок ★ 3 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add terrylica/cc-skills --skill glossary-management -a claude-code
Открыть на GitHub

Что делает glossary-management

Скилл помогает вести общий глоссарий в ~/.claude/docs/GLOSSARY.md, проверять его таблицу и синхронизировать термины с Vale. В таблице для каждого термина нужны название, аббревиатура, определение, единица измерения или диапазон и список проектов.

Хук после редактирования глоссария синхронизирует его с файлами словаря Vale. Другой хук реагирует на правки проектных CLAUDE.md: добавляет термины в общий файл и проверяет конфликты определений и аббревиатур. Для ручной синхронизации используется команда bun ~/.claude/tools/bin/glossary-sync.ts; для неё нужен Bun. Пути проектов задаются в комментарии SCAN_PATHS внутри глоссария.

Какие задачи решает

  • синхронизировать термины глоссария с Vale
  • проверить таблицу глоссария на соответствие формату
  • найти конфликты определений и аббревиатур между проектами
  • добавить термин в общий файл глоссария

Примеры запросов агенту

  • Синхронизируй глоссарий с Vale.
  • Проверь глоссарий на дубли и конфликты терминов.
  • Добавь новый термин в общий глоссарий.

Как установить glossary-management

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill glossary-management -a claude-code

2Вручную: положить файлы

~/.claude/skills/glossary-management/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/glossary-management/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о glossary-management

Как установить glossary-management в Claude Code?

Выполни npx skills add terrylica/cc-skills --skill glossary-management -a claude-code. Файл скилла находится по пути ~/.claude/skills/glossary-management/SKILL.md.

Что делает glossary-management?

Скилл управляет общим глоссарием в ~/.claude/docs/GLOSSARY.md, синхронизирует его с Vale и проверяет терминологические конфликты в проектных CLAUDE.md.

Как glossary-management синхронизирует термины с Vale?

После правки общего глоссария хук обновляет словарь Vale. Для ручного запуска синхронизации используется bun ~/.claude/tools/bin/glossary-sync.ts.

Исходный текст

SKILL.md · MIT
---
name: glossary-management
description: Manage terminology glossary with Vale. TRIGGERS - sync terms, glossary validation, add terms, Vale vocabulary.
allowed-tools: Bash, Read, Edit, Grep
---

# Glossary Management

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## Overview

Manage the global terminology glossary (`~/.claude/docs/GLOSSARY.md`) and its Vale integration. The glossary is the Single Source of Truth (SSoT) for terminology across all projects.

## When to Use This Skill

Use when:

- Manually syncing glossary to Vale vocabulary files
- Validating glossary format and structure
- Checking for duplicate or conflicting terms across projects
- Adding new terms programmatically
- Troubleshooting Vale terminology warnings

## Quick Commands

```bash
# Manual sync to Vale
bun ~/.claude/tools/bin/glossary-sync.ts

# Check for duplicates/conflicts across projects (invokes terminology-sync hook)
bun ~/eon/cc-skills/plugins/itp-hooks/hooks/posttooluse-terminology-sync.ts <<< '{"tool_name":"Edit","tool_input":{"file_path":"/tmp/test-CLAUDE.md"}}'
```

## Architecture

```
┌─────────────────────────────────────────────────────────────────┐
│                    GLOSSARY.md (SSoT)                           │
│                ~/.claude/docs/GLOSSARY.md                       │
└─────────────────────────┬───────────────────────────────────────┘
                          │
          ┌───────────────┼───────────────┐
          │               │               │
          ▼               ▼               ▼
┌─────────────────┐ ┌───────────┐ ┌────────────────────┐
│ accept.txt      │ │ Term.yml  │ │ Project CLAUDE.md  │
│ (Vale vocab)    │ │ (subs)    │ │ (bidirectional)    │
└─────────────────┘ └───────────┘ └────────────────────┘
```

## SCAN_PATHS Configuration

The terminology sync hook uses `SCAN_PATHS` to discover project CLAUDE.md files. This is configured via an HTML comment in GLOSSARY.md:

```markdown
<!-- SCAN_PATHS:
- ~/eon/*/CLAUDE.md
- ~/eon/*/*/CLAUDE.md
- ~/.claude/docs/GLOSSARY.md
-->
```

**Format rules**:

- Must be an HTML comment starting with `<!-- SCAN_PATHS:`
- Each path on its own line with `-` prefix
- Supports glob patterns (`*`, `**`)
- Paths are relative to home directory (`~`)

**Default paths** (if not specified):

- `~/eon/*/CLAUDE.md` - Top-level project CLAUDE.md files
- `~/eon/*/*/CLAUDE.md` - Package-level CLAUDE.md files

## Table Schema (5 Columns)

Every term in GLOSSARY.md follows this 5-column format:

| Column         | Required | Description                     | Example                          |
| -------------- | -------- | ------------------------------- | -------------------------------- |
| **Term**       | Yes      | Bold term name (`**Term**`)     | `**Time-Weighted Sharpe**`       |
| **Acronym**    | Yes      | Abbreviation (or `-` if none)   | `TWSR`                           |
| **Definition** | Yes      | Clear, concise definition       | `Sharpe ratio for range bars`    |
| **Unit/Range** | Yes      | Measurement unit or valid range | `ratio`, `[0, 1]`, `-`           |
| **Projects**   | Yes      | Comma-separated project names   | `research-repo, trading-fitness` |

**Example row**:

```markdown
| **Time-Weighted Sharpe** | TWSR | Sharpe ratio for variable-duration bars using time weights | annualized ratio | research-repo |
```

## Automatic Sync (Hooks)

Two PostToolUse hooks handle automatic sync:

| Hook                           | Trigger                           | Action                                      |
| ------------------------------ | --------------------------------- | ------------------------------------------- |
| `posttooluse-glossary-sync`    | Edit `~/.claude/docs/GLOSSARY.md` | Sync to Vale vocabulary                     |
| `posttooluse-terminology-sync` | Edit project `CLAUDE.md`          | Merge terms → GLOSSARY.md, detect conflicts |

## Manual Operations

### Sync Glossary to Vale

When automatic sync fails or you need to force a refresh:

```bash
bun ~/.claude/tools/bin/glossary-sync.ts
```

**Output**:

```
=== Glossary Bidirectional Sync ===
  Source: /Users/you/.claude/docs/GLOSSARY.md
  Found 25 acronyms, 24 substitutions
  Updated: .vale/styles/config/vocabularies/TradingFitness/accept.txt
  Total terms: 27
  Updated: .vale/styles/TradingFitness/Terminology.yml
  Substitution rules: 24
  Updated timestamp: 2026-01-22T00:00:00Z
=== Sync Complete ===
```

### Validate Glossary Format

Check that GLOSSARY.md follows the correct table format:

```bash
# Check required columns
grep -E '^\| \*\*[^|]+\*\* \|' ~/.claude/docs/GLOSSARY.md | head -5

# Verify table structure (should have | Term | Acronym | Definition | Unit/Range | Projects |)
head -25 ~/.claude/docs/GLOSSARY.md
```

**Expected format**:

```markdown
| Term                     | Acronym | Definition                  | Unit/Range | Projects      |
| ------------------------ | ------- | --------------------------- | ---------- | ------------- |
| **Time-Weighted Sharpe** | TWSR    | Sharpe ratio for range bars | ratio      | research-repo |
```

### Check for Duplicates

Scan all project CLAUDE.md files for terminology conflicts:

```bash
# Full duplicate check (scans ~/eon/*/CLAUDE.md)
bun ~/eon/cc-skills/plugins/itp-hooks/hooks/posttooluse-terminology-sync.ts <<< '{"tool_name":"Edit","tool_input":{"file_path":"/tmp/test-CLAUDE.md"}}'
```

**Conflict types detected**:

- **Definition conflict**: Same term, different definitions
- **Acronym conflict**: Same term, different acronyms
- **Acronym collision**: Same acronym used for different terms

### Add New Term

To add a new term to the glossary:

1. **Edit GLOSSARY.md directly**:

   ```markdown
   | **New Term** | NT | Definition of the new term | - | project-name |
   ```

2. **Sync will auto-trigger** via `posttooluse-glossary-sync` hook

3. **Verify Vale recognizes it**:

   ```bash
   echo "The NT is important" | vale --config=~/.claude/.vale.ini
   ```

## Vale Integration

### Files Generated

| File                                                                   | Purpose                                      |
| ---------------------------------------------------------------------- | -------------------------------------------- |
| `~/.claude/.vale/styles/config/vocabularies/TradingFitness/accept.txt` | Accepted terms (won't be flagged)            |
| `~/.claude/.vale/styles/TradingFitness/Terminology.yml`                | Substitution rules (suggests canonical form) |

### Running Vale

```bash
# Check a single file (run from file's directory for glob patterns to match)
cd ~/eon/trading-fitness && vale --config=~/.claude/.vale.ini CLAUDE.md

# Check all CLAUDE.md files
find ~/eon -name "CLAUDE.md" -exec sh -c 'cd "$(dirname "$1")" && vale --config=~/.claude/.vale.ini "$(basename "$1")"' _ {} \;
```

**Important**: Vale glob patterns in `.vale.ini` (like `[CLAUDE.md]`) are relative to cwd. Always run Vale from the file's directory or use absolute paths with matching glob patterns.

## Troubleshooting

### Terms Not Being Recognized

1. **Check sync timestamp**:

   ```bash
   grep "Last Sync" ~/.claude/docs/GLOSSARY.md
   ```

2. **Force manual sync**:

   ```bash
   bun ~/.claude/tools/bin/glossary-sync.ts
   ```

3. **Verify Vale config path**:

   ```bash
   cat ~/.claude/.vale.ini | grep StylesPath
   ```

### Hook Not Triggering

1. **Check hook is registered**:

   ```bash
   grep "glossary-sync" ~/.claude/settings.json
   ```

2. **Verify hook file exists**:

   ```bash
   ls -la ~/.claude/plugins/marketplaces/cc-skills/plugins/itp-hooks/hooks/posttooluse-glossary-sync.ts
   ```

### Vale Output Shows "0 files" But File Exists

This happens when Vale's glob patterns don't match the file path. The `posttooluse-vale-claude-md.ts` hook handles this by:

1. Walking up from the file's directory to find `.vale.ini`
2. Changing to the file's directory before running Vale
3. Stripping ANSI escape codes for reliable output parsing

If running Vale manually, ensure you're in the file's directory:

```bash
# Wrong - may show "0 files"
vale --config=/path/to/.vale.ini /absolute/path/to/CLAUDE.md

# Correct - cd first
cd /absolute/path/to && vale --config=/path/to/.vale.ini CLAUDE.md
```

### Duplicate Vocabulary Directories

If you see Vale inconsistencies:

```bash
# Check for duplicate vocab dirs (should only have config/vocabularies/)
ls -la ~/.claude/.vale/styles/

# Remove any stale Vocab/ directory
rm -rf ~/.claude/.vale/styles/Vocab/
```

## References

- [Vale Documentation](https://vale.sh/docs/)
- GLOSSARY.md: `~/.claude/docs/GLOSSARY.md` (local file)
- [itp-hooks CLAUDE.md](/plugins/itp-hooks/CLAUDE.md)

## Post-Execution Reflection

After this skill completes, check before closing:

1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

© terrylica · MIT · terrylica/cc-skills

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
paper-glossary 917Dhj Скилл paper-glossary собирает глоссарий Obsidian из манифеста статьи, но сначала показывает список терминов и ждёт вашего выбора. CX Codex +1 538установок glossary aspi6246 Держит словарь терминов проекта в GLOSSARY.md: определения, сокращения и командные фразы, которые агент выполняет по одному слову. CX Codex +1 ★ 165звёзд репо glossary-page-generator kostja94 Скилл glossary-page-generator для сборки страницы глоссария. Помечен как deprecated: правила переехали в другой пакет, а здесь осталась только заглушка. CX Codex +1 1 100установок layers-domain jamiemill Скилл layers-domain помогает зафиксировать терминологию, разногласия и границы контекстов предметной области до проектирования интерфейса. CX Codex +1 2 000установок shared-dao haowjy Скилл shared-dao для Claude Code устраняет путаницу в терминах проекта и сводит синонимы к единому словарю. Агент подключает правила при появлении двойных названий или перед вводом нового понятия. CX Codex +1 581установок Technical Documentation taste f Промпт Technical Documentation taste для ChatGPT, Claude.ai и Claude Code задаёт стандарты технической документации. Помогает структурировать руководства и описание API по модели Diataxis для их актуальности и доступности. GP ChatGPT ★ 178 201звёзд репо

Из того же набора79

Весь набор →
adr-code-traceability Скилл adr-code-traceability для Claude Code добавляет ссылки на Architecture Decision Records в заголовки новых файлов и комментарии к нетривиальным решениям. Связывает код с архитектурным решением. CX Codex +1 144установок mlflow-python Скилл mlflow-python для Claude Code записывает параметры и метрики бэктестов в MLflow. Ищет эксперименты и получает историю метрик через Python API. CX Codex +1 139установок code-clone-assistant Скилл code-clone-assistant находит повторяющийся код через PMD CPD и Semgrep, помогает рефакторить нарушения DRY. Работает с точными дубликатами и похожими паттернами. CX Codex +1 139установок article-extractor Скилл article-extractor выгружает статьи и документацию с mql5.com для датасетов или справочников. Помогает собирать примеры кода MQL5 по ссылкам и авторам. CX Codex +1 138установок gmail-access Скилл gmail-access для Claude Code подключает Gmail через CLI: читает и ищет письма, выгружает результаты и создаёт черновики. Даёт доступ к переписке в ходе работы над проектом. CX Codex +1 137установок skill-architecture Скилл skill-architecture помогает создавать и менять скиллы, разбираться в YAML и проверять структуру файлов. Внутри — шаблоны задач и рекомендации по устройству скиллов. CX Codex +1 137установок slash-command-factory Скилл slash-command-factory задаёт 5–7 вопросов и создаёт файлы слэш-команд для Claude Code с проверенным синтаксисом YAML и правами на подкоманды. CX Codex +1 136установок backtesting-py-oracle Скилл backtesting-py-oracle настраивает backtesting.py для сверки торговых сигналов с расчётами в ClickHouse SQL. Помогает устранить расхождения в сделках при тестировании паттернов на рендж-барах. CX Codex +1 135установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой