SkillsAdd

jabrena/plinth

200-agents-md

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 Tool…

First seen Mar 17, 2026

Installation

$ npx skills add jabrena/plinth --skill 200-agents-md
View on skills.sh ↗ GitHub repository ↗

Summary

  • 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 Toolkit

Also in this package

Other skills from jabrena/plinth · top by installs.

npx skills add jabrena/plinth
110-java-maven-best-practices 6 121-java-object-oriented-design 378 124-java-secure-coding 369 131-java-testing-unit-testing 357 141-java-refactoring-with-modern-features 337 122-java-type-design 318 302-frameworks-spring-boot-rest 317 125-java-concurrency 316 111-java-maven-dependencies 315 321-frameworks-spring-boot-testing-unit-tests 6

Browse all from jabrena/plinth

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 437
License LICENSE
Default branch main
Open issues 22
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.18.0
LicenseApache-2.0
More metadata
author
Juan Antonio Breña Moral
version
0.18.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,297 B
  • docs SUMMARY.md 524 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 266 installs

SKILL.md

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
  • Generate contributor instructions for Java agents
  • Document repository conventions in AGENTS.md

Workflow

  1. Review repository context before drafting

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

  1. Read AGENTS generation reference

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

  1. Run interactive requirements capture

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

  1. 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).