Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Optimize AGENTS.md · majiayu000 | DecimalAI

agent toolingby majiayu000

Optimize AGENTS.md

majiayu000/optimize-agents-md

Source majiayu000/claude-skill-registry ↗License MIT

Optimize AGENTS.md and rules for token efficiency. Auto-invoked when user asks about improving agent instructions, compressing AGENTS.md, or making rules more effective.

SkillScore82Maintained

Automatic

AI Engineer pack

Last verified 9/2/2026

What it changes

Passed 15 of 18 test cases with the skill, and 7 of 18 without it.

Without skill36%

With skill82%

Checks it passed that the model alone missed

Formats the anti-patterns into a markdown table.
Includes a *Verify:* line with a grep check command.
Places the entry under a ## Learnings section header.

and 14 more in the full report

10 fixed8 passed either way4 still failing0 broke

Pass-rate lift: +45 pp
Tokens: +25%
Agent turns: 0%
Response time: -35%

Model gemini-3.6-flashMeasured 9/2/2026v118 of 22 cases passed with skill · 18 comparable

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/majiayu000-optimize-agents-md/SKILL.md https://app.decimal.ai/s/majiayu000-optimize-agents-md/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add majiayu000-optimize-agents-md, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/majiayu000-optimize-agents-md/ and pins it in .decimal/skills.lock

decimalai skills add majiayu000-optimize-agents-md

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/majiayu000-optimize-agents-md/SKILL.md https://app.decimal.ai/s/majiayu000-optimize-agents-md/SKILL.md

Raw file: /s/majiayu000-optimize-agents-md/SKILL.md ↗ · machine-readable summary at /s/majiayu000-optimize-agents-md.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 9 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 9

Prompt

We have a wordy coding guideline explaining that our team prefers TypeScript type aliases rather than interface definitions for better consistency with union types. Convert this prose rule into a compressed entry for an AGENTS.md rule list.

What was checked, without and with the skill
Checked	Without skill	With skill
Formats the rule with an italicized Verify: line containing a grep check command.	Missed	Passed
Formats the rule with an italicized Fix: line specifying the code transformation.	Missed	Passed

case-04 · gemini-3.6-flash · 9/2/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md181 linessingle file

Optimize AGENTS.md

Apply Boris Cherny's compression principles to AGENTS.md and rules files.

Target: ~2.5k tokens (most are 10k+ unnecessarily)

When to Use

User wants to improve their AGENTS.md or CLAUDE.md
Agent instructions feel verbose or redundant
Rules exist but lack verification patterns
Setting up a new project's agent configuration

Anti-Patterns to Fix

Anti-Pattern	Problem	Fix
Context stuffing	Repeating info agents already know	Delete obvious instructions
Static memory	No learnings section	Add `## Learnings` with dates
Format drift	Inconsistent structure	Use consistent headers
Missing verification	No way to check work	Add `Verify:` patterns to rules
Verbose rules	Paragraphs instead of patterns	Compress to pattern + verify + fix

Workflow

Phase 1: Analyze Current State

# Count tokens (rough estimate: words × 1.3)
wc -w AGENTS.md

# Find redundancy with project files
grep -l "bun test" AGENTS.md package.json

Look for:

Instructions duplicating package.json scripts
Explanations of common tools (git, npm, bun)
Verbose descriptions that could be tables
Rules without verification patterns

Track record

Benchmark

15 / 18

test cases passed, vs 7 / 18 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/10/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

majiayu000 / claude-skill-registry

skills/agent/optimize-agents-md-plaited-development-skills/SKILL.md

View on GitHub ↗

License ISCImported 8/10/2026Version v1

Other skills for the same job

Published skills whose descriptions closely match this one, with their headline benchmark lift.

majiayu000/agents-md-proCreate, optimize, update, and validate AGENTS.md files with maximum token efficiency. Use when the user asks to (1) create new AGENTS.md files for any repository, (2) optimize/condense existing AGENTS.md to reduce token count, (3) update/refresh AGENTS.md to sync with codebase changes, (4) validate AGENTS.md quality and completeness, or (5) improve AGENTS.md files to be more effective for AI agents. Always generates token-efficient, condensed output focused on actionable commands and patterns whClose match+41 pp pass-rate lift

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

Optimize AGENTS.md

When to Use

Anti-Patterns to Fix

Workflow

Phase 1: Analyze Current State

Track record

Benchmark

Adoption

SkillSafety

Source

Other skills for the same job

Related skills