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.

67

Quality

84%

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

The canonical home for this skill is agent-decision-receipts in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

The body is well-structured and command-level actionable, with a clear decide/mint/verify sequence and an explicit verification checkpoint. The main defects are bundle integrity — both referenced files (scripts/build_action_manifest.py, references/receipt-fields.md) are absent, breaking the Quick Start's first step and the only progressive-disclosure path — and a missing error-recovery loop for failed verification.

Suggestions

Ship the referenced bundle files (scripts/build_action_manifest.py and references/receipt-fields.md) or remove the dead references — as delivered, Quick Start step 1 fails and the promised receipt-schema/PQ-rationale detail is unreachable.

Add an explicit error-recovery branch to Decision 3: what to do when verify_receipt returns ok:false, hash_ok:false, or sig_ok:false, and when the manifest build exits 2 (fix and re-run), to close the workflow's feedback loop.

Trim the Overview's repetition of the description's boundary statements ('NOT log analysis / hosted notary / legal opinion') and the duplicated three-decision list, since the same content reappears as the Decision 1-3 sections.

DimensionReasoningScore

Conciseness

Mostly lean: the three-decision structure, compact tables, and a copy-paste Quick Start with no beginner-concept padding. It is not a 5 because the Overview restates the description's boundary framing ('NOT log analysis / NOT a hosted notary / NOT a legal opinion') and repeats the three-decision list that immediately follows as section headers — minor trimming opportunities. It is above 3 because there is no PDF-primer-style over-explanation of concepts Claude already knows; the log-vs-receipt distinction is skill-specific framing, not padding.

4 / 5

Actionability

Concrete, command-level guidance throughout: exact CLI invocations with arguments, the manifest key table with required/auto-added fields and rejection behavior (exit 2), runnable mint/verify one-liners, and expected verify output. Not a 5 because the Quick Start's first step ('python scripts/build_action_manifest.py ...') is not copy-paste executable — the script is not present in the bundle, so step 1 fails as shipped, though the manifest format is fully specified enough to reconstruct it.

4 / 5

Workflow Clarity

A clearly sequenced three-step workflow (decide → mint → verify) with an explicit validation checkpoint: the verify step shows the expected result ('-> {'ok': True, ...}') and the build step validates the manifest (exit 2 on missing keys), plus a checklist-style gate in Decision 1. Not a 5 because there is no error-recovery feedback loop — nothing tells the reader what to do when verification fails (ok/hash_ok/sig_ok false) or when the manifest is rejected; not 3 because validation checkpoints are present and explicit, not merely implied.

4 / 5

Progressive Disclosure

The body itself is well-sectioned and appropriately defers detail behind a single, clearly signaled, one-level-deep reference ('See [references/receipt-fields.md] for the full receipt schema and the post-quantum rationale'). But scored against the actual bundle structure, both referenced paths are dead — no references/ or scripts/ directories exist — so the promised receipt schema, PQ rationale, and the build script are unreachable, and navigation leads nowhere. Good signaling cannot score 4-5 when the referenced content is missing from the bundle.

3 / 5

Total

15

/

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: concrete capabilities, an explicit 'Use when' clause with varied trigger terms, and clear boundary statements that sharply delimit the skill's scope. Only minor headroom in natural-term synonyms (e.g., audit trail, accountability).

DimensionReasoningScore

Specificity

Multiple concrete actions are named — 'Mint a tamper-evident, post-quantum-signed receipt', 'verified later from the certificate alone', and the three decisions (whether to receipt, minting, verifying) — with concrete action types enumerated (deploy, delete, pay, grant-access, model decision). Coverage is comprehensive for this niche; not score 4 because there are no meaningful gaps in capability coverage.

5 / 5

Completeness

Explicitly answers both: what — 'Mint a tamper-evident, post-quantum-signed receipt... so it can be verified later from the certificate alone' — and when — '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'. Concrete trigger phrases plus explicit exclusions ('Not after-the-fact log analysis; not a hosted notary; not a legal opinion') make this a clear match for the top anchor.

5 / 5

Trigger Term Quality

Good keyword coverage: 'deploy', 'delete', 'pay', 'grant-access', 'model decision', 'receipt', 'proven later', 'EU AI Act Article 12 record-keeping'. A few natural terms a user would say are missing — 'audit trail', 'accountability', 'compliance evidence', 'non-repudiation' — which keeps it below the comprehensive-synonyms anchor of 5, but it is well above the sparse/missing-variation anchors of 2-3.

4 / 5

Distinctiveness Conflict Risk

A clear niche (signed evidence receipts for agent actions) with distinct triggers and explicit negative boundaries separating it from log analysis, hosted notaries, and legal opinions. Minimal conflict risk with other skills; nothing pushes it toward the overlap anchors at 3 or below.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/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.