SKILL.md
Create a verification skill
Every serious project needs a scripted way to drive the real app and prove behavior. This skill generates that as a project-local skill tailored to the repo.
Companion to verification-before-completion, which is the completion gate. This skill authors the project harness that gate can run.
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 repo that can build and start locally
Outputs:
- A project-local
verify-<app>skill with a feature map, proven once
end to end
Creates/Modifies:
.agents/skills/verify-<app>/when that layout exists, otherwise
skills/verify-<app>/
External Side Effects:
- Starts and tears down local app instances during the proof pass
Confirmation Required:
- Before writing the skill into the project tree
Delegates To:
- Named:
maintain-verification-skillfor later upkeep verification-before-completionfor the completion gate itself
Steps
- Interview the repo, not the user. Answer surface, run, drive,
observe, and isolate from the codebase. Ask only what you cannot observe. If the checkout does not start, fix or report that first.
- Generate the skill with frontmatter (
name: verify-<app>) and
sections: Launch, Doctor, Drive, Evidence, Cleanup, Helpers. No placeholders left. Prefer existing harnesses (Playwright, expect, PTY, HTTP) over generic recipes.
- Seed the feature map. Write
features/README.mdplus one file
per top user-facing feature (aim for 3-5). Follow [references/feature-map-example.md](references/feature-map-example.md).
- Prove it. Run launch, doctor, drive ONE mapped feature, capture
evidence, clean up. After cleanup, confirm the evidence still exists. A skill that was never executed is a draft.
- Offer the maintenance loop. Point at
maintain-verification-skill.
Create Verification Skill procedure
Read [create-verification-skill procedure](references/create-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.