Навык impl-validator
✓ ПровереноПроверяет соответствие реализации заявленной цели путем проверки наличия, полноты, корректности и соблюдения конвенций.
- Звёзды на GitHub
- 3 716
- Файлы
- 1
- Последний коммит
- 11 нояб. 2026 г.
- Лицензия
- MIT
- Разрешённые инструменты
- —
Что делает навык impl-validator?
Проверяет соответствие реализации заявленной цели путем проверки наличия, полноты, корректности и соблюдения конвенций.
Сводка сгенерирована из SKILL.md навыка.
О skill impl-validator
Основная функция этого инструмента — проверка того, соответствует ли техническая реализация поставленной цели. Он выступает в роли критического рецензента для разработчиков или других агентов, помогая выявлять ошибки в файлах, командах или текстовых выводах до их финализации. Валидатор выполняет проверки на наличие, полноту, корректность и соблюдение конвенций, чтобы убедиться, что такие артефакты, как shell-скрипты, страницы wiki или файлы навыков, соответствуют конкретным требованиям.
Агент может использовать этот инструмент в режиме subagent, обрабатывая структурированный блок проверки, содержащий цель, список артефактов и конкретные задачи по верификации. Также он может работать в режиме user, когда человек предоставляет описание проделанной работы. Инструмент формирует структурированный отчет с вердиктами PASS, WARN или FAIL, подсвечивая конкретные проблемы, такие как отсутствие YAML frontmatter, текст-заполнители вроде TODO или неверные пути к файлам. Он фокусируется исключительно на том, выполняет ли реализация поставленную задачу, не оценивая стиль или производительность.
Что агент может делать с ним
- 1Автоматизированная проверка реализацииАгент может программно запускать проверку валидации собственных сгенерированных файлов, чтобы убедиться в их соответствии конкретной цели.
- 2Валидация технической документацииПроверка того, что страницы wiki содержат все необходимые поля метаданных, такие как заголовок, категория и теги.
- 3Аудит готовности shell-скриптовПроверка того, что сгенерированный скрипт содержит shebang и является исполняемым.
- 4Обнаружение ошибок с заполнителямиВыявление случаев, когда в реализации случайно остались шаблонный текст или переменные.
Написано на основе skill SKILL.md. Каждый сценарий использования проверен по цитате из него.
Как установить навык impl-validator
Каждая команда копирует папку навыка в каталог навыков клиента. Перезапустите клиент или начните новую сессию, чтобы загрузить его.Установка навыка impl-validator в Плагин
/plugin marketplace add Ar9av/obsidian-wiki /plugin install obsidian-wiki@obsidian-wiki
Установка навыка impl-validator в Claude Code
~/.claude/skills/impl-validator/SKILL.md
$ npx degit Ar9av/obsidian-wiki/skills/impl-validator ~/.claude/skills/impl-validatorУстановка навыка impl-validator в Claude Code (project)
.claude/skills/impl-validator/SKILL.md
$ npx degit Ar9av/obsidian-wiki/skills/impl-validator .claude/skills/impl-validatorУстановка навыка impl-validator в Codex
~/.agents/skills/impl-validator/SKILL.md
$ npx degit Ar9av/obsidian-wiki/skills/impl-validator ~/.agents/skills/impl-validatorУстановка навыка impl-validator в Gemini CLI
~/.gemini/skills/impl-validator/SKILL.md
$ npx degit Ar9av/obsidian-wiki/skills/impl-validator ~/.gemini/skills/impl-validatorУстановка навыка impl-validator в Claude.ai
npx degit Ar9av/obsidian-wiki/skills/impl-validator impl-validator && zip -r impl-validator.zip impl-validator # claude.ai → Customize → Skills → + → Create skill → Upload a skill → impl-validator.zip
Автоматические проверки
Запущено 15 нояб. 2026 г.Полный отчёт →Прошёл наши автоматические проверки. Это не аудит безопасности: прочитайте скрипты, прежде чем агент их запустит. Как работают проверки
- Связанный и доступный исходный репозиторийar9av/obsidian-wiki/skills/impl-validator is public and reachablegithub.com/ar9av/obsidian-wiki/tree/HEAD/skills/impl-validat ↗Пройдено
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit 2026-11-11github.com/ar9av/obsidian-wiki/commits ↗Пройдено
- В скриптах нет загрузки с запуском и кражи учётных данныхNo scripts in the skill folderПройдено
- В SKILL.md нет скрытых инструкцийNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/ar9av/obsidian-wiki/blob/HEAD/skills/impl-validat ↗Пройдено
- Заранее разрешённые инструменты ограниченыNo pre-approved tools; the agent asks before using onegithub.com/ar9av/obsidian-wiki/blob/HEAD/skills/impl-validat ↗Пройдено
- SKILL.md соответствует формату Agent SkillsValid name and description; says when to use it; 115 linesgithub.com/ar9av/obsidian-wiki/blob/HEAD/skills/impl-validat ↗Пройдено
SKILL.md
Открыть на GitHubImplementation Validator — Quality Subagent
You are a critical reviewer. Another skill or agent has just done work and wants you to check it. Your job is to verify that what was produced actually matches what was intended — not to be encouraging, but to catch real problems before the user sees them.
This skill runs in two modes:
- Subagent mode — spawned programmatically by another skill passing a structured
check:block. Read the block, run the checks, return structured output. - User mode — the user invokes
/impl-validatordirectly, usually with a description of what was just done.
Input Format (Subagent Mode)
When spawned by another skill, you receive a block like:
impl-validator check:
goal: "<what the implementation was supposed to accomplish>"
artifacts: [<list of files written, commands run, or text output produced>]
checks:
- <specific thing to verify>
- <specific thing to verify>
...
Parse this block and treat each field as your mandate.
Input Format (User Mode)
The user describes what was just done. Infer the goal and artifacts from context. Ask one clarifying question if the goal is ambiguous — do not proceed on a guess for critical checks.
Validation Protocol
Step 1: Understand the Goal
Restate the goal in one sentence. If you can't, the goal is underspecified — flag this as a WARN.
Step 2: Check Each Artifact
For each artifact (file, output, config):
- Existence check — does the file/output actually exist? Read it.
- Completeness check — does it contain all required sections/fields the goal implies?
- Correctness check — does the content logically match the stated goal? Look for:
- Placeholder text left in place (
<TODO>,{{variable}},INSERT HERE) - Copy-paste errors (wrong tool name, wrong path, stale dates)
- Logical contradictions (e.g. a diff that claims page X is "only in codex" but also lists it under claude)
- Missing required fields (e.g. a SKILL.md missing
name:ordescription:frontmatter) - Off-by-one or empty-set edge cases (e.g. page count = 0 when vault is known non-empty)
- Placeholder text left in place (
- Convention check — does it follow the project's established patterns?
- Skills: has YAML frontmatter with
nameanddescription; instructions are in imperative voice; steps are numbered; no placeholder text - Wiki pages: has all required frontmatter fields (
title,category,tags,sources,created,updated) - Shell scripts: have a shebang line; are
chmod +x-able; useset -e - Plist files: valid XML;
Labelmatches filename;ProgramArgumentsreferences a real path
- Skills: has YAML frontmatter with
Step 3: Run the Provided Checks
For each check in the checks: list, evaluate it explicitly. Don't skip. Answer each with:
- PASS — verified true
- WARN — probably fine but worth noting
- FAIL — definitively wrong or missing
Step 4: Produce Verdict
## impl-validator Report
**Goal:** <restated goal>
### Checks
| Check | Result | Note |
|-------|--------|------|
| <check 1> | PASS/WARN/FAIL | <one-line explanation> |
| <check 2> | PASS/WARN/FAIL | <one-line explanation> |
...
### Overall: PASS / WARN / FAIL
**Issues to fix (FAIL):**
- <specific issue with file path and line if applicable>
**Worth noting (WARN):**
- <non-blocking observation>
Overall verdict rules:
- Any FAIL → overall FAIL
- No FAILs but any WARNs → overall WARN
- All PASS → overall PASS
Step 5: Return to Caller
In subagent mode: return the full report as your response. The calling skill reads it and decides whether to fix issues before presenting output to the user.
In user mode: present the report directly. If overall FAIL, offer to fix the issues.
What NOT to check
- Style preferences (Oxford comma, variable naming) unless they break a convention
- Performance or efficiency — out of scope unless the goal mentions it
- Whether the goal itself is a good idea — check implementation against goal, not goal against your opinion
- Hypothetical future problems — only flag actual issues in the current artifact
Severity Guide
| Severity | Example |
|---|---|
| FAIL | Required frontmatter field missing; file doesn't exist; check is definitively false |
| WARN | Hardcoded path that might break on other machines; page count suspiciously low |
| PASS | Check is verified true |
Файлы в этом навыке
1Вопросы о навыке impl-validator
Как установить навык impl-validator в Claude Code?
Выполните npx degit Ar9av/obsidian-wiki/skills/impl-validator ~/.claude/skills/impl-validator. Claude Code загружает навыки из ~/.claude/skills (все проекты) или .claude/skills (один проект) и использует навык, когда его описание соответствует задаче.
Какие клиенты могут использовать навык impl-validator?
Любой клиент, который читает формат Agent Skills: Claude Code, Codex, Gemini CLI и claude.ai (загрузить как ZIP). Скрипты в навыке выполняются только там, где клиент разрешает выполнение кода.
Какие режимы работы есть у этого SKILL?
Этот SKILL работает в режиме Subagent, когда он программно запускается другим навыком, и в режиме User, когда он вызывается пользователем напрямую.
Что именно проверяет проверка корректности?
Она ищет текст-заполнители, ошибки копипаста, логические противоречия, отсутствие обязательных полей и граничные случаи, такие как ошибки на единицу (off-by-one errors).