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.