skills.rest
ivanrvpereira
ivanrvpereiraCOMMUNITY
Explore all skills by this author →
𝕏@ivanrvpereiraGitHub

agents-md

Generate, review, and update AGENTS.md and CLAUDE.md instruction files.

17|Updated Feb 19, 2026
Search Tags:#documentation#CLAUDE.md#instruction design#review workflow#agents-md#repository configuration#AI coding agents
One-click install
npx skills add https://github.com/ivanrvpereira/.agents --skill agents-md-ivanrvpereira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agents-md
Source: https://github.com/ivanrvpereira/.agents/tree/main/skills/agents-md
Command: npx skills add https://github.com/ivanrvpereira/.agents --skill agents-md-ivanrvpereira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams quickly create, audit, and keep AI agent instruction files like AGENTS.md and CLAUDE.md accurate, consistent, and optimized for coding agents.

Core Features & Use Cases

  • Generate AGENTS.md/CLAUDE.md: Produce a root AGENTS.md (and an accompanying CLAUDE.md when appropriate) from repository analysis with tight, agent-usable structure.
  • Review existing instruction files: Audit an existing AGENTS.md for quality and correctness, then propose an improved rewrite or diff.
  • Update instruction files over time: Prune stale or discoverable content and incorporate changes that matter as the codebase evolves.

Quick Start

Use agents-md to review and rewrite your current AGENTS.md by pasting the file contents and telling the agent to run a full quality-gate review for accuracy and repository fit.

Frequently Asked Questions about agents-md

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

FAQPage Schema
How do I generate a CLAUDE.md file for my coding repository?▼

You can review an existing AGENTS.md by pasting its contents into the agent and instructing it to run a full quality-gate review for accuracy and repository fit, which proposes an improved rewrite or diff.

What is the best way to maintain AI coding agent instructions as a codebase evolves?▼

Generating CLAUDE.md instructions requires YAML frontmatter with name and description fields, disciplined structure and boundaries, and alignment with AGENTS.md files using specified generate, review, and update phases.

How do I audit an existing AGENTS.md file for AI agent quality?▼

Auditing an existing AGENTS.md file involves running a quality-gate review for accuracy and repository fit, which then proposes an improved rewrite or diff to optimize it for coding agents.

Do I need YAML frontmatter to create AI agent instruction files with agents-md?▼

Yes, generating AI agent instruction files with agents-md requires YAML frontmatter containing name and description fields, along with disciplined structure and boundaries for proper agent configuration.

Related Skills

Explore More Content & Communication Skills→
sscciossccio

deepinit

Generates hierarchical AGENTS.md documentation with preserved manual sections and validated parent links.

Community
Advanced
ZhanlinCuiZhanlinCui
178

doc-sync-tool

Synchronize Agents.md, claude.md, and gemini.md across nested project directories.

Community
Intermediate
kazhiramatsukazhiramatsu

agent-handoff

Create a canonical AGENTS.md file with compatible shims for multiple AI coding tools.

Community
Intermediate
MileniumTickMileniumTick

create-agentsmd

Generate AGENTS.md files at the repository root with templates and essential sections.

Community
Advanced