# Maintain Verification Skill

> Keep a project's verification skill and feature map honest. Parallel source readers per feature, one live session driving every feature, at most one PR of proven corrections. Use for maintain-verification-skill or audit the verify skill.

- Skill: `shipshitdev/maintain-verification-skill` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds add shipshitdev/maintain-verification-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shipshitdev/maintain-verification-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- License: MIT
- Author: shipshitdev (https://skillmd.com/u/shipshitdev)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/shipshitdev/maintain-verification-skill

---


# Maintain a verification skill

A feature map rots the moment the app changes. This is the upkeep loop
for a skill generated by `create-verification-skill`.

## Authorized Scope

Apply this engine only within the user's requested task and existing explicit
authorization. Loading or delegating to it grants no additional authority.
Preserve report-only restrictions and the caller's target, host, provider, and
cost limits. Existing approval satisfies a gate only for the same actions and
scope; obtain approval before expanding them. Forward these limits to delegates.

## Contract

Inputs:

- A project-local verification skill with launch/drive sections and a
  feature map

Outputs:

- `clean`, `changed`, or `blocked`, said out loud
- At most one PR of proven corrections when changed

Creates/Modifies:

- Only the verification skill's own directory

External Side Effects:

- Starts and tears down local app instances during the live pass
- Opens a PR only for `changed`

Confirmation Required:

- Before opening the corrections PR

Delegates To:

- `create-verification-skill` when no verify skill exists

## Edit scope

Never edit product code during a run. Behavior the map describes that
the app no longer does is doc drift (fix the map) or a product
regression (report it).

## Pass

0. Locate the target. Several candidates → ask which. None → stop and
   point at `create-verification-skill`.
1. Index hygiene. Fix missing, extra, duplicate, or dead feature
   entries.
2. Source wave. One read-only subagent per feature file, launched
   concurrently. Children never drive the app.
3. Reconcile. Merge overlapping recipes. Sweep recent churn for
   missing user-facing surfaces.
4. Live pass. Required even when source looks clean. Doctor before
   first drive. Evidence survives every cleanup. Nothing a drive
   started outlives the run.
5. Triage. Doc drift → fix the map. Harness gap → fix the harness.
   Broken app behavior → report it, keep it out of this PR.
6. Ship or stop. `changed` gets one PR of proven corrections.
   `clean` or `blocked` gets a report only.

## Maintain Verification Skill procedure

Read [maintain-verification-skill procedure](references/maintain-verification-skill-procedure.md) when running this workflow.
Apply the authorized scope and mode of this entry point to every step.
Resolve other skills through this distribution’s active catalog; resolve
resources relative to the installed skill directory.