skill-edit-validation — скилл для Claude Code
Скилл skill-edit-validation проверяет ассерты в тестах после правок файлов навыков и промптов, чтобы уберечь CI от падений из-за устаревших строк.
MIT ★ 539 обновлён 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill skill-edit-validation -a claude-codeЧто делает skill-edit-validation
Скилл запускается после изменения текста в файлах .md внутри каталогов .opencode/skills/, .claude/skills/ или .agents/skills/. Он сопоставляет старые формулировки с новыми и ищет вхождения прежних фраз через rg по тестовым файлам TypeScript в каталогах tests/ и src/.
Найденные совпадения анализируются вместе с контекстом соседних десяти строк. Скилл проверяет валидность подстрок и условий на отсутствие слов (например, когда not.toContain('skip') ломается на фразе «this check is skipped»). Если тест проверяет логику навыка, а не жёсткий контракт, инструкция требует перенести проверку в tests/helpers/skill-content-registry.ts.
Все устаревшие ассерты обновляются сразу в том же наборе изменений, не откладывая починку до прогона в CI.
Какие задачи решает
- найти устаревшие текстовые ассерты после редактирования файлов навыков
- предотвратить падения тестов в CI из-за изменившихся формулировок в промптах
- перенести строковые проверки поведения навыков в семантический реестр тестов
Примеры запросов агенту
- Я обновил формулировки в
.claude/skills/review/SKILL.md. Проверь тесты на сломанные текстовые ассерты - Запусти проверку тестов после редактирования описания навыка в
.agents/skills/ - Найди в
tests/иsrc/проверки, которые завязаны на изменённые строки из markdown-файлов навыков
Как установить skill-edit-validation
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill skill-edit-validation -a claude-code2Вручную: положить файлы
~/.claude/skills/skill-edit-validation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/skill-edit-validation/
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill skill-edit-validation -a codex2Вручную: положить файлы
.agents/skills/skill-edit-validation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill skill-edit-validation -a cursor2Вручную: положить файлы
.cursor/skills/skill-edit-validation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ZaxbyHub/opencode-swarm .opencode/skills/skill-edit-validation2Вручную: положить файлы
.github/skills/skill-edit-validation/SKILL.md1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill skill-edit-validation -a gemini-cli2Командой платформы
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .opencode/skills/skill-edit-validationВручную: положить файлы
.devin/skills/skill-edit-validation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill skill-edit-validation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о skill-edit-validation
Как установить skill-edit-validation в Claude Code?
Выполните команду npx skills add ZaxbyHub/opencode-swarm --skill skill-edit-validation -a claude-code в терминале.
Что делает skill-edit-validation?
Он сканирует тесты на наличие старых формулировок после правок markdown-файлов навыков и помогает обновить падающие проверки в том же коммите.
В каких каталогах скилл отслеживает изменения?
Проверка запускается при смысловых правках .md в папках .opencode/skills/, .claude/skills/ и .agents/skills/.
Исходный текст
SKILL.md · MIT
---
name: skill-edit-validation
description: Content-assertion sweep after editing SKILL.md files. Triggered when a task changes skill or prompt content that tests assert against. Prevents stale-assertion CI failures.
metadata:
audience: swarm-plugin
---
# Skill Edit Validation
## Trigger
After editing ANY `.md` file under `.opencode/skills/`, `.claude/skills/`, or `.agents/skills/` that changes content wording (not just whitespace/formatting).
## Protocol
1. **Extract changed phrases:** Identify old wording vs new wording (e.g., "spec.md does NOT exist" changed to "NO effective spec exists")
2. **Targeted sweep:** For each OLD phrase, grep test files:
```
rg "<old-phrase>" tests/ src/ --type ts -l
```
Focus on: `*-audit*`, `*-security*`, `*-spec-gate*`, `*skill-mirror*`, `*soft-spec*`, `*prompt*`, `*workflow*`
3. **For each match:** Read the assertion context (surrounding 10 lines). Verify:
- Does the assertion still hold against the new content?
- Is it checking a substring containing the old phrase?
- Is it checking for the ABSENCE of a word the new wording introduces? (e.g., `not.toContain('skip')` catches "this check is skipped")
4. **Prefer the semantic registry:** If the assertion is checking skill behavior
rather than an exact contract string, move it behind
`tests/helpers/skill-content-registry.ts` (or add a concept there) and assert
the named concept from the test.
5. **Update stale assertions in the same changeset.** Do NOT defer to CI.
6. **Preserve behavioral intent:** When updating, preserve what the assertion TESTS (e.g., "the plan skill has a spec-absent branch"), not just the string match.
## Constraint
Do NOT rubber-stamp brittle assertions. If an assertion tests implementation detail rather than behavioral intent, flag it for refactoring to a semantic check.
## Root cause
Skill-content tests should assert named semantic concepts where possible. The
registry in `tests/helpers/skill-content-registry.ts` is the preferred safety
net for recurring skill wording checks; use the manual grep sweep for exact
contract strings and any tests not yet migrated.
© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm