ai_instruction_formatting SKILL.md skillA

ai_instruction_formatting from theafh/ai-modules is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add theafh/ai-modules/ai_instruction_formatting@v3.4.3

Pins v3.4.3 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_formatting/SKILL.md
Versions recorded
5
Latest version
v3.4.3, committed Sep 5, 2026
First version recorded
May 6, 2026
Size
19,862 bytes
Repository stars
38
License
MIT

Organize AI-consumed content (prompts, rules, skills, commands, agents, system instructions) into pseudo-XML by wrapping each semantic concern in a dedicated tag for role, policy, inputs, and output contract. Use when structuring or reorganizing the body of a SKILL.md, agent or sub-agent definition, command file, rules document (.mdc), CLAUDE.md, AGENTS.md, or GEMINI.md configuration, prompt template, or system prompt into semantic tags, when choosing tag boundaries, or when checking whether…

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_formatting

Organize any LLM-consumed content into pseudo-XML, a lightweight tagging format where self-describing tag names encode the semantic role and organizational structure of information. Tags exist purely to label meaning (e.g., `<policy>`, `<scoring_criteria>`, `<after_spec_execution>`); they carry plain text inside and work directly as LLM-readable structure. Apply to system prompts, rules, skills, commands, agent definitions, instruction sets, and any other artifact an LLM reads at inference time.

## When to Apply

Use pseudo-XML structuring for any document where an LLM is the primary consumer: prompt templates with placeholders, static rule files, skill definitions, agent personas, routing instructions, and multi-step workflows. Apply the format equally to parameterized templates (with `{placeholder}` values) and fixed instructional content.

## File Shape

A pseudo-XML artifact lives inside a host file: a `SKILL.md`, an agent definition, a command file, a rules document, or a snippet. Four document shapes are valid, and this skill's bundled linter (`scripts/lint_pseudo_xml.py`) recognizes all four:

| Shape | Where it appears | Body content |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add theafh/ai-modules/ai_instruction_formatting@sha256:492085ec51e64065

The line at the top of this page pins the label v3.4.3, 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_btaosjdhwe3m2ugt.svg)](https://markdownregistry.com/a/art_btaosjdhwe3m2ugt)

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

Versions

The registry has recorded 5 versions of this file, between May 6, 2026 and Sep 5, 2026, about one every 31 days.

versioncommittedcommitsizeaudit
v3.4.3 latest2026-09-05 e04ae6b 19,862 BA view · diff
v3.4.22026-09-05 a750d17 19,879 BA view · diff
v3.4.12026-06-22 317e08c 19,442 BA view · diff
v3.4.02026-05-12 f435b90 19,442 BA view · diff
v3.3.02026-05-06 ddff4a3 17,489 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 (19862 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

theafh/ai-modules · 38 stars · license MIT · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_btaosjdhwe3m2ugt
GET https://markdownregistry.com/api/v1/resolve?ref=theafh/ai-modules/ai_instruction_formatting
GET https://markdownregistry.com/api/v1/blob/492085ec51e64065813f1fdaa016cb77418f22be570303575383a60f087e3348

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 theafh/ai-modules

AGENTS.md AGENTS.md file
theafh/ai-modules · AGENTS.md
git:20261010.630e166 · audit A · 38 stars
CLAUDE.md CLAUDE.md file
theafh/ai-modules · CLAUDE.md
git:20261010.630e166 · audit A · 38 stars
agent_spinner SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/agent_spinner/SKILL.md · Run helper agents from an orchestrating agent under one quality contract, whatever delegation the host offers…
v1.0.1 · audit A · 38 stars
ai_instruction_writing SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/ai_instruction_writing/SKILL.md · Write AI-consumed content using positive, action-oriented language as the primary carrier of every instruction. Use…
v3.0.4 · audit A · 38 stars
format_markdown SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/format_markdown/SKILL.md · Apply markdown linting compliance and best practices when creating or editing markdown files (.md, .mdc). Covers…
v2.0.0 · audit A · 38 stars
format_python SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/format_python/SKILL.md · Apply formatting standards, code quality rules, structure conventions, linting prevention, and best practices when…
v1.4.1 · audit A · 38 stars
format_rust SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/format_rust/SKILL.md · Apply clippy-aligned Rust practices when writing or editing Rust code (.rs). Covers procedural flow, clippy-driven…
v1.3.2 · audit A · 38 stars
git_checkout SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_checkout/SKILL.md · Put the repository onto an existing branch wherever it lives: fetch every remote without pruning, switch when the…
v1.0.0 · audit A · 38 stars
git_commit SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_commit/SKILL.md · Create one structured git commit covering the full current working-tree state. Use when the user explicitly asks to…
v3.5.2 · audit B · 38 stars
git_refresh SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_refresh/SKILL.md · Refresh a local git repo back to a clean current default branch: fetch/prune, detect the remote HEAD, fast-forward…
v1.0.1 · audit A · 38 stars
git_review SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_review/SKILL.md · Review the changes the user names and answer two questions kept apart: could they be approved in general, and can they…
v1.0.9 · audit B · 38 stars
guardrail SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/guardrail/SKILL.md · Hub and source of truth for the repo-root guardrail documents (CHARTER.md, ARCHITECTURE.md, TESTING.md, SECURITY.md)…
v1.0.3 · audit A · 38 stars

Every file in theafh/ai-modules

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