agent-rules SKILL.md skillA

agent-rules from mr-kelly/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mr-kelly/skills/agent-rules@git:20260907.3d5d7e1

Pins git:20260907.3d5d7e1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
mr-kelly/skills
Path
skills/agent-rules/SKILL.md
Versions recorded
4
Latest version
git:20260907.3d5d7e1, committed Sep 7, 2026
First version recorded
Feb 25, 2026
Size
6,178 bytes
Repository stars
6
License
MIT

Align all AI coding agents to a single source of truth. AGENTS.md for rules, .agents/skills/ for skills, symlinks for everything else. Use when setting up a repo for multiple agents, or when links are missing, broken, or out of date.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Agent Rules - Single Source of Truth

Every AI coding agent reads its own rules file and its own skills directory. This
skill keeps one real copy of each and points the rest at it with symlinks.

## Quick Start

```bash
/agent-rules                    # create or repair links in the current project
/agent-rules --check            # verify; exits 1 when something is broken
/agent-rules --status           # report only, never fails
/agent-rules --minimal          # skip links agents no longer need
/agent-rules --root <path>      # operate on a project other than $PWD
```

The target project is the git toplevel of your working directory (or `$PWD`
outside a repo), **not** wherever this skill happens to be installed.

## Single Source of Truth

Two sources, edited by hand:

1. **Rules** — `AGENTS.md` at the project root
2. **Skills** — `.agents/skills/<skill-name>/SKILL.md`

Everything else is a symlink into those two.

```
AGENTS.md                         ← edit rules here
.agents/skills/                   ← edit skills here

↓ symlinks ↓

CLAUDE.md                       → AGENTS.md
.gemini/GEMINI.md               → ../AGENTS.md
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mr-kelly/skills/agent-rules@sha256:6f3c8ea5d1ce3653

The line at the top of this page pins the label git:20260907.3d5d7e1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_engwtl2ls2gr5yp2.svg)](https://markdownregistry.com/a/art_engwtl2ls2gr5yp2)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Feb 25, 2026 and Sep 7, 2026, about one every 65 days.

versioncommittedcommitsizeaudit
git:20260907.3d5d7e1 latest2026-09-07 3d5d7e1 6,178 BA view · diff
git:20260808.5ce8d822026-08-08 5ce8d82 3,894 BA view · diff
git:20260701.c42cb8a2026-07-01 c42cb8a 3,832 BA view · diff
git:20260225.18ef0562026-02-25 18ef056 3,819 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6178 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

mr-kelly/skills · 6 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_engwtl2ls2gr5yp2
GET https://markdownregistry.com/api/v1/resolve?ref=mr-kelly/skills/agent-rules
GET https://markdownregistry.com/api/v1/blob/6f3c8ea5d1ce36538a2b20c27a5316df86e2978cf07c62d4edf83a71276490e4

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from mr-kelly/skills

AGENTS.md AGENTS.md file
mr-kelly/skills · AGENTS.md
git:20261013.4eb4ac2 · audit A · 6 stars
CLAUDE.md CLAUDE.md file
mr-kelly/skills · CLAUDE.md
git:20260808.5ce8d82 · audit B · 6 stars
buda-community SKILL.md skill
mr-kelly/skills · skills/buda-community/SKILL.md · Read, answer and post on the Buda community forum at community.buda.im through its /api/v1/community REST API. Lists…
git:20260927.c741246 · audit A · 6 stars
busabase-community SKILL.md skill
mr-kelly/skills · skills/busabase-community/SKILL.md · Read, answer and post on the Busabase community forum at community.busabase.com through its /api/v1/community REST API…
git:20260927.c741246 · audit A · 6 stars
kelly-ads SKILL.md skill
mr-kelly/skills · skills/kelly-ads/SKILL.md · Ad-campaign command desk (投放指挥台, Busabase App-in-Skill) for a cross-border e-commerce seller running Amazon Ads, Meta…
git:20260824.d18190a · audit A · 6 stars
kelly-agent-builder SKILL.md skill
mr-kelly/skills · skills/kelly-agent-builder/SKILL.md · Busabase-backed App-in-Skill low-code agent configuration and governance console for a platform team. Use when the user…
git:20260824.d18190a · audit A · 6 stars
kelly-agent-eval SKILL.md skill
mr-kelly/skills · skills/kelly-agent-eval/SKILL.md · Review board (Busabase App-in-Skill) that runs a fixed suite of mock test cases against a baseline vs candidate agent…
git:20260824.d18190a · audit A · 6 stars
kelly-agent-observability SKILL.md skill
mr-kelly/skills · skills/kelly-agent-observability/SKILL.md · Busabase App-in-Skill dashboard visualizing a generated MOCK fleet of LLM agents running behind a shared AI gateway for…
git:20260824.d18190a · audit A · 6 stars
kelly-ai-newsroom SKILL.md skill
mr-kelly/skills · skills/kelly-ai-newsroom/SKILL.md · Kelly AI Newsroom: App-in-Skill daily industry intelligence cockpit for AI/news-source intelligence (Busabase…
git:20260824.d18190a · audit A · 6 stars
kelly-app-skill-creator-tests SKILL.md skill
mr-kelly/skills · skills/kelly-app-skill-creator-tests/SKILL.md · Build, maintain, and run conformance tests for canonical App-in-Skill projects created by kelly-app-skill-creator. Use…
git:20260812.92014c1 · audit A · 6 stars
kelly-app-skill-creator SKILL.md skill
mr-kelly/skills · skills/kelly-app-skill-creator/SKILL.md · Design and create Busabase-backed App-in-Skill packages with a canonical app project, Busabase-native setup and product…
git:20261002.f0720fe · audit B · 6 stars
kelly-appsec SKILL.md skill
mr-kelly/skills · skills/kelly-appsec/SKILL.md · 审计已获授权的应用与 REST API 的对象、字段、动作权限及业务规则,维护接口清单、身份矩阵、可归属证据和指定版本复测。Use for application/API authorization audits, tenant…
git:20261026.36c87bf · audit A · 6 stars

Every file in mr-kelly/skills

Other files named agent-rules

agent-rules SKILL.md skill
netresearch/agent-rules-skill · skills/agent-rules/SKILL.md · Use when creating or updating AGENTS.md files, .github/copilot-instructions.md, or other AI agent rule files…
v3.16.5 · audit A · 89 stars

Browse by kind, by grade A, or by owner.