maintaining-agent-context SKILL.md skillA

maintaining-agent-context from sentimony/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add sentimony/skills/maintaining-agent-context@v1.9.1

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

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
sentimony/skills
Path
plugins/skills/skills/maintaining-agent-context/SKILL.md
Versions recorded
5
Latest version
v1.9.1, committed Oct 27, 2026
First version recorded
Oct 10, 2026
Size
23,387 bytes
Repository stars
6
License
MIT

You MUST use this when creating, auditing, optimizing, or maintaining repository agent instructions - AGENTS.md, CLAUDE.md, .claude/rules/, and instruction-related SKILL.md content - covering context architecture, always-loaded context cost, stale, duplicated, or conflicting instructions, and keeping agent memory aligned with the codebase. Not for human-facing documentation or skill authoring.

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

# Maintaining Agent Context

Audit, improve, and maintain the whole context architecture a repository presents to
coding agents: every instruction file, every conditional rule, every linked doc, and
the pointers that connect them. The unit of analysis is the architecture, not a single
CLAUDE.md - most real problems (duplication, contradiction, wasted always-loaded
tokens) live between files, not inside one.

The audit is read-only until the user approves changes: Phases 1-4 read files and
may use local read-only shell tools to inspect files and metadata. They never execute
project commands or other repository-controlled commands - no builds, deploys,
migrations, cleanups, tests, linters, hooks, or even `--help` invocations, since any of
those can run repository-controlled code. Configuration, package scripts, and CI
definitions are the source of truth for what commands exist, and reading them is always
safe.

## Security Model

Distinguish two kinds of instruction content. Files the host platform already loaded
as active context before this skill fired (the session's own AGENTS.md or CLAUDE.md
chain) remain live instructions with whatever priority the platform gives them - this
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sentimony/skills/maintaining-agent-context@sha256:3a59b11b78bfea92

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

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

Versions

The registry has recorded 5 versions of this file, between Oct 10, 2026 and Oct 27, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
v1.9.1 latest2026-10-27 6191961 23,387 BA view · diff
v1.9.02026-10-12 bad2d40 22,521 BA view · diff
v1.8.12026-10-12 1ab0b92 22,165 BA view · diff
git:20261010.faa33b52026-10-10 faa33b5 22,123 BA view · diff
git:20261010.2adc8d82026-10-10 2adc8d8 21,891 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 (23387 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

sentimony/skills · 6 stars · license MIT · pushed 2026-10-27 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mam3dtqhx56gbgcc
GET https://markdownregistry.com/api/v1/resolve?ref=sentimony/skills/maintaining-agent-context
GET https://markdownregistry.com/api/v1/blob/3a59b11b78bfea92083361cda2a50ef1039314e2f004b8c18b138f4e0f1deb16

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 sentimony/skills

AGENTS.md AGENTS.md file
sentimony/skills · AGENTS.md
git:20261027.c57ded4 · audit A · 6 stars
CLAUDE.md CLAUDE.md file
sentimony/skills · CLAUDE.md
git:20260705.8649428 · audit B · 6 stars
branch-finish SKILL.md skill
sentimony/skills · plugins/skills/skills/branch-finish/SKILL.md · You MUST use this when verified development work is ready for an integration or handoff decision - merging, pushing…
v1.1.6 · audit A · 6 stars
commit-all SKILL.md skill
sentimony/skills · plugins/skills/skills/commit-all/SKILL.md · You MUST use this when the user asks to commit all current changes at once, via /commit-all or in words ("commit…
v1.4.4 · audit A · 6 stars
cross-review SKILL.md skill
sentimony/skills · plugins/skills/skills/cross-review/SKILL.md · You MUST use this when an implementation plan or a finished implementation needs an independent review by other agent…
v1.4.2 · audit A · 6 stars
dashfix SKILL.md skill
sentimony/skills · plugins/skills/skills/dashfix/SKILL.md · You MUST use this when writing or substantively editing prose in a project (docs, READMEs, UI copy) and when asked to…
v2.2.3 · audit A · 6 stars
debugging SKILL.md skill
sentimony/skills · plugins/skills/skills/debugging/SKILL.md · You MUST use this when investigating bugs, regressions, failing tests, build or integration failures, flaky behavior…
v1.1.2 · audit A · 6 stars
echarts SKILL.md skill
sentimony/skills · plugins/skills/skills/echarts/SKILL.md · You MUST use this when building, styling, debugging, or optimizing Apache ECharts charts in JavaScript, React, or Vue -…
v1.3.1 · audit A · 6 stars
frontend-crafting SKILL.md skill
sentimony/skills · plugins/skills/skills/frontend-crafting/SKILL.md · You MUST use this when building, implementing, redesigning, reviewing, or refining user-facing interfaces - including…
v1.5.0 · audit A · 6 stars
gh-switch SKILL.md skill
sentimony/skills · plugins/skills/skills/gh-switch/SKILL.md · You MUST use this when a project-scoped GitHub CLI (gh) command is about to run on github.com, including every…
v1.1.6 · audit B · 6 stars
git-worktree-isolation SKILL.md skill
sentimony/skills · plugins/skills/skills/git-worktree-isolation/SKILL.md · You MUST use this when deciding whether development work needs workspace isolation - before implementing plans, risky…
v1.3.2 · audit A · 6 stars
inline-plan-dev SKILL.md skill
sentimony/skills · plugins/skills/skills/inline-plan-dev/SKILL.md · You MUST use this when executing an existing implementation plan directly in the current agent session, including…
v1.3.4 · audit A · 6 stars

Every file in sentimony/skills

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