ai_instruction_writing SKILL.md skillA
ai_instruction_writing from theafh/ai-modules is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add theafh/ai-modules/ai_instruction_writing@v3.0.4Pins v3.0.4 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- theafh/ai-modules
- Path
plugins/ai_dev/skills/ai_instruction_writing/SKILL.md- Versions recorded
- 5
- Latest version
- v3.0.4, committed Sep 5, 2026
- First version recorded
- May 16, 2026
- Size
- 11,739 bytes
- Repository stars
- 38
- License
- MIT
Write AI-consumed content using positive, action-oriented language as the primary carrier of every instruction. Use when creating or editing any artifact an AI reads at inference time. Those artifacts include SKILL.md files, .mdc rule files, CLAUDE.md/AGENTS.md/GEMINI.md configuration, prompt templates, system prompts, commands, agent and sub-agent definitions, instruction sets, and persona definitions.
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_instruction_writing
<ai_instruction_writing>
<objective>
Write AI-consumed content so every instruction's primary carrier is a positive, action-oriented statement that tells the LLM what to do, what something is, or how it should be. Allow negative or contrastive supplements when they add information the positive carrier cannot imply: a broad catch-all class, specific banned forms, or an exact set a downstream mechanism checks. Build each of those statements as an ordinary sentence, so no em dash or en dash appears in it.
</objective>
<core_rule>
Every instruction's primary carrier is a positive statement that tells the LLM what to do, what something is, or how it should be. A negative or contrastive supplement ("don't X", "avoid Y", "X instead of Y", double negatives, implicit negation by comparison) earns its place when it adds information the positive carrier cannot imply. It may name a broader catch-all class for what falls outside the positive guidance, or it may specify exact banned forms or checked sets that a reader or tool needs. Cut a negative only when it restates the inverse of the positive and adds nothing.
</core_rule>
<self_check>
…Read the whole file at its exact version.
How to install
mdr add theafh/ai-modules/ai_instruction_writing@sha256:cf73bf3ac4101b1cThe line at the top of this page pins the label v3.0.4, 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.
[](https://markdownregistry.com/a/art_yka6hmdx6bbe4hx3)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between May 16, 2026 and Sep 5, 2026, about one every 28 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v3.0.4 latest | 2026-09-05 | e04ae6b | 11,739 B | A | view · diff |
| v3.0.3 | 2026-09-05 | a750d17 | 11,635 B | A | view · diff |
| v3.0.2 | 2026-08-10 | 35db84a | 11,614 B | A | view · diff |
| v3.0.1 | 2026-06-28 | 9db2ae3 | 9,851 B | A | view · diff |
| v3.0.0 | 2026-05-16 | 4c939bd | 8,216 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (11739 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
theafh/ai-modules · 38 stars · license MIT · pushed 2026-10-18 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_yka6hmdx6bbe4hx3 GET https://markdownregistry.com/api/v1/resolve?ref=theafh/ai-modules/ai_instruction_writing GET https://markdownregistry.com/api/v1/blob/cf73bf3ac4101b1cb7e13d910954ce37450b99c3aac35b530f70c6e4d3daca00
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.