Agent rules

Skill mr-kelly/skills/skills/agent-rules

Agent Skills by mr-kelly

Install

npx -y skills add mr-kelly/skills --skill agent-rules

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Align all AI coding agents to single source of truth. AGENTS.md for rules, .agents/skills/ for skills. All other files are symlinks.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.7 KB, as published. Nobody here has run it

Agent Rules - Single Source of Truth

Ensure all AI coding agents use the same rules and skills via symlinks.

Quick Start

/agent-rules              # Align all agents
/agent-rules --check      # Verify alignment
/agent-rules --status     # Show current status

Single Source of Truth

Two sources only:

Rules: AGENTS.md (project root) - edit here
Skills: .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/skills

Architecture

AGENTS.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

Supported Agents

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/

Usage

Edit Rules

vim AGENTS.md    # Edit once, all agents see it

Add Skill

mkdir -p .agents/skills/my-skill
vim .agents/skills/my-skill/SKILL.md
# All agents see it automatically

Align All Agents

/agent-rules

Critical Rules

✅ ONLY edit AGENTS.md - single source for rules
✅ ONLY edit .agents/skills/ - single source for skills
❌ NEVER edit symlinked files - they're just links
❌ NEVER copy files - use symlinks only

What About MCP Configs?

MCP (Model Context Protocol) configs are NOT symlinked because:

Each agent has different config format (.json vs .toml)
Contains agent-specific settings
May contain sensitive info (API keys)

MCP config locations:

Claude: .claude/mcp.json
Kiro: .kiro/mcp.json
Cursor: .cursor/mcp.json
Codex: .codex/config.toml

If you need to sync MCP configs: Do it manually or create a sync script.

Commands

/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

scripts/agent-rules.sh - Main entry point
scripts/create-symlinks.sh - Create symlinks
scripts/verify-architecture.sh - Verify alignment

Troubleshooting

Symlink broken

/agent-rules --fix

Skill not found

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/