agent-projectlisted
Install: claude install-skill fmind/dotfiles
# Set Up Agents on a Project
Create the portable instruction and skill layer once, then add only the tool-specific configuration the project needs.
## Workflow
1. **Create the Shared Layer**:
```bash
mkdir -p .agents/skills .agents/prompts
touch AGENTS.md
```
Start `AGENTS.md` from the minimal [project template](templates/AGENTS.md), then put project-wide rules there, store reusable project skills in `.agents/skills/<name>/SKILL.md`, and keep prompt files in `.agents/prompts/` (globally gitignored by default).
1. **Add Tool-Specific Files Only When Needed**:
- **Antigravity**: use `.agents/settings.json` for workspace settings and `.agents/mcp_config.json` for MCP. It respects `.gitignore`; do not invent an `.antigravityignore`.
- **Codex**: use `.codex/config.toml` for trusted project overrides and MCP. Codex reads `AGENTS.md` and `.agents/skills` natively.
- **OpenCode**: use `opencode.json` for settings and MCP. OpenCode reads `AGENTS.md` and `.agents/skills` natively.
- **Claude**: create `CLAUDE.md` containing `@AGENTS.md`, link `.claude/skills` to `../.agents/skills`, and use `.mcp.json` for project MCP servers.
- **Copilot**: Copilot CLI reads `AGENTS.md` and `.agents/skills` natively. Use `.github/copilot-instructions.md` only for additional repository-wide Copilot instructions and `.github/mcp.json` or `.mcp.json` for MCP.
1. **Inspect Before Creating Links**: Never replace an existing `CLAUDE.md` or `.claude/skills` path without revi