agents-md

Generate, rewrite, and maintain AGENTS.md files for coding agents.

1|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/rarestg/rarestg-skills --skill agents-md-rarestg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-md
Source: https://github.com/rarestg/rarestg-skills/tree/main/skills/agents-md
Command: npx skills add https://github.com/rarestg/rarestg-skills --skill agents-md-rarestg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps create, update, and maintain a repository's AGENTS.md file, ensuring it acts as an effective dispatcher for coding agents by routing them to the correct sources of truth and documenting essential invariants.

Core Features & Use Cases

  • AGENTS.md Creation: Generates a concise AGENTS.md from scratch for new projects.
  • Maintenance & Updates: Rewrites or shrinks bloated AGENTS.md files, updates stale instructions, and ensures documentation remains current.
  • Repo Guidance: Adds essential repo guidance for AI/coding agents, documenting where to find source-of-truth docs, invariants, validation commands, and workflow rules.
  • Use Case: When onboarding a new AI agent to a complex codebase, use this Skill to generate or update AGENTS.md so the agent can quickly understand the project's structure, key documentation, and validation procedures.

Quick Start

Use the agents-md skill to create a new AGENTS.md file for this repository.

Frequently Asked Questions about agents-md

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

FAQPage Schema
How do I create an AGENTS.md file to onboard AI agents to my codebase?

To create an AGENTS.md file for AI agent onboarding, use this Skill to generate a concise dispatcher that routes coding agents to sources of truth, documents invariants, and defines validation rules. It builds the file from scratch based on your repository structure.

What is the best way to update stale agent documentation in a repository?

The best way to update stale agent documentation is rewriting the AGENTS.md file to shrink bloated instructions and ensure documentation remains current. This Skill rewrites and maintains the file to accurately reflect your codebase validation procedures and workflow rules.

How does an AGENTS.md file help navigate a complex codebase?

An AGENTS.md file helps navigate a complex codebase by acting as a concise dispatcher that routes coding agents directly to sources of truth. It documents essential invariants and validation commands, enabling quick agent onboarding and accurate project understanding.

Do I need to understand my repository structure to generate agent instructions?

Yes, you need to understand your repository structure and documentation best practices to generate agent instructions. The Skill requires this contextual knowledge to effectively route agents to the correct sources of truth and define appropriate validation rules.

What should I do when my AGENTS.md file becomes bloated with too many instructions?

When your AGENTS.md file becomes bloated with too many instructions, use this Skill to rewrite and shrink the file. It removes stale instructions and condenses the content to ensure the documentation remains a concise, effective dispatcher for coding agents.