update-agents-md

Generate minimal root AGENTS.md files with domain-specific hierarchical documentation.

7|Updated Sep 27, 2022
One-click install
npx skills add https://github.com/vieitesss/.mac_config --skill update-agents-md
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-agents-md
Source: https://github.com/vieitesss/.mac_config/tree/main/agents/skills/update-agents-md
Command: npx skills add https://github.com/vieitesss/.mac_config --skill update-agents-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams craft concise AGENTS.md guidance that minimizes root content while providing scalable, domain-specific documentation structures.

Core Features & Use Cases

  • Analyze existing AGENTS.md files or create new ones from scratch using progressive disclosure principles.
  • Organize content into a hierarchical structure with a minimal root and domain-specific guidance.
  • Validate and propose a reusable file structure that avoids stale or irrelevant instructions.

Quick Start

Provide project context and I will generate a minimal root AGENTS.md plus domain-specific docs.

Frequently Asked Questions about update-agents-md

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

FAQPage Schema
What is progressive disclosure for AGENTS.md documentation?▼

Progressive disclosure for AGENTS.md minimizes root content while providing domain-specific structure for hierarchical documentation. It organizes guidance into a minimal root plus domain-specific docs, avoiding stale or irrelevant instructions.

How do I structure AGENTS.md for a monorepo or multi-package setup?▼

Structure AGENTS.md for monorepos by generating a minimal root file plus domain-specific docs. This hierarchical approach provides domain concepts and actionable guidelines without embedding file paths directly in the root.

Can I refactor existing AGENTS.md files or do I need to create them from scratch?▼

You can refactor existing AGENTS.md files or create new ones from scratch. The process analyzes current content and reorganizes it into a scalable, hierarchical structure using progressive disclosure principles.

What's the best way to organize agent guidelines without embedding file paths?▼

Organize agent guidelines by focusing on domain concepts and actionable guidelines rather than embedding file paths. This approach produces a reusable file structure that avoids stale or irrelevant instructions across your project.

Why does my AGENTS.md root file contain stale or irrelevant instructions?▼

Your AGENTS.md root likely contains stale instructions because it lacks a hierarchical, domain-specific structure. Refactoring with progressive disclosure principles minimizes root content and distributes guidance into domain docs.

When do I need hierarchical documentation for agents?▼

You need hierarchical documentation for agents when working across monorepos or multi-package setups. A minimal root plus domain-specific docs ensures scalable, reusable structure that avoids embedding file paths and stale instructions.