clear-technical-writing SKILL.md skillA
clear-technical-writing from nanless/audio-paper-digest is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add nanless/audio-paper-digest/clear-technical-writing@git:20261105.ad61539Pins git:20261105.ad61539 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- nanless/audio-paper-digest
- Path
skills/clear-technical-writing/SKILL.md- Versions recorded
- 4
- Latest version
- git:20261105.ad61539, committed Nov 5, 2026
- First version recorded
- Nov 2, 2026
- Size
- 10,460 bytes
- Repository stars
- 44
- License
- MIT
撰写、改写和审阅中文技术说明、研究解读、操作文档、提示词及工作汇报，面向本领域初学者，解释细致平实，组织清楚的段落和准确图示，避免黑话、无必要的中英混杂与生硬翻译，并保留事实、条件、术语和证据强度。适合需要让读者独立理解、操作或判断的内容；不用于判断作者身份或追求检测器分数。.
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
# 把技术写清楚 让读者知道发生了什么、为什么、能据此做什么。需要推导就完整推导，需要一句话就直接说明。用词、篇幅和格式都服从这个目的。默认用朴实、平和的文字，面向本领域初学者完整解释；用户明确指定读者或篇幅时，按实际任务调整。详细不等于堆满信息，简洁也不等于跳过必要步骤。 ## 何时使用与不适用 适合： - 撰写或改写中文技术说明、研究解读、操作文档、提示词和工作汇报，读者需要独立理解、操作或判断。 - 审阅已有文字的事实、结构、术语和可读性，并在修改中保留条件、数值与证据强度。 - 为初学者补足定义、中间步骤、例子和限制，同时不降低原有技术精度。 不适合： - 判断作者身份，或把通过写作检测器当作目标。本 skill 不评估文本由谁撰写，也不提供降低或提高检测器分数的方法。 - 代替事实、来源和协议核验。材料本身有误时，先核对来源，不能靠改句子解决。 - 越过项目规则改动术语、命令、权限、发布范围或执行限制。这些以项目文档和实际实现为准。 - 与文字表达无关的代码、配置或数据修改。 ## 先判断这份文字要做什么 动笔前确定读者、用途、已知背景和修改范围。能从上下文判断就继续，不为普通措辞选择反复询问。 | 内容 | 应交代的重点 | |---|---| | 给用户的进度与结果 | 已完成的实际动作、还未完成的部分、影响判断的原因或下一步 | | 技术或研究解读 | 具体问题、输入、处理步骤、输出、证据与适用条件 | | 操作说明 | 前提、动作、正常结果、失败后怎样继续 | | 参数或接口参考 | 名称、含义、类型、默认值、边界及必要示例 | | 设计说明或计划 | 问题、选择理由、代价、替代方案，以及实现与计划的界线 | | 提示词或执行规则 | 对象、任务、可用材料、输出协议、真实限制和失败处理 | 同一文件可以有不同用途，按章节分别处理，不套用一种口吻改完整个文件。 ## 面向初学者的成稿标准 读者可以不熟悉本领域，但不应被当作不能理解复杂问题的人。先说明具体任务、必要背景和涉及的对象，再解释步骤、原因、结果与限制。知识缺口用定义、衔接和有依据的例子补上，不能用“显然”“众所周知”“简单来说”略过推理。 先完整组织内容，再决定段落。一个完整意思独立成段；前提、操作、结果、例外或风险承担不同作用时，让它们在结构上有明显区分。几个紧密相连的句子保留为同一段，不能把一句一句换行当作层次。复杂条件可以分组列出，但必须保留它们之间的“同时满足”“任选其一”和先后关系。 中文正文采用自然、常用的中文。没有必要时不用英文动作、混合短语或临时缩写；正式名称、代码、字段和命令保持精确，在第一次需要理解时解释中文含义。读者需要的是对象的作用，而不只是英文后面附一个生硬译名。翻译拿不准时回到定义，不自造听起来高深的新词。 …
Read the whole file at its exact version.
How to install
mdr add nanless/audio-paper-digest/clear-technical-writing@sha256:543ce38da65b9684The line at the top of this page pins the label git:20261105.ad61539, 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_7kmywtf5zsa73to6)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Nov 2, 2026 and Nov 5, 2026, more than one a day.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261105.ad61539 latest | 2026-11-05 | ad61539 | 10,460 B | A | view · diff |
| git:20261104.bb55037 | 2026-11-04 | bb55037 | 8,495 B | A | view · diff |
| git:20261102.eb86c77 | 2026-11-02 | eb86c77 | 8,189 B | A | view · diff |
| git:20261102.d68f70c | 2026-11-02 | d68f70c | 6,138 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 (10460 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
nanless/audio-paper-digest · 44 stars · license MIT · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_7kmywtf5zsa73to6 GET https://markdownregistry.com/api/v1/resolve?ref=nanless/audio-paper-digest/clear-technical-writing GET https://markdownregistry.com/api/v1/blob/543ce38da65b968410696a7f4c09249208638d77f5cb0e1d899cd034efc53296
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.