optimize-agent-context SKILL.md skillA

optimize-agent-context from j-star-films-studios/vibecode-protocol-suite is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add j-star-films-studios/vibecode-protocol-suite/optimize-agent-context@git:20260820.4dbe9e4

Pins git:20260820.4dbe9e4 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
j-star-films-studios/vibecode-protocol-suite
Path
assets/.agent/skills/agent-engineering/optimize-agent-context/SKILL.md
Versions recorded
1
Latest version
git:20260820.4dbe9e4, committed Aug 20, 2026
Size
4,700 bytes
Repository stars
26
License
ISC

Create, audit, or optimize agent.md, claude.md, cursorrules, or any AI coding agent context file using the "Band-Aid Philosophy." Strips bloat, enforces minimalism, and ensures only failure-correcting rules remain. Use when the user mentions: "agent.md", "claude.md", "cursorrules", ".clinerules", "AGENTS.md", "context file", "optimize context", "agent instructions", "reduce agent bloat", "agent keeps making mistakes", "fix my agent file", "create agent file", "audit agent context", or any…

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

# Optimize Agent Context

Enforce the **Band-Aid Philosophy**: an agent context file should only contain rules that fix mistakes the agent is actively making. Everything else is bloat that degrades performance and increases cost.

## Core Rules (Non-Negotiable)

1. **NO BLOAT** — Never include directory structures, file trees, dependency lists, or package inventories. The agent has tools to discover these.
2. **NO SUMMARIES** — Never include vague app descriptions ("This is a video sharing app"). This distracts the model and triggers hallucinations.
3. **ONLY FIX KNOWN FAILURES** — Every line must correct a specific, observed agent mistake or enforce an architectural constraint the agent cannot guess.
4. **USE NEGATIVE CONSTRAINTS** — When the agent uses the wrong tool/library, explicitly state what NOT to use, then what TO use.
5. **BE MINIMAL** — Target under 20 lines. Bullet points preferred. If a rule can be removed without the agent breaking, remove it.

## Why This Matters

Studies show bloated, AI-generated context files:
- **Degrade agent performance by ~3%**
- **Increase token costs by 20%+**
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add j-star-films-studios/vibecode-protocol-suite/optimize-agent-context@sha256:80b1c8c74214fa7f

The line at the top of this page pins the label git:20260820.4dbe9e4, 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_lhbwwqy2wpn5pqbq.svg)](https://markdownregistry.com/a/art_lhbwwqy2wpn5pqbq)

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

Versions

The registry has recorded 1 version of this file, committed on Aug 20, 2026.

versioncommittedcommitsizeaudit
git:20260820.4dbe9e4 latest2026-08-20 4dbe9e4 4,700 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 (4700 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

j-star-films-studios/vibecode-protocol-suite · 26 stars · license ISC · pushed 2026-10-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_lhbwwqy2wpn5pqbq
GET https://markdownregistry.com/api/v1/resolve?ref=j-star-films-studios/vibecode-protocol-suite/optimize-agent-context
GET https://markdownregistry.com/api/v1/blob/80b1c8c74214fa7fba3265c9fbdaebf28d50084326c525a19bc59b5d3e30e176

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 j-star-films-studios/vibecode-protocol-suite

skill-curator SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · .agents/skill-curator/SKILL.md · Use when adding, importing, reorganizing, renaming, or refactoring skills according to the Lean Unified Skills…
v1.0.0 · audit A · 26 stars
unslop SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · .agents/skills/unslop/SKILL.md · Use when writing any text, chat responses, documentation, UI copy, or skill instructions. Cuts AI tells, filler, and…
v1.0.0 · audit A · 26 stars
AGENTS.md AGENTS.md file
j-star-films-studios/vibecode-protocol-suite · AGENTS.md
git:20260926.7aeecb2 · audit A · 26 stars
AGENTS.md@assets/.agent/skills AGENTS.md file
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/AGENTS.md
git:20260912.a111be5 · audit A · 26 stars
agent-engineering SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/SKILL.md · Use when engineering LLM prompts, compiling skills from sources ('source-to-skill'), engineering expert systems…
v2.1.0 · audit A · 26 stars
arena SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/arena/SKILL.md · Spawn N parallel candidates at the same task, pick a base, graft the strongest parts of the losers into it. Use for…
git:20260821.1b830a3 · audit A · 26 stars
automate-me SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/automate-me/SKILL.md · Use for "automate me", "create/update/refresh my -mode skill", "turn/capture my preferences or working style into a…
git:20260821.1b830a3 · audit A · 26 stars
codex-control SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/codex-control/SKILL.md · Use when Pi needs to delegate browser, desktop, or native-plugin tasks to the installed Codex CLI.
v1.0.0 · audit A · 26 stars
to-spec SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/conversation-to-spec/SKILL.md · Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of…
git:20260821.1b830a3 · audit A · 26 stars
crafting-effective-readmes SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/crafting-effective-readmes/SKILL.md · Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to…
git:20260820.4dbe9e4 · audit A · 26 stars
create-verification-skill SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/create-verification-skill/SKILL.md · Generate a project-local verification skill that drives your app the way a user does — any language, framework, or…
git:20260821.1b830a3 · audit A · 26 stars
domain-modeling SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/domain-modeling/SKILL.md · Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md…
git:20260821.1b830a3 · audit A · 26 stars

Every file in j-star-films-studios/vibecode-protocol-suite

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