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.