skill-provenance SKILL.md skillA

skill-provenance from snapsynapse/skill-provenance is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add snapsynapse/skill-provenance/skill-provenance@v26

Pins v26 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
snapsynapse/skill-provenance
Path
skill-provenance/SKILL.md
Versions recorded
6
Latest version
v26, committed Sep 24, 2026
First version recorded
Jul 16, 2026
Size
21,923 bytes
Repository stars
7
License
MIT

Version, validate, package, verify, recover, and hand off Agent Skill bundles across local folders, registries, platform uploads, and agent sessions. Use for MANIFEST.yaml, CHANGELOG.md, bundle hashes, stale evals, frontmatter portability, derived skill packages, or version identity that must survive filename changes and cross-platform movement. Do not use for ordinary Git version control that does not involve an Agent Skill bundle. Compatible with the agentskills.io open standard.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Skill Provenance

## The Problem This Solves

Skill projects move between sessions, surfaces (Chat, IDE, CLI, Cowork),
platforms (Claude, Gemini CLI, Codex, Copilot), and local storage
(Obsidian, working directories, git repos). Version identity gets lost
when it lives only in filenames. A file renamed from `SKILL_v4.md` to
`SKILL_v5.md` with no internal record of what changed creates ambiguity.

This skill establishes three conventions that prevent that:

1. Version identity lives inside files when their format allows it, and
   always in the manifest.
2. A recent changelog travels with the skill bundle, while longer history
   can live in the source repo.
3. A manifest lists every file in the bundle, and verification fails on
   unlisted files, so any session can verify completeness.

## What Gets Versioned

A skill bundle is a SKILL.md plus all associated files. Typical contents:

- SKILL.md (the skill definition)
- evals.json (evaluation suite)
- Generation scripts (e.g., generate.js, generate.py)
- Output artifacts (.docx, .pdf) produced by evals or real use
- Handoff notes
- Source material provided by the user (tracked but not versioned)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add snapsynapse/skill-provenance/skill-provenance@sha256:d83d2ad7a3065907

The line at the top of this page pins the label v26, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_kcmhp7753bcaowpp.svg)](https://markdownregistry.com/a/art_kcmhp7753bcaowpp)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Jul 16, 2026 and Sep 24, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
v26 latest2026-09-24 5ab4070 21,923 BA view · diff
v252026-08-29 2a75231 21,044 BA view · diff
v242026-08-20 3ed2639 20,600 BA view · diff
v232026-07-21 8002a07 26,257 BA view · diff
v222026-07-21 877c4d4 25,967 BA view · diff
v202026-07-16 c037e15 25,003 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (21923 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

snapsynapse/skill-provenance · 7 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_kcmhp7753bcaowpp
GET https://markdownregistry.com/api/v1/resolve?ref=snapsynapse/skill-provenance/skill-provenance
GET https://markdownregistry.com/api/v1/blob/d83d2ad7a30659078782a0a13936a3fe57bb052b7610b507f6f1f25ec7693c05

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from snapsynapse/skill-provenance

AGENTS.md AGENTS.md file
snapsynapse/skill-provenance · AGENTS.md
git:20260924.5ab4070 · audit A · 7 stars
CLAUDE.md CLAUDE.md file
snapsynapse/skill-provenance · CLAUDE.md
git:20260924.faf6b58 · audit A · 7 stars
llms.txt llms.txt file
snapsynapse/skill-provenance · llms.txt
git:20260924.faf6b58 · audit A · 7 stars
bootstrap SKILL.md skill
snapsynapse/skill-provenance · skills/bootstrap/SKILL.md · Add version tracking to an existing unversioned skill bundle. Use when you have a skill project with SKILL.md but no…
git:20260820.3ed2639 · audit A · 7 stars
close SKILL.md skill
snapsynapse/skill-provenance · skills/close/SKILL.md · Update version tracking when finishing work on a skill bundle. Use when you're done editing a skill project and need to…
git:20260924.5ab4070 · audit A · 7 stars
handoff SKILL.md skill
snapsynapse/skill-provenance · skills/handoff/SKILL.md · Generate a handoff note summarizing skill project state for a future session or collaborator. Use when crossing a…
git:20260820.3ed2639 · audit A · 7 stars
open SKILL.md skill
snapsynapse/skill-provenance · skills/open/SKILL.md · Verify a skill bundle's integrity when opening a project. Use when loading a skill project directory and you need to…
git:20260924.5ab4070 · audit A · 7 stars
validate SKILL.md skill
snapsynapse/skill-provenance · skills/validate/SKILL.md · Run a focused validation check for a skill bundle. Use when the user asks to validate, verify hashes, check…
git:20260924.5ab4070 · audit A · 7 stars

Every file in snapsynapse/skill-provenance

Browse by kind, by grade A, or by owner.