agent-docs SKILL.md skillA

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

Install it, pinned
mdr add birdsigh/skills/agent-docs@git:20260814.edbff2b

Pins git:20260814.edbff2b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
birdsigh/skills
Path
agent-docs/SKILL.md
Versions recorded
1
Latest version
git:20260814.edbff2b, committed Aug 14, 2026
Size
5,193 bytes
Repository stars
3
License
MIT

Use when the user asks to init or bootstrap project or agent docs, create or add a README, CLAUDE.md, or AGENTS.md, add missing doc files, or set up agent instructions, in a project that already has substance to document (code, a requirements or spec doc, a PRD). Do NOT use on a blank or empty project with nothing to derive docs from, and do NOT use to edit, improve, or restructure docs that already exist.

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

# Init Project Docs

Check the project root for README.md, AGENTS.md, and CLAUDE.md. Create whichever are missing. NEVER modify or overwrite one that exists, even partially; if all three exist, say so and stop.

## First: survey the project

Before writing anything, build real understanding. Read the file tree, package manifests and lockfiles, scripts/tasks, CI config, recent git log, and any requirements, spec, or PRD documents (a spec-only repo is a valid and sufficient source; a good PRD answers most README questions and seeds the AGENTS.md core vocabulary and never-compromise list). Skim the main entry points if code exists. Check the project root, and only the root, for a `CONTEXT.md` or equivalent glossary: if one is there, it owns the project's vocabulary and AGENTS.md should point at it rather than restate it. Ignore glossaries in subdirectories; those belong to a package, not the project. Everything you write must be derived from this specific project. Generic boilerplate ("write clean code", "follow best practices") is worse than nothing: delete any sentence that would be true of every repo on earth.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add birdsigh/skills/agent-docs@sha256:8e99efdabf4dd609

The line at the top of this page pins the label git:20260814.edbff2b, 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_6wo47jjdo6twi7oz.svg)](https://markdownregistry.com/a/art_6wo47jjdo6twi7oz)

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

Versions

The registry has recorded 1 version of this file, committed on Aug 14, 2026.

versioncommittedcommitsizeaudit
git:20260814.edbff2b latest2026-08-14 edbff2b 5,193 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 (5193 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

birdsigh/skills · 3 stars · license MIT · pushed 2026-09-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6wo47jjdo6twi7oz
GET https://markdownregistry.com/api/v1/resolve?ref=birdsigh/skills/agent-docs
GET https://markdownregistry.com/api/v1/blob/8e99efdabf4dd6091cf28776b00254b7974716352234862fc3f5174a779fac1e

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 birdsigh/skills

AGENTS.md AGENTS.md file
birdsigh/skills · AGENTS.md
git:20260814.865b381 · audit A · 3 stars
be-concise SKILL.md skill
birdsigh/skills · be-concise/SKILL.md · Give answers, not essays. Headings, list; information fast. Trigger when the user says "be concise", "do this quickly"…
git:20260713.9e4113e · audit A · 3 stars
build-context SKILL.md skill
birdsigh/skills · build-context/SKILL.md · Generate or update a CONTEXT.md file that formalises the domain-specific language for a project — capturing shared…
git:20260814.edbff2b · audit A · 3 stars
commit-and-push SKILL.md skill
birdsigh/skills · commit-and-push/SKILL.md · Safely review, verify, commit, and push intended repository changes to an established upstream branch, with…
git:20260920.bd44800 · audit A · 3 stars
deploy-prototype SKILL.md skill
birdsigh/skills · deploy-prototype/SKILL.md · Deploy static HTML prototypes to a ProtoLab instance (a Cloudflare Worker that hosts throwaway prototypes) with one…
git:20260713.9e4113e · audit A · 3 stars
response-analysis SKILL.md skill
birdsigh/skills · response-analysis/SKILL.md · Score user-research responses on sentiment, pain, and excitement with quote-backed evidence. Use this whenever the user…
git:20260529.beb038c · audit A · 3 stars
suggest-next SKILL.md skill
birdsigh/skills · suggest-next/SKILL.md · Surface related ideas, tasks, reading, and follow-on conversations based on what was just discussed or built. Trigger…
git:20260529.beb038c · audit A · 3 stars
wind-down SKILL.md skill
birdsigh/skills · wind-down/SKILL.md · Produce a structured closing summary for informal or exploratory conversations — discussions, brainstorms, research…
git:20260529.beb038c · audit A · 3 stars
wrap-up SKILL.md skill
birdsigh/skills · wrap-up/SKILL.md · Produce a structured closing summary for work-focused sessions — coding tasks, feature builds, bug fixes, design work…
git:20260529.beb038c · audit A · 3 stars

Every file in birdsigh/skills

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