CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-decision-receipts

Mint a tamper-evident, post-quantum-signed receipt for a consequential agent action (deploy, delete, pay, grant-access, model decision) so it can be verified later from the certificate alone. Use when an autonomous agent takes a side-effecting action that may need to be proven later, or when satisfying EU AI Act Article 12 record-keeping. Three decisions: whether an action needs a receipt, minting it, verifying it. Signing is delegated to the open-source OpenAgentOntology package. Not after-the-fact log analysis; not a hosted notary; not a legal opinion.

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill body: executable Quick Start, clean three-decision workflow with built-in validation, and correct use of a single one-level-deep reference. The residual issues are small — slight redundancy between the Overview and Core Workflow/anti-pattern sections, and no explicit error-recovery guidance for failed mint or verify.

Suggestions

Trim the duplicated three-decision enumeration (Overview vs. Core Workflow intro) and consider compressing the three NOT-boundary paragraphs into one line each, since the frontmatter description already carries those boundaries.

Add a short error-recovery step to the workflow: what to do when build_action_manifest.py exits 2 (fill the missing required key and re-run) or when verify_receipt returns ok: False (which leg failed and how to interpret hash_ok vs. sig_ok).

DimensionReasoningScore

Conciseness

The body is efficient — tight tables, a lean Quick Start, anti-patterns that each earn their place. Minor trimmable redundancy keeps it below 5: the three decisions are enumerated in the Overview and restated in the Core Workflow intro, and the three NOT-boundary paragraphs largely restate the frontmatter description. It is noticeably above the 3 anchor ('some unnecessary explanation') so 4 fits best.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: 'pip install "openagentontology[pq]"', a real bundled script invoked with realistic flags (--agent my-deploy-agent --operation deploy --target prod/api), runnable mint/verify one-liners with the expected output shown ('{'ok': True, 'sig_ok': True, ...}'), and a required-keys table that states exact failure behavior (exit 2 on missing keys). Matches the 5 anchor.

5 / 5

Workflow Clarity

The three decisions are clearly sequenced with real validation checkpoints: the manifest is validated before signing (rejected with exit 2), and verification recomputes the hash and checks each signature leg, returning ok/hash_ok/sig_ok. It falls short of the 5 anchor because there is no explicit error-recovery loop (what to do when mint or verify fails) — squarely the 4 anchor ('clear sequence with most checkpoints; minor validation gaps').

4 / 5

Progressive Disclosure

A 102-line overview body with one clearly signaled, one-level-deep reference — 'See [references/receipt-fields.md](references/receipt-fields.md) for the full receipt schema and the post-quantum rationale' — and the receipt-schema bulk correctly lives in that file, which exists in the bundle alongside the real scripts/build_action_manifest.py. Matches the 5 anchor (clear overview, well-signaled one-level-deep references, easy navigation).

5 / 5

Total

18

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person voice, explicit 'Use when...' triggers, concrete capabilities, and unusually effective boundary exclusions that carve out the skill's niche. The only gap is a few natural synonyms (audit, accountability) that users might phrase differently.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — mint a tamper-evident, post-quantum-signed receipt, verify it 'from the certificate alone', and the three explicit decisions (whether needed, minting, verifying) — with concrete action types (deploy, delete, pay, grant-access, model decision). Coverage within the niche is comprehensive, including the delegation of signing to OpenAgentOntology, matching the 5 anchor rather than the 4 anchor's 'minor gaps'.

5 / 5

Completeness

Both what and when are explicit: 'Mint a tamper-evident, post-quantum-signed receipt... so it can be verified later from the certificate alone' and 'Use when an autonomous agent takes a side-effecting action that may need to be proven later, or when satisfying EU AI Act Article 12 record-keeping'. This matches the 5 anchor (explicit what AND when with concrete trigger phrases).

5 / 5

Trigger Term Quality

Good natural-term coverage: 'receipt', 'tamper-evident', 'post-quantum', 'deploy, delete, pay, grant-access', 'EU AI Act Article 12 record-keeping', 'proven later'. A few natural phrasings a user might say are absent (e.g. 'audit trail', 'accountability', 'provenance'), which fits the 4 anchor ('good keyword coverage; a few natural terms missing') better than the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche (signed evidence receipts for consequential agent actions) with explicit negative boundaries — 'Not after-the-fact log analysis; not a hosted notary; not a legal opinion' — that sharply reduce overlap with logging, notary, and legal-advice skills. Minimal conflict risk, matching the 5 anchor.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

alirezarezvani/claude-skills

Path

ra-qm-team/skills/agent-decision-receipts/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.