AGENTS.md Generator

Produce a small instruction layer containing verified project facts that materially change agent behavior. General engineering knowledge belongs outside always-loaded instructions.

Delegation

Run in the main conversation by default. Delegation can increase usage: obtain explicit approval for the proposed agent count and scope before using subagents. Reuse that approval within its bounds; ask again before expanding the approved count or scope.

Discover the instruction chain

Inspect existing instructions, their ownership, scopes, and symlinks before editing. Preserve a working shared source such as AGENTS.md pointing to CLAUDE.md; do not replace it solely to impose a preferred filename. Add compatibility files only when the requested tool support needs them. Keep global user configuration outside a repository-instruction task.

For an unfamiliar or multi-tool repository, the bundled detector can locate instruction paths and declared framework/tool signals:

"<skill-directory>/scripts/detect-agent-context" --root "<repository-root>" --format json

On Windows use scripts/detect-agent-context.cmd with the same arguments. Python provides JSON; native Bash/PowerShell fallbacks emit a smaller text report. Resolve scripts relative to this skill, not the target project. Direct file inspection is sufficient for a known, narrow edit.