Use when you need to generate an AGENTS.md file for a Java repository — covering project conventions, tech stack, file structure, commands, Git workflow, and contributor boundaries — through a modular, step-based interactive process that adapts to your specific project needs. This should trigger for requests such as Create AGENTS.md; Update AGENTS.md file; Add agent instructions; Generate contributor instructions for Java agents; Document repository conventions in AGENTS.md. Part of Plinth Toolk
SkillScore83Maintained
Automatic
◆Doc Ops pack
Last verified 8/20/2026
What it changes
Passed 17 of 21 test cases with the skill, and 11 of 21 without it.
Without skill50%
With skill83%
Checks it passed that the model alone missed
Refers to references/200-agents-md.md.
Reports the missing docker setup explicitly as a blocker.
Asks whether to proceed with setup or use fallback guidance.
and 8 more in the full report
9 fixed11 passed either way3 still failing1 broke
Pass-rate lift
+33 pp
Tokens
-24%
Agent turns
0%
Response time
-52%
Model gemini-3.6-flashMeasured 8/20/2026v120 of 24 cases passed with skill · 21 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 7 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 7
Prompt
Which internal reference document contains the generation patterns and safeguards to follow during AGENTS.md creation?
What was checked, without and with the skill
Checked
Without skill
With skill
Refers to references/200-agents-md.md.
Missed
Passed
case-18 · gemini-3.6-flash · 8/20/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md53 lines2 files
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
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
Generate contributor instructions for Java agents
Document repository conventions in AGENTS.md
Workflow
Review repository context before drafting
Inspect project structure and existing documentation to prepare accurate responses for the AGENTS.md discovery phase.
Use when you need to design, review, or improve REST APIs with Spring Boot — including HTTP methods, resource URIs, status codes, DTOs, versioning, deprecation and sunset headers, content negotiation (JSON and vendor media types), ISO-8601 instants in DTOs, pagination/sorting/filtering, Bean Validation at the boundary, idempotency, ETag concurrency, HTTP caching, error handling, security, contract-first OpenAPI (OpenAPI Generator), controller advice, and problem details for errors. This should t