doc-validate
**UNIVERSAL TRIGGER**: Validate/check/lint documentation quality. **Formatting**: "validate docs", "doc lint", "проверь документацию" **Links**: "broken links", "orphan docs", "битые ссылки" **Terms**: "check glossary", "терминология", "synonyms" **Viewpoints**: "check artifacts", "state diagrams", "threat model" ⚡ **Contradictions**: "find conflicts", "противоречия" ️ **Gaps**: "missing coverage", "пробелы", "completeness" **Review**: "full audit", "полный аудит", "/doc:review" TRIGGERS: doc lint, validate docs, проверь документацию, broken links, orphan, glossary, viewpoints, contradictions, gaps, coverage, /doc:lint, /doc:links, /doc:terms, /doc:viewpoints, /doc:contradictions, /doc:gaps, /doc:review
Best use case
doc-validate is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
**UNIVERSAL TRIGGER**: Validate/check/lint documentation quality. **Formatting**: "validate docs", "doc lint", "проверь документацию" **Links**: "broken links", "orphan docs", "битые ссылки" **Terms**: "check glossary", "терминология", "synonyms" **Viewpoints**: "check artifacts", "state diagrams", "threat model" ⚡ **Contradictions**: "find conflicts", "противоречия" ️ **Gaps**: "missing coverage", "пробелы", "completeness" **Review**: "full audit", "полный аудит", "/doc:review" TRIGGERS: doc lint, validate docs, проверь документацию, broken links, orphan, glossary, viewpoints, contradictions, gaps, coverage, /doc:lint, /doc:links, /doc:terms, /doc:viewpoints, /doc:contradictions, /doc:gaps, /doc:review
Teams using doc-validate should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/doc-validate/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How doc-validate Compares
| Feature / Agent | doc-validate | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
**UNIVERSAL TRIGGER**: Validate/check/lint documentation quality. **Formatting**: "validate docs", "doc lint", "проверь документацию" **Links**: "broken links", "orphan docs", "битые ссылки" **Terms**: "check glossary", "терминология", "synonyms" **Viewpoints**: "check artifacts", "state diagrams", "threat model" ⚡ **Contradictions**: "find conflicts", "противоречия" ️ **Gaps**: "missing coverage", "пробелы", "completeness" **Review**: "full audit", "полный аудит", "/doc:review" TRIGGERS: doc lint, validate docs, проверь документацию, broken links, orphan, glossary, viewpoints, contradictions, gaps, coverage, /doc:lint, /doc:links, /doc:terms, /doc:viewpoints, /doc:contradictions, /doc:gaps, /doc:review
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
SKILL.md Source
# Documentation Validation Skill
Комплекс команд `/doc:*` для автоматической и интерактивной проверки качества проектной документации.
## Быстрый старт
```bash
# Быстрая проверка перед коммитом
/doc:lint
# Проверка графа связей
/doc:links
# Полный аудит (все проверки)
/doc:review
```
## Команды
### `/doc:lint` — Проверка форматирования
**Модель**: haiku (быстро, дёшево)
**Время**: < 30 сек для 100 файлов
**Проверки**:
- Битые внутренние ссылки `[text](file.md)`
- Несуществующие файлы в навигации
- Нарушения naming conventions (`NN_TITLE.md` для корневых)
- Пустые секции (## без контента)
- TODO/FIXME без ссылки на issue
- Отсутствие обязательных секций
**Пример вывода**:
```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[LINT-001] Битая ссылка
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
03_REQUIREMENTS.md:45
> [см. архитектуру](architecture/MISSING.md)
❌ Файл не существует: architecture/MISSING.md
[f]ix [s]kip [i]gnore [e]dit [g]ithub issue [x]plain
> _
```
### `/doc:links` — Граф связей
**Модель**: haiku
**Время**: < 30 сек для 100 файлов
**Проверки**:
- Orphan-документы (без входящих ссылок)
- Dead-ends (без исходящих ссылок)
- Циклические зависимости
- Полнота навигации в README
**Исключения** (не считаются orphans/dead-ends):
- README.md, CHANGELOG.md
- **/GLOSSARY.md, **/INDEX.md
- Конфигурируется в `.docvalidate.yml`
**Пример вывода**:
```
Граф документации
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Всего документов: 35
Связей: 128
⚠️ Orphans (нет входящих ссылок):
- research/old_analysis.md
- data/transaction-analysis.md
⚠️ Dead-ends (нет исходящих ссылок):
- architecture/wallet/COMPONENTS.md
✅ README навигация: 28/35 документов (80%)
```
### `/doc:terms` — Терминология ✅
**Модель**: sonnet (или haiku для базовых проверок)
**Требует**: глоссарий в `02_GLOSSARY.md`
**Проверки**:
- Термины из глоссария используются единообразно
- Обнаружение запрещённых синонимов (кошелёк/wallet/бумажник)
- Новые термины не в глоссарии (выделенные **bold**)
- Покрытие глоссария (% используемых терминов)
**Пример вывода**:
```
Загружен глоссарий: 16 терминов
Запрещённых синонимов: 5 групп
Сканирование 24 файлов...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[TERM-001] Запрещённый синоним
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
08_KEY_SECURITY.md:82
Запрещённый синоним: "wallet" → используйте "кошелёк"
Покрытие глоссария
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Используется: 14/16 терминов (87%)
```
### `/doc:viewpoints` — Артефакты ✅
**Модель**: sonnet
**Проверки по viewpoints**:
| Viewpoint | Артефакт | Приоритет |
|-----------|----------|-----------|
| Data | STATE_MACHINES.md | must |
| Data | DATA_FLOWS.md | should |
| Business Rules | BUSINESS_RULES.md | must |
| Security | THREAT_MODEL.md | must (критично для крипто) |
| Integration | EVENT_CATALOG.md | should |
| Traceability | RTM.md | should |
**Пример вывода**:
```
## Покрытие Viewpoints
| Viewpoint | Артефакт | Статус | Файл |
|-----------|----------|--------|------|
| Data | STATE_MACHINES | ✅ | architecture/STATE_MACHINES.md |
| Data | DATA_FLOWS | ❌ | architecture/DATA_FLOWS.md |
| Security | THREAT_MODEL | ✅ | architecture/THREAT_MODEL.md |
Общее покрытие viewpoints: 3/6 (50%)
Security viewpoint не полностью покрыт — критично для крипто-системы!
```
### `/doc:contradictions` — Противоречия ✅
**Модель**: sonnet (локальный анализ)
**Время**: < 60 сек для 100 файлов
**Проверки**:
- Конфликтующие значения (разные числа для одного параметра)
- Взаимоисключающие требования
- Решения противоречащие ограничениям
- Числовые параметры с разными значениями в разных документах
**Пример вывода**:
```
⚡ /doc:contradictions — Поиск противоречий
Извлечение параметров из документации...
Найдено 194 параметров в 25 файлах
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
КРИТИЧНЫЕ ПРОТИВОРЕЧИЯ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[CONTRADICTION-001] Параметр "confirmations" имеет разные значения
03_REQUIREMENTS.md:45 → 3
architecture/FLOWS.md:128 → 6
⚠️ Разница: 100%
[CONTRADICTION-002] Параметр "hot_wallet_limit" имеет разные значения
03_REQUIREMENTS.md:52 → 10%
08_KEY_SECURITY.md:23 → 5%
⚠️ Разница: 100%
Итого: 8 критичных, 10 предупреждений
```
### `/doc:gaps` — Полнота ✅
**Модель**: sonnet (локальный анализ)
**Время**: < 60 сек для 100 файлов
**Проверки**:
- Упомянутые но не раскрытые темы
- Требования без acceptance criteria
- Сущности без полного описания артефактов
- Интеграции без Event Catalog
**Пример вывода**:
```
️ /doc:gaps — Анализ полноты покрытия
Сканирование документации на гапы...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ПРЕДУПРЕЖДЕНИЯ (требуют внимания)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[GAP-001] Найдены интеграции (69), но нет Event Catalog
architecture/EVENT_CATALOG.md — отсутствует
Рекомендация: создайте EVENT_CATALOG.md для документирования событий
Итого: 0 критичных, 1 предупреждение
```
### `/doc:review` — Полный аудит ✅
**Модель**: все (каскад)
**Время**: < 5 мин для 100 файлов
Запускает все проверки в оптимальном порядке:
1. lint + links (Phase 1: базовые)
2. terms + viewpoints (Phase 2: семантические)
3. contradictions + gaps (Phase 3: глубокий анализ)
**Функции**:
- Агрегация результатов всех команд
- Сводная таблица по категориям
- Сравнение с предыдущим запуском
- Рекомендации по приоритетам
- Общая оценка качества (0-100)
**Пример вывода**:
```
╔══════════════════════════════════════════════════════════════╗
║ ИТОГОВЫЙ ОТЧЁТ DOC:REVIEW ║
╚══════════════════════════════════════════════════════════════╝
┌────────────────┬──────────┬──────────┬──────────┐
│ Команда │ Крит. │ Важн. │ Инфо │
├────────────────┼──────────┼──────────┼──────────┤
│ lint │ 0 │ 6 │ 92 │
│ links │ 0 │ 0 │ 0 │
│ terms │ 0 │ 194 │ 10 │
│ viewpoints │ 0 │ 3 │ 0 │
│ contradictions │ 8 │ 10 │ 0 │
│ gaps │ 0 │ 1 │ 0 │
├────────────────┼──────────┼──────────┼──────────┤
│ ИТОГО │ 8 │ 214 │ 102 │
└────────────────┴──────────┴──────────┴──────────┘
Покрытие viewpoints: 3/6 (50%)
Покрытие глоссария: 94%
⏱️ Время выполнения: 0.4 сек
Рекомендации:
• Исправьте 8 критических проблем в первую очередь
• ⚡ Разрешите противоречия в числовых параметрах
• Увеличьте покрытие viewpoints (сейчас 50%)
╔══════════════════════════════════════╗
║ ОБЩАЯ ОЦЕНКА: 85/100 (B) ║
╚══════════════════════════════════════╝
```
## CLI режимы
```bash
# Стандартный режим (вывод без интерактива)
./doc_validate.rb lint
# Интерактивный режим (промпт для каждой проблемы)
./doc_validate.rb lint --interactive
# Batch режим для CI/CD (без вывода, с exit codes)
./doc_validate.rb lint --batch
# Exit codes: 0=ok, 1=warnings, 2=critical
```
## Интерактивный режим
Активация: `--interactive` или `-i`
При обнаружении проблемы:
| Клавиша | Действие | Описание |
|---------|----------|----------|
| `f` | fix | Применить автоисправление (если доступно) |
| `s` | skip | Пропустить, не исправлять сейчас |
| `i` | ignore | Добавить в `.docignore` |
| `e` | edit | Открыть файл в $EDITOR |
| `x` | explain | Подробнее объяснить проблему |
### Доступные автоисправления
| Тип проблемы | Действие fix |
|--------------|--------------|
| broken_link | Fuzzy search похожих файлов или удаление ссылки |
| synonym | Замена на canonical термин |
| empty_section | Удаление пустой секции (с подтверждением) |
### Edge Cases
| Ситуация | Поведение |
|----------|-----------|
| fix недоступен | Показать "(fix unavailable)" |
| Ctrl+C | Сохранить прогресс в session.json |
## Конфигурация
Файл `.docvalidate.yml` в корне проекта:
```yaml
version: 1
# Глоссарий
glossary:
file: "02_GLOSSARY.md"
forbidden_synonyms:
- ["кошелёк", "wallet", "бумажник"]
- ["транзакция", "tx", "перевод"]
# Scope проверки
scope:
strict:
- "*.md"
- "architecture/**/*.md"
relaxed:
- "research/**/*.md"
trigger: on_change
ignore:
- "claudedocs/**"
# Исключения для orphan/dead-end
link_exceptions:
not_orphans:
- "README.md"
- "CHANGELOG.md"
- "**/GLOSSARY.md"
# Naming conventions
formatting:
root_naming: "^[0-9]{2}_[A-Z_]+\\.md$"
```
## Data Model
### `.docvalidate/.docignore` — игнорируемые проблемы
Формат: JSON Lines
```jsonl
{"id": "LINT-001", "file": "research/old.md", "reason": "Архивный", "created": "2025-01-30"}
```
### `.docvalidate/history.json` — история метрик
```json
{
"runs": [{
"timestamp": "2025-01-30T10:30:00Z",
"metrics": {"critical": 2, "warning": 5, "info": 8}
}]
}
```
## Error Handling
### Fallback chain для AI
```
opus (недоступен) → sonnet → haiku → native (без AI)
```
### Offline mode
При `--offline` или отсутствии сети:
- ✅ `/doc:lint` — работает полностью
- ✅ `/doc:links` — работает полностью
- ⚠️ `/doc:terms` — только forbidden_synonyms
- ❌ `/doc:contradictions` — недоступна
- ❌ `/doc:gaps` — недоступна
## Приоритеты проблем
| Приоритет | Категории |
|-----------|-----------|
| Критичные | contradictions, gaps, missing_threat_model |
| Важные | duplicates, terms, missing_state_diagrams |
| Информация | broken_links, formatting, orphans |
## Ограничения текущей версии (v1.1.0)
| Функция | Статус | Примечание |
|---------|--------|------------|
| Интерактивный режим | ✅ | f/s/i/e/x работают |
| Batch mode + exit codes | ✅ | Для CI/CD |
| Автоисправления | ✅ | broken_link, synonym, empty_section |
| Mermaid граф | ❌ Roadmap | Визуализация link graph |
| Session recovery | ❌ Roadmap | Возобновление после Ctrl+C |
| Unit-тесты | ❌ Roadmap | Покрытие 0% |
## Связанная документация
- [Issue #7](https://github.com/BrandyMint/WalletSystem/issues/7) — Основная спецификация
- [Issue #12](https://github.com/BrandyMint/WalletSystem/issues/12) — План доработокRelated Skills
zellij-tab-pane
**UNIVERSAL TRIGGER**: OPEN/CREATE/RUN tab or pane IN zellij. Modes: empty tab/pane, shell command in tab/pane, Claude session in tab/pane, GitHub issue in tab/pane. Examples: "open new tab", "run npm test in pane", "execute plan in tab", "start issue #123 in pane", "открой вкладку", "запусти тесты в панели", "делегируй в вкладку", "стартани issue в панели"
task-routing
**UNIVERSAL TRIGGER**: ROUTE/TAKE/IMPLEMENT any task FROM a URL or issue reference **URLs & References**: - "get task from github.com/.../issues/N", "fetch spec from docs.google.com/..." - "retrieve task from https://..." **Local File Paths**: - "реализуй /path/to/plan.md", "выполни ./docs/plans/fix.md" - "take /home/user/plan.md", "implement /abs/path/to/plan.md" **Action Triggers (EN)**: - "take this task", "implement this spec", "do issue #NNN" - "route task", "route this", "start issue #NNN" - "check this task", "analyze task" **Triggers (RU)**: - "возьми задачу", "сделай задачу", "реализуй по спеке" - "сделай issue #NNN", "возьми issue #NNN" **#NNN**: action-слово + "issue"/"задачу" обязательны. Голый #NNN -- НЕ триггер. **Should NOT activate** (handled by other skills): - "show/read/view issue #N" (github-issues) - "what does issue #N say" (github-issues) - "edit/close/mark done issue" (github-issues) - "review spec", "check spec", "analyze requirements" (spec-review) - bare GitHub issue URL without action verb (github-issues) TRIGGERS: route task, route this, возьми задачу, сделай задачу, take this task, implement this spec, implement this issue, get task from, check this task, analyze task, retrieve spec, fetch task, реализуй по спеке, сделай issue, do issue, start issue, github.com/issues, docs.google.com/document, /docs/plans, ./docs/plans, /tmp/plan, local file, локальный файл
spec-review
**UNIVERSAL TRIGGER**: Ревью спецификаций и ТЗ на гапы, нестыковки и противоречия. Используй когда: - "get/show/list/display spec issues", "retrieve spec analysis" - "check/analyze/fetch spec review", "review spec" - "проверь спецификацию/ТЗ", "ревью спеки", "проанализируй ТЗ" - "найди гапы в требованиях", "найди нестыковки/противоречия" - пользователь дал ссылку на Google Doc, GitHub issue или Docmost-документ со спецификацией - пользователь вставил текст спецификации и просит проверить **Уровни глубины**: - `--quick` / `-q` — только критические блокеры (быстро) - `--standard` / `-s` — критические + высокие (по умолчанию) - `--deep` / `-d` — все проблемы включая средние - `--exhaustive` / `-e` — полный аудит с рекомендациями - `--no-ask` — использовать standard без вопроса (для CI/CD) **Ключевые слова для уровней**: - "быстро проверь", "только блокеры" -> quick - "тщательно", "подробно", "глубоко" -> deep - "полный аудит", "исчерпывающий" -> exhaustive **Google Doc**: - "проверь спеку docs.google.com/document/d/XXX" - "ревью этого ТЗ [ссылка на Google Doc]" **Docmost**: - "проверь спеку https://docs.company.com/p/XXXXXXXX" - "ревью этого ТЗ в Docmost [ссылка]" **GitHub Issue** (ТОЛЬКО с ревью-контекстом!): - "проанализируй issue #123" (ревью-слово: "проанализируй") - "проверь спецификацию github.com/.../issues/456" (ревью-слово: "проверь") - голый "issue #123" без ревью-контекста -- НЕ триггер (github-issues или task-routing) **Текст в сообщении**: - "проверь это ТЗ: [текст спецификации]" - пользователь вставил большой текст и просит ревью **Локальный файл**: - "проверь спеку в docs/spec.md" - "сделай ревью файла requirements.txt" TRIGGERS: спецификация, ТЗ, spec, specification, requirements, проверь спеку, ревью спеки, review spec, analyze spec, найди гапы, найди противоречия, найди нестыковки, docs.google.com/document, github.com/issues, docmost, /p/, техническое задание, требования, acceptance criteria, проанализируй требования, check requirements, --quick, -q, --deep, -d, --exhaustive, -e, --no-ask, быстро проверь, тщательно проанализируй, полный аудит, только блокеры, глубокий анализ, исчерпывающий
pr-review-fix-loop
**UNIVERSAL TRIGGER**: Iterative PR review + autofix loop. Use when user wants to review, check, or fix PR changes automatically. Common patterns: - "review my PR", "check my PR", "review changes" - "fix review comments", "address review findings" - "run review loop", "autofix PR issues" - "проверь мой PR", "ревью PR", "проверь изменения" - "исправь замечания ревью", "пофикси замечания" - "запусти ревью", "автоисправление PR" **PR Review** (iterative review + fix cycle): - "review and fix my PR", "check PR and fix issues" - "iterate on PR review", "review loop" - "проверь и исправь PR", "итеративное ревью" **Code Review Fix** (address existing review comments): - "fix review comments", "address PR feedback" - "fix code review issues", "resolve review findings" - "исправь замечания", "пофикси комментарии ревью" **Codex Review** (standalone Codex CLI review): - "codex review", "run codex on my changes" - "codex ревью", "запусти codex" TRIGGERS: review PR, check PR, fix PR, review changes, review loop, autofix, pr review, code review fix, address review, fix comments, review findings, iterate review, codex review, run codex, проверь PR, ревью PR, исправь замечания, пофикси PR, проверь изменения, запусти ревью, автоисправление, codex ревью, замечания ревью, фикс PR
media-upload
**UNIVERSAL TRIGGER**: Use when user wants to UPLOAD/SAVE/ATTACH/SHARE images or media files to S3. **AUTO-TRIGGER**: Activate AUTOMATICALLY after taking screenshots with Playwright MCP. Common patterns: - "upload/save/attach/share [file] to s3" - "get/fetch public link for [image]" - "show/list/display recent uploads" - "сделай скриншот и сохрани" (screenshot + upload) - "открой сайт и сделай скриншот" (implies upload) **Screenshots** (AUTO-ACTIVATE after Playwright screenshot): - After `browser_take_screenshot` → automatically offer to upload - "upload screenshot", "save screenshot", "attach screenshot" - "загрузи скриншот", "приложи скриншот", "сохрани скриншот" - "сделай скриншот [сайта]" → take screenshot + upload to S3 ️ **Images**: - "upload/save/attach image/picture/photo" - "share png/jpg/gif", "get link for image" **Batch**: - "upload all png from ./folder/" - "загрузи все картинки" **History**: - "show/list recent uploads" - "покажи загрузки" TRIGGERS: upload, save, attach, share, get link, show uploads, list uploads, screenshot, image, picture, photo, png, jpg, gif, webp, svg, pdf, s3, bucket, cdn, minio, public link, скриншот, картинка, загрузи, сохрани, сделай скриншот, take screenshot, browser_take_screenshot, playwright screenshot
long-running-harness
**UNIVERSAL TRIGGER**: Use when user wants to START/CONTINUE/MANAGE a long-running development project across multiple sessions. Common patterns: - "start/init/begin new project [description]" - "continue/resume working on [project]" - "начать/инициализировать проект", "продолжить работу над проектом" - "set up harness for [project]", "create project scaffolding" Session types supported: **Initialize (first run)**: - "init long-running project", "start new multi-session project" - "set up project harness", "create progress tracking" - "initialize [web-app/api/cli] project", "начать долгий проект" **Continue (subsequent sessions)**: - "continue project", "resume work", "продолжить работу" - "pick up where I left off", "what's next", "следующая фича" - "next feature", "continue implementation" **Status & Progress**: - "show project progress", "what features are done" - "project status", "статус проекта", "что сделано" - "remaining features", "what's left to do" **Management**: - "mark feature as done", "update progress" - "add new feature to list", "reprioritize features" Context patterns: - "get/show/list project progress" - "check project status" - "what features in project" - "display remaining features" - "fetch session history" - "retrieve progress log" TRIGGERS: long-running, multi-session, project harness, initialize project, continue project, resume work, progress tracking, feature list, session handoff, incremental development, cross-session, долгий проект, продолжить работу, прогресс проекта, следующая сессия, инициализация проекта, get project status, show features, list remaining, check progress, display status, fetch history, retrieve log, what features done, start harness, begin project, resume session, next feature, pick up work, update progress, mark done, end session Based on Anthropic's research on effective harnesses for long-running agents. Source: https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents
himalaya
**UNIVERSAL TRIGGER**: Use when user wants to READ/SEND email. Common patterns: - "check my email/inbox", "show unread" - "send email to [recipient]" - "проверить почту", "отправить письмо" **Reading**: - "check inbox", "show unread emails", "what's in my mail" - "read email from [sender]", "find emails about [topic]" - "show email folders", "list mail folders" - "проверить входящие", "непрочитанные", "что в почте", "покажи папки" **Sending**: - "send email to [address]", "compose email" - "reply to email", "forward email" - "отправить письмо", "ответить на письмо", "написать письмо" **Accounts**: - "list email accounts", "switch to work email" - "список почтовых аккаунтов", "использовать рабочую почту" ❌ **Should NOT activate**: - "what is SMTP protocol" (general question) - "email regex validation" (programming) - "install himalaya" (setup) TRIGGERS: email, mail, inbox, send, check, read, show, list, get, compose, reply, forward, unread, fetch, view, display, folder, folders, отправить, проверить, прочитать, показать, получить, письмо, почта, папка, папки
worktree-init-script
**UNIVERSAL TRIGGER**: Use when creating git worktrees in projects with init.sh - extends using-git-worktrees to run project-specific initialization script after worktree setup. **Activation**: Automatic when `using-git-worktrees` is invoked and `init.sh` exists in project root. **Setup**: "run init.sh", "initialize worktree", "project setup script" **Create**: "create worktree", "set up workspace", "new worktree" **Check**: "check init.sh", "verify project setup" TRIGGERS: init.sh, worktree init, worktree setup, project setup script, run init, initialize worktree, worktree initialization, create worktree init, setup worktree project, инициализация worktree, запустить init.sh, скрипт инициализации, настройка worktree, создать worktree с init
plan-to-issue
**UNIVERSAL TRIGGER**: SAVE/PUBLISH/EXPORT implementation plan TO GitHub issue for separate session execution. Common patterns: - "save/publish/export plan to issue" - "create issue from plan", "plan to github" - "сохрани план в issue", "создай issue из плана" **Save Plan**: - "save plan to issue", "publish plan to github" - "сохрани план в issue", "экспортируй план" **Create Issue from Plan**: - "create issue from plan", "plan as issue" - "создай issue из плана", "план в задачу" **Execute Later**: - "save for separate session", "execute plan later" - "сохрани для отдельной сессии", "выполнить потом" **Should NOT activate**: - General "create issue" without plan context - Reading existing issues - Working with issue checkboxes TRIGGERS: plan to issue, save plan, export plan, publish plan, plan as issue, issue from plan, plan to github, сохрани план, план в issue, экспорт плана, план в задачу, save for later, execute later, separate session, сохрани для сессии, выполнить потом, план в github
github-issues
**UNIVERSAL TRIGGER**: Use when user mentions GitHub issue URL or asks to read/work with GitHub issues. **Default handler**: Bare GitHub issue URL without action verb -> github-issues (read mode). If user sends just a URL like "https://github.com/org/repo/issues/42" with no action word, this skill handles it. **CRITICAL RULE**: ALWAYS use `gh` CLI for GitHub issues, NEVER use WebFetch! **Reading**: "read issue #N", "show issue", "прочитай задачу" ✅ **Checkboxes**: "mark done", "complete step", "отметь пункт" **Sub-issues**: "create sub-issue", "link as child", "подзадача" **Management**: "edit issue", "close issue", "add label" ️ **Images**: "download images from issue", "скачать картинки" TRIGGERS: github.com/issues, issue #, read issue, show issue, view issue, прочитай issue, покажи issue, задача ✅ checkbox, mark done, complete step, check off, отметь пункт, закрой этап sub-issue, subtask, child issue, parent issue, подзадача, создай подзадачу edit issue, close issue, reopen issue, issue labels, create issue, update task ️ download images, issue attachments, скачать картинки
bugsnag
**UNIVERSAL TRIGGER**: Use when user wants to GET/FETCH/RETRIEVE any data FROM Bugsnag. Common patterns: - "get/show/list/display [something] from bugsnag" - "получить/показать/вывести [что-то] из bugsnag" - "bugsnag [organizations/projects/errors/details/events/comments/stats]" - "what [data] in bugsnag", "check bugsnag [resource]" Specific data types supported: **Organizations & Projects**: - "list bugsnag organizations/orgs", "show organizations" - "list bugsnag projects", "available projects", "проекты bugsnag" **Errors (viewing)**: - "show/list bugsnag errors", "что в bugsnag", "check bugsnag" - "open errors", "error list", "ошибки bugsnag", "открытые ошибки" - "errors with severity error/warning", "filter bugsnag errors" **Error Details**: - "bugsnag details for <id>", "error details", "детали ошибки" - "show stack trace", "error context", "what happened in error" - "events for error", "error timeline", "события ошибки" **Comments**: - "show comments for error", "error comments", "комментарии ошибки" - "bugsnag discussion", "what comments on error" **Analysis**: - "analyze bugsnag errors", "error patterns", "анализ ошибок" - "bugsnag statistics", "error trends", "что происходит в bugsnag" ✅ **Management** (write operations): - "mark as fixed/resolved", "fix error", "resolve error", "close error" - "закрыть ошибку", "отметить как решенную", "исправить ошибку" - "add comment to error", "comment on bugsnag error" - NOTE: Fix/Resolve/Close are synonyms - all mark error as resolved in Bugsnag TRIGGERS: bugsnag, получить из bugsnag, показать bugsnag, список bugsnag, bugsnag data, bugsnag info, check bugsnag, what in bugsnag, bugsnag status, error tracking, error monitoring, production errors, stack trace, bugsnag organizations, bugsnag projects, bugsnag errors, bugsnag details, bugsnag events, bugsnag comments, bugsnag analysis, ошибки в bugsnag, что в bugsnag, проверить bugsnag, данные bugsnag, fix error, resolve error, close error, закрыть ошибку, исправить ошибку, отметить как решенную This skill provides complete Bugsnag API integration for viewing and managing error tracking data via Ruby helper scripts.
rulebook-task-validate
Validate a Rulebook task format and structure against OpenSpec requirements. Use before archiving or to verify task quality.