validate · yahor-punko — Claude Code skill: what it does, how to install
validate runs the MavP validator to verify artifact synchronization between BACKLOG.md and TASK_STATUS.md before starting new tasks.
Apache-2.0 ★ 121 updated 2026-10-29
npx skills add yahor-punko/mavericks-os --skill validate -a claude-codeWhat validate does
This skill confirms that BACKLOG.md and TASK_STATUS.md stay aligned. It triggers the MavP operator by running ./scripts/mavp-operator --validate to catch drift across project artifacts.
The tool relies on three exit codes: 0 indicates a healthy state, 1 flags warnings and drifting items, while 2 marks critical failures requiring immediate repair. When exit code 2 occurs, you must repair the target artifact before continuing with tasks.
Without the ./scripts/mavp-operator script present in the repository, the command fails immediately.
What it helps with
- check artifact sync between BACKLOG.md and TASK_STATUS.md
- detect status drift before starting another task wave
- identify broken artifacts listed under repair targets
Example prompts for the agent
- Validate task sync between BACKLOG.md and TASK_STATUS.md
- Run the MavP validator and inspect artifact status
- Check whether our backlog files are healthy before starting work
How to install validate
1Skills CLI (Vercel)
npx skills add yahor-punko/mavericks-os --skill validate -a claude-code2Manually: put the files in place
~/.claude/skills/validate/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/validate/
1Skills CLI (Vercel)
npx skills add yahor-punko/mavericks-os --skill validate -a codex2Manually: put the files in place
.agents/skills/validate/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add yahor-punko/mavericks-os --skill validate -a cursor2Manually: put the files in place
.cursor/skills/validate/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install yahor-punko/mavericks-os .claude/skills/validate2Manually: put the files in place
.github/skills/validate/SKILL.md1Skills CLI (Vercel)
npx skills add yahor-punko/mavericks-os --skill validate -a gemini-cli2Platform CLI
gemini skills install https://github.com/yahor-punko/mavericks-os --path .claude/skills/validateManually: put the files in place
.devin/skills/validate/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about validate
How to install validate in Claude Code?
Run npx skills add yahor-punko/mavericks-os --skill validate -a claude-code in your terminal.
What does the validate skill do?
It executes ./scripts/mavp-operator --validate to verify consistency between backlog files and task tracking files.
What do the validator exit codes mean?
Code 0 means healthy, 1 points to warnings that need cleanup, and 2 means a required artifact must be repaired.
Source text
SKILL.md · Apache-2.0
--- name: validate description: Run the MavP validator to check artifact sync between BACKLOG.md and TASK_STATUS.md. Use after any backlog changes or to confirm healthy state before starting new work. user-invocable: true allowed-tools: Bash(./scripts/mavp-operator --validate*) --- ## Validator report !`./scripts/mavp-operator --validate` --- Exit codes: `0` = healthy, `1` = drifting (warnings), `2` = repair required (failures). If failures exist, repair the artifact listed in `Repair target` before proceeding. If warnings exist, clean them up before the next wave closes. If healthy, continue safely.
© yahor-punko · Apache-2.0 · yahor-punko/mavericks-os
Similar skills
All skills for Notes, tasks and projects →validate by other authors comes first.