writing-for-agents is agent-read markdown (skill) from firzus/agent-skills: Create, update, and review AGENTS.md files, skills, and their references. Propose project-instruction changes for approval before writing..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Write useful agent instructions
Make behavior explicit with the smallest sufficient document. Update the owning
passage rather than accumulating corrective layers. A justified no-change result
is valid; a template is a coverage check, not a quota of content.
## 1. Inspect the document and its authority
1. Identify the requested outcome, audience, file paths, scope, and existing owners.
Read applicable instructions and surrounding documents; preserve unrelated work.
2. Inspect sources supporting facts, paths, commands, and conventions. Separate
observed behavior, accepted policy, proposed policy, and unknowns.
3. Choose the relevant procedure:
| Document | Procedure |
| --- | --- |
| Create or update project instructions or scoped rules | [Project instructions](references/project-instructions.md) |
| Create or update a skill or its references | [Skill authoring](references/skill-authoring.md) |
| Other agent-facing documentation | Apply the editorial rules below and preserve its owning format |
4. For a narrow correction, inspect its dependencies without turning it into a full
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
A 17 of 17 checks passed. Deterministic, no model, 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 (6182 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
firzus/agent-skills · 3 stars · license MIT · pushed 2026-09-23 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_gvxfuwmslu5alafj
GET https://markdownregistry.com/api/v1/resolve?ref=firzus/agent-skills/writing-for-agents
GET https://markdownregistry.com/api/v1/blob/5d44779fc1942162afe4152337e7cc79653fd38eca4a16509919ed315cd2e0a3
Your agent 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.
firzus/agent-skills · skills/engineering/code-review/SKILL.md · Review a scoped diff against requirements, project standards, and correctness using independent read-only reviewers…
firzus/agent-skills · skills/engineering/deep-research/SKILL.md · Investigate a question across sources with delegated research, adversarial verification, and a reusable evidence…
firzus/agent-skills · skills/engineering/gamification/SKILL.md · Gamification design for products, apps, and game meta-layers: design an engagement, habit, or retention system; choose…
firzus/agent-skills · skills/engineering/implement/SKILL.md · Deliver prepared work with test-first verification, current documentation, and a verified handoff.
firzus/agent-skills · skills/engineering/interview/SKILL.md · Prepare approved Linear work briefs through a continuous interview, with progressive framing for large goals.
firzus/agent-skills · skills/engineering/prototype/SKILL.md · Resolve a bounded design or feasibility question through an observable experiment. Use for authorized interface, logic…
firzus/agent-skills · skills/engineering/security-review/SKILL.md · Perform source-only security audits of codebases, APIs, services, and applications. Use for security questions, focused…
vodailocz/kilo-kit-mcp · skills/productivity/writing-for-agents/SKILL.md · Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/writing-for-agents/SKILL.md · Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
aethrox/doctrine · skills/writing-for-agents/SKILL.md · Classify and structure content going into a document an agent reads (a skill, AGENTS.md, CLAUDE.md, a linked doc) so…
mambo-wang/codewiki-plus · .codebuddy/skills/writing-for-agents/SKILL.md · Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
mambo-wang/codewiki-plus · .trae/skills/writing-for-agents/SKILL.md · Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
