optimize-agents-md

Compress AGENTS.md files into concise, verifiable guidelines with Learnings and Fix sections.

5|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/youdotcom-oss/web-search-agent-evals --skill optimize-agents-md-youdotcom-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: optimize-agents-md
Source: https://github.com/youdotcom-oss/web-search-agent-evals/tree/main/.plaited/skills/optimize-agents-md%40plaited_development-skills
Command: npx skills add https://github.com/youdotcom-oss/web-search-agent-evals --skill optimize-agents-md-youdotcom-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Compress AGENTS.md and rules to improve token efficiency.

Core Features & Use Cases

  • Structured compression of long AGENTS.md into concise, verifiable guidelines
  • Introduction of a reusable rules pattern with Verify and Fix sections
  • Adds a living Learnings section to capture changes and issues over time

Quick Start

Run the compression workflow on AGENTS.md to generate a concise, verifiable document.

Frequently Asked Questions about optimize-agents-md

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compress AGENTS.md to reduce token usage?

Compress AGENTS.md by applying a structured skeleton that consolidates verbose rules into concise guidelines, reducing token usage while retaining essential project guidance.

What is the best way to structure verification patterns in AGENTS.md?

Structure verification patterns in AGENTS.md by using reusable rules with distinct Verify and Fix sections, ensuring guidelines remain testable and actionable after compression.

How do I maintain a living document for AGENTS.md learnings over time?

Maintain a living document for AGENTS.md by introducing a Learnings log section, capturing ongoing project changes and issues to keep the compressed guidelines current.

Can I optimize documentation-heavy projects without losing essential rules?

Yes, you can optimize documentation-heavy projects by enforcing a compact structure overview that preserves essential guidance while eliminating redundant tokens from the AGENTS.md file.

Does AGENTS.md compression work for projects needing verifiable guidelines?

AGENTS.md compression works for verifiable guidelines by applying a pattern-based rules section with explicit Verify and Fix blocks, supporting repeatable optimization across the project.