Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/ruochenlyu/x2markdown/agents-mdgit clone --depth 1 https://github.com/RuochenLyu/x2markdownWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00369 | $0.00369 |
| Opus 5 | $0.00185 | $0.00185 |
| Sonnet 5 | $0.00074 | $0.00074 |
| Haiku 4.5 | $0.00037 | $0.00037 |
Grade A, and why
x2markdown AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
x2markdown 协作约定
本文件面向参与本仓库的 AI 编程代理,用来约束实现方式和文档风格。
基本约束
- 产品文案使用中文。
- 项目文档使用中文。
- 代码标识符、文件名和注释保持英文或中性技术命名。
- 许可证文件使用标准 MIT 英文正文。
技术边界
- 保持原生 Chrome Manifest V3。
- 默认不引入构建工具。
- 默认不引入运行时依赖。
- 不加入 React、Vite、TypeScript 或 UI 框架,除非仓库目标发生变化。
DOM 与提取策略
- 优先使用语义节点和稳定属性:
articletime[datetime]data-testidh1
- 不依赖混淆 class。
- 不依赖中英文
aria-label文案做主选择器。 - 选择器失效时,应优先明确报错,而不是输出残缺 Markdown。
改动原则
- 小步改动,避免把新功能、重构和依赖升级混在一起。
- 尽量先完成最小可验证闭环,再扩展功能。
- 不新增与当前展示型开源定位无关的流程文件。
- 不创建
CONTRIBUTING.md、issue 模板或 PR 模板。
验证要求
- 每次修改应至少做静态检查。
- 涉及 DOM 提取时,应给出手工验证步骤和预期结果。
- 如果无法完成浏览器内实测,需要在结果说明中明确指出。
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 42 lines · 369 tokens per session scan A 288fe3cf6e23
x2markdown AGENTS.md is an instructions file published in the GitHub repository RuochenLyu/x2markdown (11 stars, last pushed 2mo ago), licensed MIT. It adds 369 tokens to every session, about $0.0018 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
nanobrowser CLAUDE.md
Instructions for nanobrowser/nanobrowser, covering claude.md, project overview, development commands, workspace tips and architecture.
claude-chat-exporter CLAUDE.md
Instructions for agarwalvishal/claude-chat-exporter, covering claude.md, what this is, core design decision, how the export works and the install page & bookmarklet (docs/index.html).
AI-MarkDone copilot-instructions.md
Instructions for zhaoliangbin42/AI-MarkDone, covering ai copy enhance - ai coding agent instructions, project overview, architecture patterns, adapter pattern for multi-platform support and shadow dom isolation.
mcp-read-website-fast CLAUDE.md
Instructions for just-every/mcp-read-website-fast, covering claude.md, project overview, core modules & files, commands and development.
snag AGENTS.md
Instructions for p3bot/snag, covering agents.md, project overview, setup commands, clone repository and install dependencies.
AI-MarkDone AGENTS.md
Instructions for zhaoliangbin42/AI-MarkDone, covering ai-markdone engineering guide, project facts, read order, common commands and non-negotiables.