staleness-audit SKILL.md skillA

staleness-audit from flagrare/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add flagrare/agent-skills/staleness-audit@git:20260611.9c42181

Pins git:20260611.9c42181 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
flagrare/agent-skills
Path
plugins/flagrare/skills/staleness-audit/SKILL.md
Versions recorded
4
Latest version
git:20260611.9c42181, committed Jun 11, 2026
First version recorded
May 22, 2026
Size
10,812 bytes
Repository stars
13
License
none declared

Pre-commit audit. Invoke before every git commit. Diffs the staged change against the repo's "canaries" (README, decision log, roadmap, public API, doc comments, release notes, test discipline) and surfaces anything that's drifted out of sync. Updates the obvious drifts in place; flags judgement calls for the operator.

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

# Staleness audit

Run this before every commit. The goal is simple: **a commit should leave the docs, types, and roadmap in a state consistent with the code it ships**. Drift between code and its surrounding narrative is how projects rot.

Don't be lazy, actually run the checks. Each one is a `grep` or a `diff`. The whole audit should take under 30 seconds.

## How to invoke

You (the model) invoke this skill yourself, before staging the final commit. The rule: *every commit goes through this checklist*. If you're amending or splitting commits, run it per commit.

## Inputs

- `git diff --staged --stat`, what's about to be committed
- `git diff --staged`, the actual hunks (only read the ones you need)
- `git status`, what's unstaged or untracked that might also be drift
- The repo working tree for the canary files listed below

## Procedure

Work through the checks in order. For each finding, either **fix it now** (if the fix is mechanical and in scope) or **note it explicitly** in the commit body / the response to the user (if it's a judgement call).

### 1. README staleness

The `README.md` is the project's storefront. After every commit, ask:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add flagrare/agent-skills/staleness-audit@sha256:c5b68614d1d08eae

The line at the top of this page pins the label git:20260611.9c42181, 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_wsxaki3v7ahpdkrz.svg)](https://markdownregistry.com/a/art_wsxaki3v7ahpdkrz)

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

Versions

The registry has recorded 4 versions of this file, between May 22, 2026 and Jun 11, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
git:20260611.9c42181 latest2026-06-11 9c42181 10,812 BA view · diff
git:20260522.427bc5d2026-05-22 427bc5d 10,854 BA view · diff
git:20260522.63466ba2026-05-22 63466ba 10,399 BA view · diff
git:20260522.b33bded2026-05-22 b33bded 9,767 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 (10812 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

flagrare/agent-skills · 13 stars · license none declared · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_wsxaki3v7ahpdkrz
GET https://markdownregistry.com/api/v1/resolve?ref=flagrare/agent-skills/staleness-audit
GET https://markdownregistry.com/api/v1/blob/c5b68614d1d08eae1a6129405f3994ab48314b0a6717fa06726d93483a733784

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 flagrare/agent-skills

atdd-plan SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/atdd-plan/SKILL.md · Produce an ATDD-first implementation plan in Claude Code's native plan mode, with named design patterns called out…
git:20261002.8acabf4 · audit A · 13 stars
brag-doc SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/brag-doc/SKILL.md · Generate a comprehensive, impact-framed brag-doc entry for a chosen time window (day, week, biweek, month, or custom)…
git:20261028.5276366 · audit A · 13 stars
bug-bash SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/bug-bash/SKILL.md · Programmatic bug bashing, ingest a prescribed test plan (Notion, markdown, pasted spec), drive a real running system…
git:20261030.337a593 · audit A · 13 stars
career SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/career/SKILL.md · Run the career skills that are due, in one pass, and return one short combined digest plus an updated board. It reads…
git:20261028.5276366 · audit A · 13 stars
codebase-explore SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/codebase-explore/SKILL.md · Explore the codebase to map conventions, reusable utilities, analogous features, and data flows relevant to a planned…
git:20260611.9c42181 · audit A · 13 stars
communication-setup SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/communication-setup/SKILL.md · Set up, change or remove how Claude talks to you: a custom output style with your reply rules, a reminder of those…
git:20261104.0a7bead · audit A · 13 stars
daily-code-review SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/daily-code-review/SKILL.md · Generate a daily code review report showing stale PRs, items needing your attention, and active work for your team. Use…
git:20261008.b2c58b8 · audit A · 13 stars
debug-hunt SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/debug-hunt/SKILL.md · Evidence-first debugging for bugs that are hard to reproduce, intermittent, performance-related, or where previous…
git:20260611.9c42181 · audit A · 13 stars
design-review SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/design-review/SKILL.md · Evaluate and refine UI the way a senior product designer would, visual hierarchy, spacing and rhythm, typographic…
git:20261014.0a5d2b2 · audit A · 13 stars
editorial-pass SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/editorial-pass/SKILL.md · Review a finished or near-finished document the way a human editor reads it, start to finish, building a model of what…
git:20261104.528454a · audit A · 13 stars
figma-matcher SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/figma-matcher/SKILL.md · Enforces pixel-perfect implementation of Figma designs by exhaustively extracting every visual property from Figma…
git:20260731.d6ff316 · audit A · 13 stars
five-lens-review SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/five-lens-review/SKILL.md · Evaluate a product-direction question through five expert lenses, Senior PM, Senior Product Engineer, Senior Product…
git:20260611.9c42181 · audit A · 13 stars

Every file in flagrare/agent-skills

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