init-agents-md
init-agents-md
Analyze the repository and write (or overwrite) an AGENTS.md file in the project
root. The file is a concise, prescriptive orientation guide for AI coding agents.
It must not duplicate README.md — link there for anything already covered.
Workflow
- Read
README.md,pyproject.toml/package.json/ equivalent manifest, and any existing config files to infer the tech stack and tooling. - Identify the environment manager, test runner, linter, and build tool in use.
- Write
AGENTS.mdfollowing the structure below. - Aim for under 80 lines total.
Required sections
1. What This Project Does (2–4 sentences)
State the project's purpose and technology stack category. Add a pointer to
More from ak1ra-komj/agents-skills
summarize-current-session
Use when the user asks to summarize this session, write a session log, save what we did today, or similar.
20developing-ansible
Use when writing, reviewing, or refactoring Ansible playbooks, roles, or tasks.
15developing-bash-scripts
Use when writing, reviewing, or refactoring a Bash script.
14developing-posix-shell-scripts
Use when writing, reviewing, or refactoring a POSIX shell script (/bin/sh), or when targeting Alpine, BusyBox, or any environment where Bash cannot be assumed.
13keep-a-changelog
Use when the user mentions preparing or publishing a new release, or asks to review or refactor CHANGELOG.md, following Keep a Changelog format and Semantic Versioning.
9update-changelog-md
Maintains CHANGELOG.md following Keep a Changelog format and Semantic Versioning. Covers adding new version entries from git history and restructuring existing content.
6