AGENTS.md Generator Skill

Generate and maintain AGENTS.md files following the public agents.md convention.

AGENTS.md is FOR AGENTS, not humans. Human readability is a convenient side effect, not a design goal. Every section, format choice, and word exists to maximize AI coding agent efficiency. If something helps humans but wastes agent tokens, remove it.

Spec Compliance: This skill follows the official agents.md specification which has no required fields - all sections are recommendations based on best practices from 2,500+ repositories.

Language Choice

Default to English - AI coding agents perform best with English instructions because:

• Programming keywords, libraries, and error messages are English
• Zero "semantic friction" between instruction and code (Create user → createUser)
• Most token-efficient encoding for technical instructions

Exception: Match your code's naming language. If your codebase uses non-English naming conventions (e.g., German class names like Rechnungssteller, French variables like id_client), write AGENTS.md in that language to prevent "naming hallucinations" where agents mix languages.

Rule: The language of AGENTS.md must match the language used for domain naming in the code.