---
name: AGENTS Md Generator
slug: agents-md-generator
category: Writing
description: AGENTS Md Generator creates AGENTS.md files for Java repositories through a step-based interactive process. Use it to document conventions, commands, workflow, and contributor boundaries for agent instructions.
github: "https://github.com/majiayu000/claude-skill-registry/tree/main/skills/agent/200-agents-md"
language: HTML
stars: 575
forks: 88
install: "npx degit https://github.com/majiayu000/claude-skill-registry/tree/main/skills/agent/200-agents-md ~/.claude/skills/200-agents-md"
installs_to: ~/.claude/skills/200-agents-md
source_path: skills/agent/200-agents-md/SKILL.md
collection_size: 23
category_size: 1012
collection_url: "https://dirskills.com/collections/majiayu000/claude-skill-registry"
added: 2026-08-25T05:14:06.453Z
last_synced: 2026-08-25T05:14:06.453Z
canonical_url: "https://dirskills.com/skills/agents-md-generator"
---

# AGENTS Md Generator

AGENTS Md Generator creates AGENTS.md files for Java repositories through a step-based interactive process. Use it to document conventions, commands, workflow, and contributor boundaries for agent instructions.

**Install:**

```bash
npx degit https://github.com/majiayu000/claude-skill-registry/tree/main/skills/agent/200-agents-md ~/.claude/skills/200-agents-md
```

## README

# AGENTS.md Generator for Java repositories

Generate a comprehensive AGENTS.md file for Java repositories through a modular, step-based interactive process that covers role definition, tech stack, file structure, commands, Git workflow, and contributor boundaries. **This is an interactive SKILL**.

**What is covered in this Skill?**

- AGENTS.md generation for Java repositories of any complexity
- Role and expertise definition for AI agents and contributors
- Tech stack documentation: language, build tool, frameworks, pipelines
- File structure mapping with read/write boundaries
- Command catalogue for build/test/deploy/run workflows
- Git workflow conventions: branching strategy, commit message format
- Contributor boundaries using ✅ Always do / ⚠️ Ask first / 🚫 Never do formatting

## Constraints

No Maven validation is required before generating AGENTS.md. Review the project structure and existing documentation before starting to provide accurate answers during Step 1.

- **BEFORE STARTING**: Review the project structure and existing documentation to provide accurate answers during Step 1
- **BEFORE APPLYING**: Read the reference for detailed good/bad examples, constraints, and safeguards for each AGENTS.md generation pattern
- **EDGE CASE**: If the user goal is ambiguous, stop and ask a clarifying question before editing files or running project-wide commands
- **EDGE CASE**: If required context, files, credentials, or tools are missing, report the blocker explicitly and ask whether to proceed with setup or fallback guidance
- **EDGE CASE**: If requested changes conflict with project constraints or safety boundaries, explain the conflict and ask for user confirmation on the preferred trade-off

## When to use this skill

- Create AGENTS.md
- Update AGENTS.md file
- Add agent instructions

## Workflow

1. **Review repository context before drafting**

Inspect project structure and existing documentation to prepare accurate responses for the AGENTS.md discovery phase.

2. **Read AGENTS generation reference**

Read `references/200-agents-md.md` and follow its generation patterns and safeguards.

3. **Run interactive requirements capture**

Gather role, tech stack, commands, workflow, and boundaries in a modular step-based conversation.

4. **Generate AGENTS.md artifact**

Create AGENTS.md with ✅ Always do / ⚠️ Ask first / 🚫 Never do boundaries and repository-specific conventions.

## Reference

For detailed guidance, examples, and constraints, see [references/200-agents-md.md](references/200-agents-md.md).