skills.rest
ryan-mahoney
ryan-mahoneyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

agents-update

Generate or update AGENTS.md files mapping repository architecture for coding agents.

Updated Mar 14, 2026
Search Tags:#architecture#documentation#onboarding#agents#monorepo#generate
One-click install
npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill agents-update
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agents-update
Source: https://github.com/ryan-mahoney/ryan-llm-skills/tree/main/skills/agents-update
Command: npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill agents-update

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate and maintain an AGENTS.md that provides a reliable, developer-focused map of a repository's architecture to help agents and human contributors navigate codebases confidently.

Core Features & Use Cases

  • Generate or update AGENTS.md to reflect current project structure, key entry points, and dependency insights.
  • Provide a concise directory map, architecture pattern guidance, and onboarding notes to reduce navigation errors.
  • Use Case: onboard a new developer to a large monorepo by presenting a ready-to-follow map of where code lives and how components interact.

Quick Start

Run the skill against the target repository to generate or update AGENTS.md at the repo root.

Frequently Asked Questions about agents-update

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

FAQPage Schema
How do I generate an architecture map for AI agents in a monorepo?▼

Generate an AGENTS.md file to create a developer-centric architecture map for agents. It scans the monorepo structure, key directories, and entry points, outputting a structured template covering tech stack, conventions, commands, and onboarding guidance.

What is an AGENTS.md file and how does it help with codebase onboarding?▼

An AGENTS.md file provides a comprehensive map of a repository's architecture for coding agents and human contributors. It reduces navigation errors by detailing the directory map, architecture pattern, project overview, and environment notes, accelerating onboarding.

Can I update existing repository documentation to reflect new project structure changes?▼

Yes, you can update existing AGENTS.md files by running the skill against the target repository. It regenerates the documentation to reflect the current project structure, key entry points, and dependency insights, ensuring contributors navigate the latest codebase confidently.

Does this architecture mapping approach work for both monorepos and single-repo projects?▼

Yes, this architecture mapping approach works for both monorepos and single-repo projects. It maps root-level structure and key directories like src, client, and db, enforcing a structured template with gotchas and environment notes regardless of repository scale.

What's the best way to document codebase conventions and gotchas for coding agents?▼

Document codebase conventions and gotchas by generating an AGENTS.md file. It enforces a structured template that includes specific sections for project conventions, commands, gotchas, and environment notes, reflecting the actual repository contents for reliable agent navigation.

Related Skills

Explore More Software Engineering Skills→
dEitY719dEitY719

dev-sh-generator

Generate executable tools/dev.sh scripts from AGENTS.md configuration requirements.

Community
Advanced
arielsandarielsand

architecture-map

Generate PROJECT_ARCHITECTURE.md documenting codebase structure, dependencies, and data flows.

Community
Advanced
magozmagoz
2

index-knowledge

Generate hierarchical AGENTS.md documentation with complexity-scored subdirectories.

Community
Advanced
Nick777-PixelNick777-Pixel

project-overview

Map repository architecture and module relationships across a monorepo.

Community
Intermediate