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@v0.0.18

Pins v0.0.18 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
sentimony/skills
Path
skills/maintaining-agent-context/SKILL.md
Versions recorded
14
Latest version
v0.0.18, committed Nov 7, 2026
First version recorded
Aug 23, 2026
Size
24,044 bytes
Repository stars
7
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:aae3d5703bb66c50

The line at the top of this page pins the label v0.0.18, 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_jiiifi7bkfapuwpk.svg)](https://markdownregistry.com/a/art_jiiifi7bkfapuwpk)

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

Versions

The registry has recorded 14 versions of this file, between Aug 23, 2026 and Nov 7, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
v0.0.18 latest2026-11-07 e2d7cec 24,044 BA view · diff
v0.0.172026-11-04 6022530 23,567 BA view · diff
v0.0.162026-11-04 efb8f2a 23,388 BA view · diff
v1.9.12026-11-01 9838372 23,387 BA view · diff
git:20261010.8c8fc712026-10-10 8c8fc71 21,891 BA view · diff
v1.4.12026-10-05 53d0630 18,369 BA view · diff
v1.4.02026-10-05 83616f0 18,369 BA view · diff
v1.3.32026-10-01 832a9a8 17,549 BA view · diff
v1.3.22026-09-16 7451385 17,531 BA view · diff
v1.3.12026-09-14 14583c9 17,422 BA view · diff
v1.3.02026-09-08 fcc8791 16,860 BA view · diff
v1.2.02026-08-29 d9851b0 15,121 BA view · diff
v1.1.02026-08-25 bb015a8 12,715 BA view · diff
v1.0.02026-08-23 ca35743 11,027 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 (24044 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 · 7 stars · license MIT · pushed 2026-11-07 · branch main

API

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

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:20261107.e2d7cec · audit A · 7 stars
CLAUDE.md CLAUDE.md file
sentimony/skills · CLAUDE.md
git:20260705.8649428 · audit B · 7 stars
branch-finish SKILL.md skill
sentimony/skills · skills/branch-finish/SKILL.md · You MUST use this when verified development work is ready for an integration or handoff decision - merging, pushing…
v0.0.18 · audit A · 7 stars
commit-all SKILL.md skill
sentimony/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…
v0.0.15 · audit A · 7 stars
cross-review SKILL.md skill
sentimony/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…
v0.0.13 · audit A · 7 stars
dashfix SKILL.md skill
sentimony/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…
v0.0.17 · audit A · 7 stars
debugging SKILL.md skill
sentimony/skills · skills/debugging/SKILL.md · You MUST use this when investigating bugs, regressions, failing tests, build or integration failures, flaky behavior…
v0.0.18 · audit A · 7 stars
echarts SKILL.md skill
sentimony/skills · skills/echarts/SKILL.md · You MUST use this when building, styling, debugging, or optimizing Apache ECharts charts in JavaScript, React, or Vue -…
v0.0.18 · audit A · 7 stars
frontend-crafting SKILL.md skill
sentimony/skills · skills/frontend-crafting/SKILL.md · You MUST use this when building, implementing, redesigning, reviewing, or refining user-facing interfaces - including…
v0.0.14 · audit A · 7 stars
gh-switch SKILL.md skill
sentimony/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…
v0.0.11 · audit B · 7 stars
git-worktree-isolation SKILL.md skill
sentimony/skills · skills/git-worktree-isolation/SKILL.md · You MUST use this when deciding whether development work needs workspace isolation - before implementing plans, risky…
v0.0.12 · audit A · 7 stars
inline-plan-dev SKILL.md skill
sentimony/skills · skills/inline-plan-dev/SKILL.md · You MUST use this when executing an existing implementation plan directly in the current agent session, including…
v0.0.16 · audit A · 7 stars

Every file in sentimony/skills

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