Agentic Readiness
CodeAlive-AI/ai-driven-development
Audit and improve repositories for reliable agentic work across Codex and Codex App, Claude Code, and OpenCode.
Create, generate, update, repair, trim, or split minimal AGENTS.md files for repository roots and confirmed nested modules using progressive disclosure.
Install Agents Md Generator
$ npx skills add MADTeacher/mad-agents-skills --skill agents-md-generator -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install MADTeacher/mad-agents-skills agents-md-generator --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/MADTeacher/mad-agents-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agents-md-generator .claude/skills/agents-md-generator && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "agents-md-generator" agent skill from https://github.com/MADTeacher/mad-agents-skills/tree/main/agents-md-generator into .claude/skills/agents-md-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-generator", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/MADTeacher/mad-agents-skills/tree/main/agents-md-generatorType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add MADTeacher/mad-agents-skills --skill agents-md-generator -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install MADTeacher/mad-agents-skills agents-md-generator --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/MADTeacher/mad-agents-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/agents-md-generator .agents/skills/agents-md-generator && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "agents-md-generator" agent skill from https://github.com/MADTeacher/mad-agents-skills/tree/main/agents-md-generator into .agents/skills/agents-md-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-generator", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add MADTeacher/mad-agents-skills --skill agents-md-generator -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install MADTeacher/mad-agents-skills agents-md-generator --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/MADTeacher/mad-agents-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/agents-md-generator .cursor/skills/agents-md-generator && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "agents-md-generator" agent skill from https://github.com/MADTeacher/mad-agents-skills/tree/main/agents-md-generator into .cursor/skills/agents-md-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-generator", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/MADTeacher/mad-agents-skills.git --path agents-md-generator--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add MADTeacher/mad-agents-skills --skill agents-md-generator -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install MADTeacher/mad-agents-skills agents-md-generator --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/MADTeacher/mad-agents-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/agents-md-generator .gemini/skills/agents-md-generator && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "agents-md-generator" agent skill from https://github.com/MADTeacher/mad-agents-skills/tree/main/agents-md-generator into .gemini/skills/agents-md-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-generator", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install MADTeacher/mad-agents-skills agents-md-generatorInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add MADTeacher/mad-agents-skills --skill agents-md-generator -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/MADTeacher/mad-agents-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/agents-md-generator .github/skills/agents-md-generator && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "agents-md-generator" agent skill from https://github.com/MADTeacher/mad-agents-skills/tree/main/agents-md-generator into .github/skills/agents-md-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-generator", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add MADTeacher/mad-agents-skills --skill agents-md-generator -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install MADTeacher/mad-agents-skills agents-md-generator --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/MADTeacher/mad-agents-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/agents-md-generator .opencode/skills/agents-md-generator && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "agents-md-generator" agent skill from https://github.com/MADTeacher/mad-agents-skills/tree/main/agents-md-generator into .opencode/skills/agents-md-generator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agents-md-generator", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
agents-md-generator- GitHub stars
- 110
- Token cost
- ~1.4k tokens
- SKILL.md length
- 588 words
- Files
- 3 (incl. references)
- Skills in repo
- 11
- Repo updated
- First seen
- Licence
- MIT
At a glance
Create, generate, update, repair, trim, or split minimal AGENTS.md files for repository roots and confirmed nested modules using progressive disclosure.
- Works in 6 steps: Discover repository shape → Detect module boundaries → Generate/Update Root AGENTS.md → …
- Outdated agent instructions
- SKILL.md covers Goal, Skill location (agent-specific), Resource Routing and When to run, plus 4 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Agents Md Generator is an agent skill from MADTeacher/mad-agents-skills. Create, generate, update, repair, trim, or split minimal AGENTS.md files for repository roots and confirmed nested modules using progressive disclosure. Use for missing, bloated, contradictory, or outdated agent instructions, monorepos, services, packages, module context, and portable agent guidance without assuming any fixed agent folder structure.
Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/AGENTS_TEMPLATE_MODULE.md` and `references/AGENTS_TEMPLATE_ROOT.md`). Compatibility notes: Filesystem-based coding agents with read/write access. Script execution optional.
It sits in Agent Workflows, covering Agent instruction files, Monorepo tooling and File organization. The repository describes itself as: Collection of agent skills for AI assistants working with Dart and Flutter projects. The licence is MIT.
When your agent uses it
- Outdated agent instructions
- Portable agent guidance without assuming any fixed agent folder structure
Example prompts
- “/agents-md-generator”
Requirements
- Compatibility (from SKILL.md): Filesystem-based coding agents with read/write access. Script execution optional.
Workflow steps
6 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 2fb67e3. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Filesystem-based coding agents with read/write access. Script execution optional.
From compatibility in the SKILL.md frontmatter.
Context cost
Agents Md Generator loads about 1.4k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 93 tokens; SKILL.md has 588 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from MADTeacher/mad-agents-skills at commit 2fb67e3, republished under its MIT licence (© MADTeacher). 588 words, ~1,410 tokens.
Download SKILL.mdSave it as
.claude/skills/agents-md-generator/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- name
- agents-md-generator
- description
- Create, generate, update, repair, trim, or split minimal AGENTS.md files for repository roots and confirmed nested modules using progressive disclosure. Use for missing, bloated, contradictory, or outdated agent instructions, monorepos, services, packages, module context, and portable agent guidance without assuming any fixed agent folder structure.
- compatibility
- Filesystem-based coding agents with read/write access. Script execution optional.
- metadata.author
- Stanislav [MADTeacher] Chernyshev
- metadata.version
- 2.0
AGENTS.md Generator (Root + Nested, Portable)
Goal
Maintain small, high-signal AGENTS.md files:
- Root AGENTS.md — purpose of repository, navigation, universal toolchain, canonical commands, links to docs and skills.
- Nested AGENTS.md — module/package purpose, local commands, module references.
Use progressive disclosure: keep AGENTS.md concise; push details to docs or skills.
Skill location (agent-specific)
- Do NOT assume
.agents/or any fixed directory exists. - Skills may live:
- inside the repository (embedded),
- or in an external/global skill library (external).
- If referencing local skills, use only an existing skill root already used by the project or an existing project path already mentioned by repo docs.
- If no local skill directory exists — reference skills by name only (external).
- Never create hidden agent directories just to store skills.
Resource Routing
Use templates as skeletons, not literal output:
- Read
references/AGENTS_TEMPLATE_ROOT.mdonly when creating or updating the rootAGENTS.md. - Read
references/AGENTS_TEMPLATE_MODULE.mdonly after a directory is confirmed as a nested module that needs its ownAGENTS.md. - Replace or remove every placeholder. Final
AGENTS.mdfiles must not contain unresolved<...>template markers.
When to run
Run this skill when:
- AGENTS.md is missing, bloated, contradictory, or outdated.
- AGENTS.md needs to be generated, repaired, trimmed, split, or updated.
- A new package/service/module appears.
- Repository structure changes (monorepo growth or split).
- Teams want consistent agent context across diverse stacks.
Workflow (Deterministic)
1. Discover repository shape
- Identify repository root (git root if available).
- Detect language/tool markers:
package.json,pnpm-workspace.yamlgo.mod,go.workpyproject.tomlCargo.tomlpubspec.yamlpom.xml,build.gradle
- Locate
docs/,README.md, existingAGENTS.md.
2. Detect module boundaries
Create nested AGENTS.md if directory:
- Contains independent build/package manifest
- OR represents deployable/service unit (
apps/,services/,packages/) - AND adds distinct commands, docs, ownership, deployment notes, or toolchain guidance compared with parent scope.
Do not create a nested AGENTS.md that only repeats the root instructions.
3. Generate/Update Root AGENTS.md
Constraints:
- Ideal size: ≤ 60 lines
- Must include:
- One-sentence repository purpose
- Primary toolchain/package manager
- Canonical commands (if non-standard)
- Links to docs
- Instruction to read nested AGENTS.md when inside modules
- Optional skill references (adaptive: local or external)
- Preserve verified commands, docs, security/secrets/deployment warnings, and
important local rules from any existing root
AGENTS.md.
Show full SKILL.md (251 more words)Show less
4. Generate/Update Nested AGENTS.md
Constraints:
- Ideal size: ≤ 40 lines
- Must include:
- One-sentence module purpose
- Module-specific commands
- Local documentation references
- Optional skill references (adaptive)
- Preserve verified module warnings, ownership, deployment notes, and local
rules from any existing nested
AGENTS.md.
5. Progressive Disclosure Rules
- Do not embed style guides, CI policies, or architecture details.
- Prefer links to existing docs and external or local skills.
- Include only links that exist or are explicitly cited as the source for commands or policy.
- Replace stale long-form sections with links when an authoritative doc exists.
- Avoid “always/never” rules unless critical for correctness/security.
6. Safety / Correctness Gates
- Never invent commands.
- Infer commands from:
- package scripts
- Makefile
- CI configuration
- README
- If uncertain → write:
“Known commands: see
<existing file>” - Preserve critical warnings (security, secrets, deployment).
Output Contract
Create or update only:
<repo_root>/AGENTS.md<module_dir>/AGENTS.md
Do not create agent configuration folders.
Skill Referencing Strategy
When adding skill references inside AGENTS.md:
If local skill directory detected
See: <detected-skill-root>/<skill-name>/SKILL.mdIf no local directory exists
Skill: agents-md-generator (external)
Never assume filesystem paths.
Validation
Before finishing, verify:
- Only root/module
AGENTS.mdfiles were created or updated. - Final
AGENTS.mdfiles contain no unresolved<...>placeholders. - Relative documentation links exist or clearly point to a source file for commands/policy.
- Commands are supported by package scripts, Makefile, CI configuration, or
README. If no command is verified, use
Known commands: see <existing file>. - Line budgets are respected: root ≤ 60 lines, nested module ≤ 40 lines.
- Nested files exist only for confirmed module boundaries.
- Critical warnings from existing
AGENTS.mdfiles are preserved.
© MADTeacher, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 2 other files (references) in agents-md-generator of MADTeacher/mad-agents-skills.
- SKILL.md
- references/AGENTS_TEMPLATE_MODULE.md
- references/AGENTS_TEMPLATE_ROOT.md
Open the folder on GitHubat commit 2fb67e3
Compare with similar skills
Agents Md Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Agents Md Generator this skillMADTeacher/mad-agents-skills | 110 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Agentic ReadinessCodeAlive-AI/ai-driven-development | 159 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Sylph Create Skillgetnao/sylph | 213 | — | ~1.4k | Automated safety check: Pass | None | |
| Memory Md Managementgiuseppe-trisciuoglio/developer-kit | 357 | — | ~2.4k | Automated safety check: Notes | MIT | |
| Agents Generatorsickn33/agentic-awesome-skills | 47k | 1 repos | ~2.3k | Automated safety check: Notes | MIT | |
| Acreadiness Generate Instructionsgithub/awesome-copilot | 40k | 1 repos | ~2.1k | Automated safety check: Pass | MIT |
Similar skills
Sylph Create Skill
getnao/sylph
Create a new skill from scratch. An agent skill from getnao/sylph.
Memory Md Management
giuseppe-trisciuoglio/developer-kit
Provides comprehensive memory file management capabilities including auditing, quality assessment, and targeted improvements for files such as CLAUDE.md.
Agents Generator
sickn33/agentic-awesome-skills
Generate project-specific AGENTS.md and companion rules by analyzing a codebase.
- Official
Acreadiness Generate Instructions
github/awesome-copilot
Generate tailored AI agent instruction files via AgentRC instructions command.
Openiap Workflows
hyodotdev/openiap
A skill your agent uses for OpenIAP monorepo work that should follow the repository's shared agent workflows, including review-pr, audit-code, audit-security, audit-iapkit, compile-knowledge…
More from MADTeacher/mad-agents-skills
All 11 skills in this repoFlutter Internationalization
MADTeacher/mad-agents-skills
Add, fix, audit, and maintain Flutter internationalization with gen-l10n, ARB files, AppLocalizations, flutterlocalizations, intl formatting, plural/select messages, RTL support, locale-specific…
Flutter Networking
MADTeacher/mad-agents-skills
Implement, fix, debug, review, or refactor Flutter networking code for HTTP/REST APIs, WebSocket realtime flows, authentication and token refresh, request headers, timeouts, retries, JSON parsing…
Dart Drift
MADTeacher/mad-agents-skills
Build, fix, audit, and migrate Drift persistence in Dart CLI, server-side, and non-Flutter desktop apps.
Flutter Duit Bdui
MADTeacher/mad-agents-skills
Integrate, fix, review, migrate, test, or debug Duit / flutterduit backend-driven UI in Flutter applications.
Flutter Testing
MADTeacher/mad-agents-skills
Write, fix, review, debug, and validate Flutter tests for apps, packages, and plugins.
Flutter Adaptive UI
MADTeacher/mad-agents-skills
Build, fix, review, and validate adaptive or responsive Flutter UIs for mobile, tablet, desktop, web, large screens, foldables, and mixed input devices.
Related
Categories
Questions about Agents Md Generator
What does Agents Md Generator do?
Create, generate, update, repair, trim, or split minimal AGENTS.md files for repository roots and confirmed nested modules using progressive disclosure. Agents Md Generator is an agent skill from MADTeacher/mad-agents-skills.md files for repository roots and confirmed nested modules using progressive disclosure.
When should I use Agents Md Generator?
Agents Md Generator fits situations like: outdated agent instructions; portable agent guidance without assuming any fixed agent folder structure.
How do I install Agents Md Generator in Claude Code?
Run `npx skills add MADTeacher/mad-agents-skills --skill agents-md-generator -a claude-code`. Or copy the skill folder (agents-md-generator in MADTeacher/mad-agents-skills) into .claude/skills/agents-md-generator in your project. Claude Code loads it when a task matches its description.
How do I install Agents Md Generator in Codex?
Run `npx skills add MADTeacher/mad-agents-skills --skill agents-md-generator -a codex`. Or copy the skill folder (agents-md-generator in MADTeacher/mad-agents-skills) into .agents/skills/agents-md-generator in your project. Codex loads it when a task matches its description.
Can I use Agents Md Generator in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MADTeacher/mad-agents-skills --skill agents-md-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agents-md-generator, .gemini/skills/agents-md-generator, .github/skills/agents-md-generator and .opencode/skills/agents-md-generator in your project.
What does Agents Md Generator need to run?
SKILL.md names no scripts, command-line tools or credentials: Agents Md Generator is instructions for the agent only. Compatibility (from SKILL.md): Filesystem-based coding agents with read/write access. Script execution optional..
Does Agents Md Generator access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Agents Md Generator safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Agents Md Generator use?
Agents Md Generator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Agents Md Generator use?
About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 558 tokens, read only when the agent opens those files.
What are the alternatives to Agents Md Generator?
Skills that share tags, products or a category with Agents Md Generator: Agentic Readiness (CodeAlive-AI/ai-driven-development, 159 stars), Sylph Create Skill (getnao/sylph, 213 stars), Memory Md Management (giuseppe-trisciuoglio/developer-kit, 357 stars) and Agents Generator (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Agents Md Generator?
MADTeacher (a GitHub user) maintains it in MADTeacher/mad-agents-skills, which has 110 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on May 1, 2026.
Source: MADTeacher/mad-agents-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.