Imported from GoatInAHat/bennettvernon.com (.agents/AGENTS.md). Install upstream with npx skills add GoatInAHat/bennettvernon.com --skill .agents. Copyright stays with the author.

`.agents/`

Name: .agents
Author: GoatInAHat

Agent-agnostic configuration following the Agent Skills open standard and AGENTS.md conventions.

Every piece of agent configuration is one of three things:

Category	Strategy
Portable — same format everywhere	Store once here, symlink into agent directories
Generated — same data, different format	Canonical source here, sync script renders each adapter
Agent-specific — no cross-agent equivalent	Leave it in the agent's own directory

Portable things get symlinks, generated things get a sync script, agent-specific things stay put.

Layout

skills/ — Shared skills. Each is a directory with SKILL.md.
mcp/servers.json — Canonical MCP server configuration.
scripts/ — Portable environment setup, synchronization, and validation.

Adding a skill

Create .agents/skills/<name>/SKILL.md with name and description frontmatter, where name matches the directory.
Run .agents/scripts/link-skills.sh and .agents/scripts/check-skills.py --update.
Commit the skill directory, the generated symlinks, and skills-lock.json.

Installing a third-party skill

npx skills add <repo>@<skill> -y

Adding an MCP server

Edit .agents/mcp/servers.json.
Run .agents/scripts/sync-mcp.sh.
Commit the canonical file and all generated adapters.

An optional tools array on a server is a read-only allowlist. It renders as enabled_tools for Codex and includeTools for Gemini; Claude Code and Cursor have no equivalent and receive the server's whole tool surface.

Rules

Edit skills in .agents/skills/, never through .claude/skills/ or .cursor/skills/.
Edit MCP definitions in .agents/mcp/servers.json, never in .mcp.json, .cursor/mcp.json, .codex/config.toml, or .gemini/settings.json.
.claude/settings.json and .gemini/settings.json are hand-owned except for their enabledMcpjsonServers and mcpServers keys, which the sync rewrites.
Agent-specific configuration stays put. .cursor/rules/*.mdc and .github/instructions/*.instructions.md use glob scoping and conditional loading with no equivalent elsewhere — do not convert them into skills. Knowledge every agent needs belongs in AGENTS.md.
Keep secrets and machine-local configuration out of committed files.
Run the pre-commit hooks or their underlying scripts before committing. GitHub Actions enforces the same checks for pull requests and main.

{ "ocm": "1", "id": "goatinahat-bennettvernon-com-agents", "kind": "skill", "name": ".agents", "description": "Agent-agnostic configuration following the [Agent Skills](https://agentskills.io) open standard and [AGENTS.md](https://agents.md) conventions.", "publisher": "GoatInAHat", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Agent-agnostic configuration following the [Agent Skills](https://agentskills.io) open standard and [AGENTS.md](https://agents.md) conventions." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/GoatInAHat/bennettvernon.com", "path": ".agents/AGENTS.md", "ref": "35c584028ed0469c33ebef5ead252934f365e690", "url": "https://github.com/GoatInAHat/bennettvernon.com/blob/35c584028ed0469c33ebef5ead252934f365e690/.agents/AGENTS.md", "key": "GoatInAHat/bennettvernon.com/.agents/AGENTS.md" } }, "instructions": "# `.agents/`\n\nAgent-agnostic configuration following the [Agent Skills](https://agentskills.io)\nopen standard and [AGENTS.md](https://agents.md) conventions.\n\nEvery piece of agent configuration is one of three things:\n\n| Category | Strategy |\n|---|---|\n| **Portable** — same format everywhere | Store once here, symlink into agent directories |\n| **Generated** — same data, different format | Canonical source here, sync script renders each adapter |\n| **Agent-specific** — no cross-agent equivalent | Leave it in the agent's own directory |\n\nPortable things get symlinks, generated things get a sync", "cost": { "context_tokens": 631 } }

.agents

About

`.agents/`

Layout

Adding a skill

Installing a third-party skill

Adding an MCP server

Rules

Use it

Manifest

Reviews