Stats
Actions
Tags
From mr-kelly-skills
Align all AI coding agents to single source of truth. AGENTS.md for rules, .agents/skills/ for skills. All other files are symlinks.
How this skill is triggered — by the user, by Claude, or both
Slash command
/mr-kelly-skills:agent-rulesThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Ensure all AI coding agents use the same rules and skills via symlinks.
Ensure all AI coding agents use the same rules and skills via symlinks.
/agent-rules # Align all agents
/agent-rules --check # Verify alignment
/agent-rules --status # Show current status
Two sources only:
AGENTS.md (project root) - edit here.agents/skills/ - edit here (SOURCE)Everything else is a symlink:
CLAUDE.md → AGENTS.md.github/copilot-instructions.md → ../AGENTS.md.cursor/rules/main.md → ../../AGENTS.md.gemini/GEMINI.md → ../AGENTS.md.kiro/steering/main.md → ../../AGENTS.md.claude/skills/ → ../.agents/skills.github/skills/ → ../.agents/skills.kiro/skills/ → ../.agents/skills.codex/skills/ → ../.agents/skillsAGENTS.md ← Edit rules here
.agents/skills/ ← Edit skills here (SOURCE)
↓ All others are symlinks ↓
CLAUDE.md → AGENTS.md
.github/copilot-instructions.md → ../AGENTS.md
.cursor/rules/main.md → ../../AGENTS.md
.gemini/GEMINI.md → ../AGENTS.md
.kiro/steering/main.md → ../../AGENTS.md
.claude/skills/ → ../.agents/skills
.github/skills/ → ../.agents/skills
.kiro/skills/ → ../.agents/skills
.codex/skills/ → ../.agents/skills
| Agent | Skills | Instructions |
|---|---|---|
| OpenAI Codex | .codex/skills/ → | AGENTS.md |
| Claude Code | .claude/skills/ → | CLAUDE.md → |
| GitHub Copilot | .github/skills/ → | .github/copilot-instructions.md → |
| Kiro CLI | .kiro/skills/ → | .kiro/steering/main.md → |
| Cursor IDE | N/A | .cursor/rules/main.md → |
| Gemini CLI | N/A | .gemini/GEMINI.md → |
All skills symlinks point to .agents/skills/
vim AGENTS.md # Edit once, all agents see it
mkdir -p .agents/skills/my-skill
vim .agents/skills/my-skill/SKILL.md
# All agents see it automatically
/agent-rules
AGENTS.md - single source for rules.agents/skills/ - single source for skillsMCP (Model Context Protocol) configs are NOT symlinked because:
.json vs .toml)MCP config locations:
.claude/mcp.json.kiro/mcp.json.cursor/mcp.json.codex/config.tomlIf you need to sync MCP configs: Do it manually or create a sync script.
/agent-rules # Create all symlinks
/agent-rules --check # Verify all symlinks valid
/agent-rules --status # Show symlink status
/agent-rules --fix # Fix broken symlinks
scripts/agent-rules.sh - Main entry pointscripts/create-symlinks.sh - Create symlinksscripts/verify-architecture.sh - Verify alignment/agent-rules --fix
ls .agents/skills/skill-name/ # Check source exists
Version: 4.0
Last Updated: 2026-02-20
Breaking Change: Skills source moved from .claude/skills/ to .agents/skills/
npx claudepluginhub mr-kelly/skills --plugin mr-kelly-skillsManages lifecycle of agents, skills, rules, and hooks in .claude/: create/update/delete with cross-reference propagation, subagent delegation for edits, and atomic permissions handling.
Generates and maintains AGENTS.md files for AI agents using shell scripts that detect project structure, extract commands and CI rules, and validate content freshness.
Audits and syncs agent instruction files across coding agents (Claude Code, Cursor, Copilot, Gemini) from AGENTS.md to CLAUDE.md, GEMINI.md, .cursorrules. For first-run scaffolding checks and post-edit consistency.