{"slug": "what-markdown-bold-actually-does-in-an-agent-instruction-file", "title": "What Markdown Bold Actually Does in an Agent Instruction File", "summary": "A developer examined whether Markdown bold in agent instruction files like CLAUDE.md, AGENTS.md, GEMINI.md and SKILL.md actually influences model behavior, concluding it does not. The analysis cites PASTA research from Georgia Tech, UC Berkeley and Microsoft Research that reweights attention heads at inference for a 22% average accuracy gain on LLAMA-7B, and Anthropic's Claude Code guidance recommending a single word such as \"IMPORTANT\" on one line rather than markup. The developer found 635 bold spans across four skill files and notes that stripping them saves only about 1% of characters, so the real issue is marker density rather than token cost.", "body_md": "A rule gets skipped, so you make it bold. It happens again with a different rule, so that one goes bold as well, then the warnings, then the thing that broke production once.\n\nI did that to my own files for months without ever checking whether the highlighting was doing anything. 😅\n\nThe asterisks are tokens. A model reading your `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` or `SKILL.md` receives them as characters in a sequence, exactly like every other character in the file, and no documented path runs from \"this span is emphasized\" to \"weight this more heavily\".\n\nThe intuition comes from somewhere real. The habit is not stupid. A reader's eye lands on bold before they have chosen to read the line, and since the model reads the same file we do, it feels like it should inherit the reflex.\n\nIt does not inherit it.\n\nPASTA, from Georgia Tech, UC Berkeley and Microsoft Research, reweights a small subset of attention heads at inference so a model attends to a span the user designates, changes no parameters, and reports a 22% average accuracy improvement for LLAMA-7B.\n\nIts abstract opens on the analogy itself:\n\n```\nIn human-written articles, we often leverage the subtleties of\ntext style, such as bold and italics, to guide the attention of\nreaders. ... Existing methods, however, are constrained to\nprocess plain text and do not support such a mechanism.\n```\n\nAnthropic's Claude Code guidance is the most directly useful thing I found:\n\n```\nIf Claude keeps skipping one instruction, add emphasis such as\n\"IMPORTANT\" to that line alone. If you emphasize many lines,\nnone of them stands out.\n```\n\nTwo things sit in that sentence. The recommended instrument is a word rather than markup, and the failure mode is named outright by the vendor. 📄\n\nThe skills documentation supplies the constraint underneath. A loaded `SKILL.md` enters the conversation as one message and stays there across later turns, which makes every line a recurring cost, and the stated cap is 500 lines.\n\nOutside Anthropic, the silence says the same thing.\n\n```\nClaude Code    CLAUDE.md, SKILL.md    one word, IMPORTANT, on one line\nCodex          AGENTS.md              standard Markdown, no special syntax\nGemini     GEMINI.md              concatenated and sent with every prompt\n```\n\nThree ecosystems, and not one of them documents emphasis as a mechanism.\n\nThe opposite overcorrection is also wrong, because prompt formatting is not inert. One study rendered identical content as plain text, Markdown, JSON and YAML and measured all four: GPT-3.5-turbo moved by up to 40% on a code translation task, and GPT-4 held much steadier on the same swap.\n\nLook at what varied. Whole schemes. An inline marker is a far smaller perturbation of the same input, and the sensitivity shrank as the model got stronger.\n\nOne skill of mine, four files, 253,612 characters:\n\n```\nSKILL.md                  91 bold spans\nplatform-posting.md      386\nbrowser-interaction.md   116\npost-formatting.md        42\n                       -----\n                         635\n```\n\nDeleting every asterisk in all four saves 2,540 characters, which is about 1% of the text and a few hundred tokens across the whole skill. So the argument I assumed I would make, the one about token cost, was dead before I started writing it. What is measurable is the density: 91 spans across 264 lines is one every three lines, and at that rate the marker distinguishes nothing. Nobody has benchmarked bold against no bold on an instruction file, so there is no measured penalty to point at, and I am not going to invent one. Bold does no harm, and it does no steering either.\n\nDo not expect stripping the asterisks to change what the model does. The reason to cut them is that a marker on every third line stops distinguishing anything, for the model reading the file and for whoever has to maintain it.\n\nThe symptom is a rule the model keeps skipping however loudly it is marked. The vendor's own diagnosis is that the file is too long and the rule is getting lost in it, and the fix on the page is to prune rather than to emphasize.\n\n```\nFor each line, ask: \"Would removing this cause Claude to\nmake mistakes?\" If not, cut it.\n```\n\n**A rule that survives that question has earned its line, and a rule that does not was never going to be rescued by asterisks.**\n\nPosition comes first, so the rule sits at the step where it applies rather than in a preamble, and one or two hard words per file, NEVER or MUST, stay rare enough to register when they appear. For anything that has to hold every time, I reach for a hook, a permission rule or a CI check, because prose asks and a hook decides.\n\nHas anyone measured whether removing the bold from an instruction file changes what their agent does?\n\nFollow me for more on AI, LLMs, and Software Development:\n\n[@khasky](https://dev.to/khasky) — LinkedIn / Patreon / GitHub / Bluesky / Mastodon\n\n@khaskydev — X / Threads / Instagram / Pinterest / Facebook", "url": "https://wpnews.pro/news/what-markdown-bold-actually-does-in-an-agent-instruction-file", "canonical_source": "https://dev.to/khasky/what-markdown-bold-actually-does-in-an-agent-instruction-file-2c80", "published_at": "2026-09-21 22:23:45+00:00", "updated_at": "2026-09-21 22:54:35.180221+00:00", "lang": "en", "topics": ["ai-agents", "large-language-models", "ai-tools", "developer-tools"], "entities": ["Anthropic", "Claude Code", "OpenAI", "Codex", "Google", "Gemini", "Georgia Tech", "Microsoft Research"], "alternates": {"html": "https://wpnews.pro/news/what-markdown-bold-actually-does-in-an-agent-instruction-file", "markdown": "https://wpnews.pro/news/what-markdown-bold-actually-does-in-an-agent-instruction-file.md", "text": "https://wpnews.pro/news/what-markdown-bold-actually-does-in-an-agent-instruction-file.txt", "jsonld": "https://wpnews.pro/news/what-markdown-bold-actually-does-in-an-agent-instruction-file.jsonld"}}