document-writing SKILL.md skillA

document-writing from wncfht/agent-basic-skill is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add wncfht/agent-basic-skill/document-writing@git:20261018.4f1e812

Pins git:20261018.4f1e812 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
wncfht/agent-basic-skill
Path
skills/document-writing/SKILL.md
Versions recorded
2
Latest version
git:20261018.4f1e812, committed Oct 18, 2026
First version recorded
Oct 18, 2026
Size
11,597 bytes
Repository stars
28
License
none declared

统一技术文档、调研笔记和仓库交付物的中文表达、证据论证、Markdown 格式与伪代码规范;编写或修改正式文档时使用。.

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。保持读者定位、术语、证据确定性和文件格式的一致性。

## 清晰与准确

以下原则参考 ASD-STE100[^asd-ste100],用于保持表达清晰,不要求或宣称符合该标准的受控英语规范。保留用户要求的语言、格式和语气,不把英文词数限制套到其他语言上。

| 检查项       | 要求                                                                                                           |
| ------------ | -------------------------------------------------------------------------------------------------------------- |
| 名称与指代   | 同一对象使用同一名称,保留准确的界面标签。代词有多个指代对象时直接写出对象,不补造缺失事实。                   |
| 条件与顺序   | 条件、例外、否定与所约束的动作写在一起。重排内容时保留前置条件、完成条件、先后顺序及必要条件与充分条件的区别。 |
| 义务与确定性 | 区分许可、建议、要求和能力;保留证据确定性,区分拟议、已开始与已完成的动作。                                   |
| 简洁与完整   | 简洁不能删去理解答案所需的原因和边界。清楚的原句可以保留,不强求短句或固定格式。                               |

## 中文表达

适用于所有中文输出。负面清单检查的是表达动作,换词但保留同一种空泛表达仍须修改;例词在语境中自然且有实际含义时按语义判断。明确禁用的词组遵守禁用规则。

### 措辞

1. 平实中文:中文现代、平实、直接,语法地道;句子完整,一句话只说一件事,避免晦涩复杂的长句。
2. 术语一致:首次出现交代中文名与英文全称或缩写,后文固定称呼。
3. 事实与因果:少用“显然”“不难发现”替读者下判断,直接写事实与因果。
4. 领域用语:使用领域已有术语,不生造专业文献中没有的词,不用夸张搭配、修辞与金句。
5. 正面叙述:避免反复用否定句限定边界,使叙述前后反复;必要的技术条件与否定判断写清楚。
6. 正文与标题:正文回避设问句和只强调文章结构的引导句。标题直接表达主题,不写设问句或仅去掉问词的口水话标题。
7. 禁用词组:禁用“相当具体”。

### AI 味与中文模式负面清单

逐段检查下列问题;同类问题合并检查,具体例子、改写要求和例外分别保留。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add wncfht/agent-basic-skill/document-writing@sha256:2e68571e46955912

The line at the top of this page pins the label git:20261018.4f1e812, 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_dmir5rieq3mjnyby.svg)](https://markdownregistry.com/a/art_dmir5rieq3mjnyby)

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

Versions

The registry has recorded 2 versions of this file, all committed on Oct 18, 2026.

versioncommittedcommitsizeaudit
git:20261018.4f1e812 latest2026-10-18 4f1e812 11,597 BA view · diff
git:20261018.6377c0f2026-10-18 6377c0f 11,421 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 (11597 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

wncfht/agent-basic-skill · 28 stars · license none declared · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dmir5rieq3mjnyby
GET https://markdownregistry.com/api/v1/resolve?ref=wncfht/agent-basic-skill/document-writing
GET https://markdownregistry.com/api/v1/blob/2e68571e46955912cc64af3674802759cdd049d9ad2758280ec5d3df8b4c86bb

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 wncfht/agent-basic-skill

asr SKILL.md skill
wncfht/agent-basic-skill · skills/asr/SKILL.md · 把音频或视频文件转录成 SRT 字幕或带时间戳的 TXT,词级时间戳。当用户想要语音转文字、转录、字幕、SRT 生成时使用——尤其是中文或英文音频 (transcription, subtitles…
git:20261018.e07a830 · audit A · 28 stars
conventional-commits SKILL.md skill
wncfht/agent-basic-skill · skills/conventional-commits/SKILL.md · 统一 Git 提交信息的 Conventional Commits 规范,帮助编写简洁、可审查且可自动化处理的提交。
git:20261018.f5dfb71 · audit A · 28 stars
figure-viz SKILL.md skill
wncfht/agent-basic-skill · skills/figure-viz/SKILL.md · 渲染可审计的研究图,双引擎一套调色板:符号/结构/机制图走 TikZ 轨(张量块图、流水线泳道、通信并行、注意力掩码、时间线谱系、分类板设计空间、pgfplots 混合示意、伪 3D 立体块),真实数据图表走 matplotlib…
git:20261018.c0ddc34 · audit A · 28 stars
link-get SKILL.md skill
wncfht/agent-basic-skill · skills/link-get/SKILL.md · 任意链接或裸 ID → 文本内容(Markdown / SRT / TeX 源)的统一入口。当用户粘贴 YouTube、Bilibili(视频/动态 opus)、知乎、微信公众号、SJTU Canvas、arXiv abs…
git:20261013.8b84045 · audit A · 28 stars
paper-search SKILL.md skill
wncfht/agent-basic-skill · skills/paper-search/SKILL.md · 在 arXiv、DBLP、OpenAlex、OpenReview、Semantic Scholar、Crossref 检索论文。找论文、related work、prior…
git:20261018.9aeed53 · audit A · 28 stars
peer-sessions SKILL.md skill
wncfht/agent-basic-skill · skills/peer-sessions/SKILL.md · 感知、通知与编排本机其他 Claude Code 会话。当用户要看别的会话在做什么、盯进度、发消息 push 方向,或要搭 overseer→leader→subagent…
git:20261018.f3b0b4f · audit A · 28 stars
setup-toolchain SKILL.md skill
wncfht/agent-basic-skill · skills/setup-toolchain/SKILL.md · 为仓库搭建 format/lint/pre-commit/CI 工具链(含 yaml 注释宽度检查)、agent 入口(AGENTS.md + .agents/skills 为入库唯一事实源,.claude/skills 为…
git:20261013.8b84045 · audit A · 28 stars
skill-management SKILL.md skill
wncfht/agent-basic-skill · skills/skill-management/SKILL.md · 维护本机三 CLI(Claude Code / Codex / Kimi Code)共用的 skills + AGENTS.md 体系:~/.agents 唯一事实源、软链布局、全局与仓库两级 skill…
git:20261018.e07a830 · audit A · 28 stars
video-render-pdf SKILL.md skill
wncfht/agent-basic-skill · skills/video-render-pdf/SKILL.md · 从 YouTube、Bilibili 或 SJTU Canvas 课堂实录的讲座、教程或技术分享视频生成专业、详尽、配图丰富的 LaTeX 课程笔记与最终 PDF。当用户提供 YouTube…
git:20261018.c0ddc34 · audit A · 28 stars

Every file in wncfht/agent-basic-skill

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