Generates a robust AGENTS.md file designed specifically for AI coding agents. This file acts as a "README for machines," providing them with the exact project context, rules, and instructions they need to work effectively.
Features
Project Metadata Extraction: Automatically parses pyproject.toml for project name, description, and scripts.
Dynamic File Tree: Generates a text-based tree view of the project structure, ignoring common noise directories (.git, __pycache__, etc.).
Mermaid Diagrams: Includes standardized Architecture and Workflow diagrams to help agents understand the system's design.
Battle-Tested Template: Uses a structure optimized for high agent performance, including "Always/Ask first/Never" boundaries.
Usage
Run the generator script with the path to your project root:
1---2name: knuckles-team-universal-skills-agents-md-generator3description: AGENTS.md Generator4---56# AGENTS.md Generator78Generates a robust `AGENTS.md` file designed specifically for AI coding agents. This file acts as a "README for machines," providing them with the exact project context, rules, and instructions they need to work effectively.910## Features11- **Project Metadata Extraction**: Automatically parses `pyproject.toml` for project name, description, and scripts.12- **Dynamic File Tree**: Generates a text-based tree view of the project structure, ignoring common noise directories (`.git`, `__pycache__`, etc.).13- **Mermaid Diagrams**: Includes standardized Architecture and Workflow diagrams to help agents understand the system's design.14- **Battle-Tested Template**: Uses a structure optimized for high agent performance, including "Always/Ask first/Never" boundaries.1516## Usage1718Run the generator script with the path to your project root:1920```bash21python scripts/generate_agents_md.py <project-path>22```2324### Options25- `<project-path>`: (Required) Path to the root directory of the project to document.2627## AGENTS.md Standard2829The generated `AGENTS.md` follows the emerging open standard for AI agent documentation:301. **Tech Stack & Architecture**: High-level overview of technologies and component interactions.312. **Commands**: Exact, file-scoped commands for building, testing, and linting.323. **Project Structure**: Quick reference to key files and the dynamic tree view.334. **Code Style & Conventions**: Specific "Always" rules with concrete Good/Bad code examples.345. **Dos and Don'ts**: Specific behavioral guidelines.356. **Safety & Boundaries**: Explicit "Always do", "Ask first", and "Never do" constraints.367. **When Stuck**: Instructions on how to handle ambiguity (e.g., "propose a plan first").3738---39> Source: [Knuckles-Team/universal-skills](https://github.com/Knuckles-Team/universal-skills) — distributed by [TomeVault](https://tomevault.io).40<!-- tomevault:4.0:skill_md:2026-06-16 -->
Run npx skillmds@latest add tomevault-io/knuckles-team-universal-skills-agents-md-generator in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
AGENTS.md Generator It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io