Skill Trigger Review Checklist

Skill Trigger Review Checklist

Чеклист для проверки и улучшения триггеров в Claude Code skills.

📋 Quick Assessment

Используйте этот быстрый чеклист для каждого skill:

Skill: _______________
Date: _______________
Reviewer: _______________

[ ] 1. Универсальный триггер определен
[ ] 2. Покрывает ВСЮ функциональность tool/скрипта
[ ] 3. Естественные формулировки включены
[ ] 4. Мультиязычность (если нужна)
[ ] 5. Вариации глаголов (get/show/list/fetch...)
[ ] 6. Контекстные запросы ("что в...", "check...")
[ ] 7. Категоризация по типам данных
[ ] 8. Негативные примеры (что НЕ активирует)
[ ] 9. Тестовые примеры документированы
[ ] 10. Нет дублирования с другими skills

Score: ___/10
Status: [ ] PASS [ ] NEEDS IMPROVEMENT [ ] FAIL

---

🔍 Detailed Review Process

Phase 1: Coverage Analysis

**Цель**: Убедиться, что триггеры покрывают ВСЮ функциональность skill.

1.1 Инвентаризация функций

# Для Ruby скриптов
grep -E "when |def " skill_script.rb | grep -v private

# Для Bash скриптов
grep -E "^[a-z_]+\(\)|case.*in" skill_script.sh

# Для Python скриптов
grep -E "^def |^class " skill_script.py

**Чеклист**:

• Составлен список ВСЕХ доступных команд/функций
• Каждая функция имеет триггер в description
• Триггеры включают синонимы для каждой функции

**Пример плохого покрытия**:

# ❌ Skill имеет 10 команд, description упоминает только 3
description: "Use when user wants to list errors or show details"
# Функции: list, details, resolve, comment, analyze, orgs, projects...

**Пример хорошего покрытия**:

# ✅ Все 10 команд представлены в description
description: |
  UNIVERSAL TRIGGER: Any operation with [tool_name]

  Supported operations:
  - List/show data (errors, projects, orgs)
  - Details/analysis (error details, patterns)
  - Management (resolve, comment)

---

Phase 2: Pattern Analysis

**Цель**: Проверить естественность формулировок триггеров.

2.1 Универсальный паттерн

**Формула**:

[ACTION_VERB] + [DATA_TYPE] + [CONTEXT]

Examples:
- get [projects] from [bugsnag]
- show [error details] in [bugsnag]
- list [organizations] for [bugsnag]

**Чеклист**:

• Определен универсальный паттерн для skill
• Паттерн документирован в начале description
• Паттерн покрывает 80%+ реальных запросов

2.2 Глаголы действий

**Обязательные категории**:

Категория	Примеры EN	Примеры RU
Viewing	get, show, list, display, view	показать, вывести, список, посмотреть
Retrieving	fetch, retrieve, pull, extract	получить, извлечь, достать
Checking	check, verify, validate	проверить, проверка
Analyzing	analyze, examine, inspect	анализ, проанализировать, изучить
Managing	create, update, delete, modify	создать, обновить, удалить, изменить

**Чеклист**:

• Минимум 3 глагола для каждой основной функции
• Включены синонимы (show/display, list/enumerate)
• Естественные формулировки ("