flygard-core/.agents/README.md

.agents

Source of truth for this repo's agent skills and docs:

• skills/<name>/SKILL.md
• docs/ — task-scoped agent docs; taxonomy and placement policy in docs/README.md
• plans/ — per-task planning docs, gitignored

Conventions live in AGENTS.md and docs/. Agent-specific files point there instead of restating them, so there is one copy to keep current.

Hooking up your agent

• Claude Code — reads CLAUDE.md, which imports AGENTS.md. Skills are exposed by a relative symlink: .claude/skills/<name> -> ../../.agents/skills/<name>.
• GitHub Copilot — reads AGENTS.md natively. Code review also reads .github/copilot-instructions.md; custom agent profiles live in .github/agents/.
• Any other agent — point it at AGENTS.md through its own entry file (GEMINI.md, .cursorrules, …), using that agent's include syntax or, where includes are unsupported, a line telling it to read AGENTS.md first.

To add a skill: create it here, then symlink it from each agent's skills dir. Docs need no symlinks — AGENTS.md references them by path.

On Windows, symlinks need git config core.symlinks true plus Developer Mode or an elevated shell; without them git checks the links out as plain text files.

The skills in this repository often build on those from agent-toolkit, invoking them when available. Installing the toolkit at user level is therefore recommended.