agentsmd-generator

Generate standardized AGENTS.md guides from repository analysis.

3|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/asteroid-belt/skills --skill agentsmd-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentsmd-generator
Source: https://github.com/asteroid-belt/skills/tree/main/skills/agentsmd-generator
Command: npx skills add https://github.com/asteroid-belt/skills --skill agentsmd-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate standardized AGENTS.md onboarding guides to codify repository conventions, workflows, and follow-up tasks, reducing onboarding time and ambiguity.

Core Features & Use Cases

  • Phase-driven discovery: inventory project structure, capture a git-aware tree, and surface automation entry points (prefer just/make tasks) for consistent onboarding.
  • Structured AGENTS.md generation: output a formatted guide with sections for Quick Facts, Repository Tour, Tooling & Setup, Common Tasks, Testing & Quality, Workflow Expectations, and Documentation Duties.
  • Per-directory guidance (when approved): optionally provide scoped notes for nested areas to avoid guidance duplication and align with parent inheritance.

Quick Start

Run the agentsmd-generator on the repository to produce a complete AGENTS.md draft following the Phase 1–3 workflow.

Frequently Asked Questions about agentsmd-generator

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

FAQPage Schema
How do I generate an AGENTS.md onboarding guide for my repository?

An AGENTS.md guide provides standardized, agent-facing documentation covering repository structure, tooling setup, testing, workflow expectations, and hand-off tasks to reduce onboarding time and ambiguity for new contributors.

Can I create scoped AGENTS.md guides for specific directories within a project?

The generator outputs a complete AGENTS.md draft featuring sections for Quick Facts, Repository Tour, Tooling & Setup, Common Tasks, Testing & Quality, Workflow Expectations, and Documentation Duties, along with a recommended update cadence.

Do I need specific build tools to automate repository documentation generation?

The generator supports any repository needing clear agent-facing documentation and applies phase-driven discovery to standardize conventions, workflows, and follow-up tasks without specific scale or platform constraints.

What is the best way to document repository conventions and workflows for onboarding?

For repositories with complex nested structures, use per-directory guidance to avoid documentation duplication and align with parent inheritance rules, ensuring localized notes remain consistent with the broader project scope.