maintain-agent-instructions SKILL.md skillA

maintain-agent-instructions from arasz/ai-badger is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add arasz/ai-badger/maintain-agent-instructions@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
arasz/ai-badger
Path
features/common/skills/maintain-agent-instructions/SKILL.md
Versions recorded
5
Latest version
v1.0.0, committed Aug 8, 2026
First version recorded
Jul 27, 2026
Size
4,459 bytes
Repository stars
3
License
MIT

Use when agent instruction files have drifted from each other or from the policy model — CLAUDE.md, copilot-instructions.md, AGENTS.md, hosted-review and path-scoped instruction files — or when validation/drift checks fail in CI. Reconciles them from the machine-readable model in .ai-badger/agent-instructions/.

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

# Maintain agent instructions

This skill keeps agent guidance consistent while minimizing always-loaded context. It follows a
hub-and-spoke model: one compact, always-loaded entrypoint per agent (`CLAUDE.md`,
`.github/copilot-instructions.md`, …) plus detailed, path-scoped or on-demand
instruction files. The model is machine-readable so drift between agent files can be checked by
script instead of by eye — if the project records this decision as an ADR, link it here.

## When NOT to Use

- A single-file typo fix in one instruction file — edit it directly
- No drift exists and CI checks pass
- Authoring brand-new policy from scratch — that is content work, not reconciliation

## Principles

- Use scripts first; inspect only failing files/rules.
- Keep each agent's always-loaded entrypoint compact. Put detailed guidance in scoped or
  on-demand files.
- Update the agent-instructions model (`.ai-badger/agent-instructions/model.json` by default; see
  `references/agent-instruction-model.md`) **when** changing shared policy.
- Treat `.github/instructions/*.instructions.md` (or the project's equivalent) as the shared
  path-scoped implementation rule source.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add arasz/ai-badger/maintain-agent-instructions@sha256:e25fe03f28e10556

The line at the top of this page pins the label v1.0.0, 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_bh2mbd73egjnofbr.svg)](https://markdownregistry.com/a/art_bh2mbd73egjnofbr)

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

Versions

The registry has recorded 5 versions of this file, between Jul 27, 2026 and Aug 8, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-08-08 9006bf5 4,459 BA view · diff
v1.0.02026-08-07 4ef57e9 4,444 BA view · diff
v1.0.02026-08-07 013ee4d 3,896 BA view · diff
git:20260806.70e384e2026-08-06 70e384e 3,541 BA view · diff
git:20260727.d4facd12026-07-27 d4facd1 3,561 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 (4459 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

arasz/ai-badger · 3 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bh2mbd73egjnofbr
GET https://markdownregistry.com/api/v1/resolve?ref=arasz/ai-badger/maintain-agent-instructions
GET https://markdownregistry.com/api/v1/blob/e25fe03f28e10556704452d30c1b146f78cc100a7b0e8f7cd688c2576a99db69

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 arasz/ai-badger

CLAUDE.md@.ai-badger CLAUDE.md file
arasz/ai-badger · .ai-badger/CLAUDE.md
git:20261007.5d99092 · audit A · 3 stars
ai-raccoon-memory SKILL.md skill
arasz/ai-badger · .ai-badger/skills/ai-raccoon-memory/SKILL.md · Use when a project needs a memory server — search project and shared memory first, write durable facts with source…
v0.2.0 · audit A · 3 stars
archify SKILL.md skill
arasz/ai-badger · .ai-badger/skills/archify/SKILL.md · Use when the user asks to visualize system architecture, infrastructure, cloud/security topology, technical workflows…
v2.16.0 · audit A · 3 stars
artifact-verification SKILL.md skill
arasz/ai-badger · .ai-badger/skills/artifact-verification/SKILL.md · Use when verifying changed artifacts that lack a canonical test gate — specs, docs, manifests, generated files…
v1.0.0 · audit A · 3 stars
auto-wm SKILL.md skill
arasz/ai-badger · .ai-badger/skills/auto-wm/SKILL.md · Use when the user wants Claude to auto-approve tool calls — "enable autonomic/autonomous work mode", "/auto-wm"…
v1.0.0 · audit A · 3 stars
browser-usage SKILL.md skill
arasz/ai-badger · .ai-badger/skills/browser-usage/SKILL.md · Use when interacting with web pages, running manual E2E browser tests, testing UI flows, or inspecting live web…
v1.0.0 · audit A · 3 stars
call-behaviorist SKILL.md skill
arasz/ai-badger · .ai-badger/skills/call-behaviorist/SKILL.md · Use when ai-badger's own machinery needs to be observed — "did that hook even run?", "enable debug logging", "why is…
v1.0.0 · audit A · 3 stars
code-review-checklist SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review-checklist/SKILL.md · Use when reviewing code — a PR, a diff, or freshly written changes — and you want concrete pass/fail checks rather than…
v1.0.0 · audit B · 3 stars
code-review-evidence SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review-evidence/SKILL.md · Use when reviewing code that wraps external libs/extensions/SDKs/CLIs, or QA-reviewing a test harness: verify…
v1.0.0 · audit A · 3 stars
code-review SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review/SKILL.md · Use when performing a code review in this repository — reviewing a pull request, a branch diff, or a requested…
v1.0.0 · audit A · 3 stars
commit-reminder SKILL.md skill
arasz/ai-badger · .ai-badger/skills/commit-reminder/SKILL.md · Use when a project has accumulated uncommitted changes and nobody has said so out loud — several edits in a row with no…
v1.0.0 · audit A · 3 stars
complete-project-scope-code-review SKILL.md skill
arasz/ai-badger · .ai-badger/skills/complete-project-scope-code-review/SKILL.md · Use when the whole project — not a diff — is the review target and the result must survive being acted on: "review the…
v1.0.0 · audit A · 3 stars

Every file in arasz/ai-badger

Other files named maintain-agent-instructions

maintain-agent-instructions SKILL.md skill
arasz/ai-badger · .ai-badger/skills/maintain-agent-instructions/SKILL.md · Use when agent instruction files have drifted from each other or from the policy model — CLAUDE.md…
v1.0.0 · audit A · 3 stars

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