agent-decision-receipts

Mint and verify tamper-evident signed receipts for consequential agent actions.

25.3k|3.6k|Updated Oct 19, 2025
One-click install
npx skills add https://github.com/alirezarezvani/claude-skills --skill agent-decision-receipts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-decision-receipts
Source: https://github.com/alirezarezvani/claude-skills/tree/main/ra-qm-team/skills/agent-decision-receipts
Command: npx skills add https://github.com/alirezarezvani/claude-skills --skill agent-decision-receipts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openagentontology, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Autonomous agents take side-effecting actions like deploys, deletions, and payments, but ordinary logs can be silently edited and cannot prove what happened later. This Skill mints a tamper-evident, cryptographically signed receipt at the moment of action so auditors, insurers, or regulators can verify it offline from the certificate alone.

Core Features & Use Cases

  • Decision framework: A three-question test (side-effecting, consequential, later-provable) decides whether an action warrants a receipt, with high-signal triggers like deploy, delete, pay, and grant_access.
  • Manifest building and validation: A stdlib-only Python script builds an ASCII-safe action manifest with required fields (agent_id, operation, target, policy) and hashes inputs so secrets and PII are never stored in cleartext.
  • Post-quantum signing and verification: Signing is delegated to the open-source OpenAgentOntology primitive, which signs with Ed25519 plus ML-DSA-65 (FIPS 204) and SLH-DSA (FIPS 205) legs, and verification recomputes the evidence hash and checks each signature leg with no database or network.
  • Use Case: A deployment agent approves a production release under EU AI Act Article 12 record-keeping obligations; the receipt minted at execution can later be verified by a regulator years afterward, even if a quantum computer could forge Ed25519.

Quick Start

Ask the agent to build an action manifest for a deploy operation against prod/api under the EU AI Act Art 12 policy, then mint and verify the signed receipt using the openagentontology package.

Frequently Asked Questions about agent-decision-receipts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a tamper-evident receipt for an AI agent action?

Build an action manifest with the bundled build_action_manifest.py script supplying agent, operation, target, and policy, then call openagentontology's mint_receipt on it. The receipt is signed with Ed25519 plus post-quantum legs and can be verified later from the certificate alone.

When should an agent action get a signed receipt?

Mint a receipt when the action is side-effecting, consequential, and later-provable, such as deploy, delete, pay, grant_access, or export operations. Read-only, reversible, or trivial actions do not need receipts, since receipting everything drowns the signal.

Does receipt verification require a database or network connection?

No, verification works entirely offline from the receipt itself. verify_receipt recomputes the SHA-256 hash of the canonical evidence and checks each signature leg using the public key embedded in the receipt, with no call back to the issuer.

Why sign receipts with post-quantum algorithms like ML-DSA-65?

Receipts are long-lived evidence that auditors may verify years later, and a future quantum computer could forge Ed25519 signatures. Installing openagentontology[pq] adds ML-DSA-65 (FIPS 204) and SLH-DSA (FIPS 205) legs so the receipt stays verifiable.

What are the limitations of agent decision receipts?

Receipts are locally self-signed evidence, not a hosted notary service, so cross-organization proof is out of scope. They support FRE 902(13)/(14)-style certification and EU AI Act Article 12 record-keeping, but admissibility in court is a legal decision, not a tool guarantee.