Files
PX4-Autopilot/.agents

Agent instructions

AGENTS.md files hold repository and directory guidance; .agents/skills/ holds the shared skills. Keep skills client-agnostic: no argument variables or client-specific attribution.

Claude Code reads neither location directly. Each CLAUDE.md is a one-line @AGENTS.md import, and each .claude/skills/<name> is a symlink to .agents/skills/<name>; add both when adding a nested AGENTS.md or a skill.

Skill Use
commit Conventional commit with Assisted-by: trailer
pr Pull request with Summary/Problem/Solution body
review-pr PR review debrief and draft comment
rebase-onto-main Rebase, including onto a squash-merged parent
build-px4-linux Board or SITL build on a Linux host
build-px4-macos Board build on macOS, in the px4-dev container
grilling Plan or design stress test, one question at a time

Create worktrees where the user's own agent instructions put them. Without such a rule, put them next to the repository in ../PX4-Autopilot-worktrees/<name>/, never inside it.