AGENTS.mdA

AGENTS.md from athola/skrills is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add athola/skrills/AGENTS.md@git:20261031.0aae27a

Pins git:20261031.0aae27a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
athola/skrills
Path
AGENTS.md
Versions recorded
5
Latest version
git:20261031.0aae27a, committed Oct 31, 2026
First version recorded
Jan 16, 2026
Size
11,670 bytes
Repository stars
69
License
MIT

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

# AI Agent Development Guidelines

Use these guidelines to build AI coding agents that produce functional, high-quality code.

---

## Guiding Principles

Prioritize small, functional changes. They are safer and easier to debug than large rewrites. Adapt to each project's conventions rather than applying external rules rigidly.

Balance trade-offs like performance, readability, and security based on evidence (profiling, metrics) rather than intuition. Explore multiple solutions before committing to one to avoid "mode collapse." Favor simple, standard solutions. Code that requires extensive comments often needs refactoring.

Each component should serve one distinct purpose (Single Responsibility Principle). Defer abstraction until a clear pattern emerges (e.g., Rule of Three). Explicitly document assumptions, trade-offs, and confidence levels to maintain transparency.

---

## Development Workflow

### Implementation Cycle

1. **Understand**: Read existing code, identify patterns, and review tests.
2. **Explore**: Develop multiple viable approaches and articulate their trade-offs.
3. **Test**: Write a failing test case before implementing new code (when applicable).
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add athola/skrills/AGENTS.md@sha256:4291dc7aa0702e53

The line at the top of this page pins the label git:20261031.0aae27a, 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_mu5tmcw5vjtwcm35.svg)](https://markdownregistry.com/a/art_mu5tmcw5vjtwcm35)

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

Versions

The registry has recorded 5 versions of this file, between Jan 16, 2026 and Oct 31, 2026, about one every 72 days.

versioncommittedcommitsizeaudit
git:20261031.0aae27a latest2026-10-31 0aae27a 11,670 BA view · diff
git:20261006.1610ec32026-10-06 1610ec3 10,989 BA view · diff
git:20260609.1ae5b6f2026-06-09 1ae5b6f 10,986 BA view · diff
git:20260124.bd2aedd2026-01-24 bd2aedd 10,988 BA view · diff
git:20260116.96a9f192026-01-16 96a9f19 11,974 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (11670 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

athola/skrills · 69 stars · license MIT · pushed 2026-10-31 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_mu5tmcw5vjtwcm35
GET https://markdownregistry.com/api/v1/resolve?ref=athola/skrills/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/4291dc7aa0702e539d60415feac8524754c1ae4000f15cd91e818b080b855489

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: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from athola/skrills

api-designer SKILL.md skill
athola/skrills · assets/demo-skills/api-designer/SKILL.md · Design RESTful APIs with best practices for consistency and usability
git:20260106.0e498e9 · audit A · 69 stars
coding-assistant SKILL.md skill
athola/skrills · assets/demo-skills/coding-assistant/SKILL.md · Provides coding assistance with best practices and code review
git:20260106.0e498e9 · audit A · 69 stars
debug-helper SKILL.md skill
athola/skrills · assets/demo-skills/debug-helper/SKILL.md · Systematic debugging approach for identifying and fixing issues
git:20260106.0e498e9 · audit A · 69 stars
git-workflow SKILL.md skill
athola/skrills · assets/demo-skills/git-workflow/SKILL.md · Git best practices for version control and collaboration
git:20260106.0e498e9 · audit A · 69 stars
test-writer SKILL.md skill
athola/skrills · assets/demo-skills/test-writer/SKILL.md · Write thorough tests following TDD and BDD principles
git:20260609.1ae5b6f · audit A · 69 stars
AGENTS.md@crates/sync AGENTS.md file
athola/skrills · crates/sync/AGENTS.md
git:20261031.0aae27a · audit A · 69 stars
html-portal-generator SKILL.md skill
athola/skrills · skills/html-portal-generator/SKILL.md · Convert a codebase into a self-contained HTML portal app for ingestion into AI application systems. Produces a single…
v1.0.0 · audit B · 69 stars

Every file in athola/skrills

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261101.d684125 · audit A · 417,919 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 309,852 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 293,827 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 198,353 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 182,080 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 139,879 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261027.a50cf58 · audit A · 138,879 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 116,476 stars

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