mcpbeat

Grace Verification

osovv/grace-verification

Design and maintain GRACE 4 verification entries, commands, scenarios, markers, and assertion evidence under .grace/verification.

469 tokens
context cost
the whole folder, loaded on every use
2
files
instructions only
0
copies elsewhere
how many repositories repackaged it
231
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/osovv/grace-marketplace --skill grace-verification

The instruction itself

as written by the author

<skill>

<purpose>

Strengthen deterministic verification for modules and changes. Verification state lives in .grace/verification/index.xml and routed verification documents. Each durable module should have deterministic V-M-* coverage unless an explicit exception is planned.

</purpose>

<workflow>

  • Read relevant .grace/graph anchors and current V-M-* entries.
  • Identify scenarios, commands, test files, required log markers, and trace assertions.
  • Ensure commands are deterministic and runnable from the project root or documented cwd.
  • Update or propose .grace/verification changes through the active change plan.
  • Run the commands and record fresh evidence in the response.

</workflow>

<cwd_contract>

When verification commands run from a workspace or package directory, add one direct <Cwd>relative/project/path</Cwd> child to the owning V-M-* entry. Keep declared <TestFiles><File>...</File></TestFiles> paths project-root-relative; the CLI uses Cwd only to compare them with cwd-relative command arguments.

</cwd_contract>

<evidence_contract>

Use <Marker> when module health must prove a runtime log or trace emission from linked implementation code. Use <TraceAssertion> for deterministic test or trace evidence that does not require runtime logging, such as pure functions, type-level modules, and core libraries. A non-empty marker or trace assertion satisfies the module-health evidence requirement; only authored markers require matching runtime emission and BLOCK_* evidence.

</evidence_contract>

</skill>

How to use it

Copy the folder

Take osovv/grace-verification from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.