writing-refine SKILL.md skillA
writing-refine from kendrick-stein/mcislab_deepread is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add kendrick-stein/mcislab_deepread/writing-refine@git:20260805.b2d71d9Pins git:20260805.b2d71d9 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- kendrick-stein/mcislab_deepread
- Path
skills/4-writing/writing-refine/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260805.b2d71d9, committed Aug 5, 2026
- First version recorded
- Apr 28, 2026
- Size
- 9,196 bytes
- Repository stars
- 12
- License
- none declared
当 Supervisor 说"打磨一下""改改这段""逻辑不通顺""说人话"， 或 autoresearch 在写作阶段自检时， 从结构/清晰度/论据/机器味四个维度打磨已有文稿.
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
## Purpose
对已有文稿进行结构化打磨，从四个维度审视并生成具体修改建议：
- **structure**：逻辑链是否完整、段落过渡是否自然、论证顺序是否最优
- **clarity**：冗余表达、歧义措辞、过度抽象的概念是否需要具体化
- **evidence**：每个关键 claim 是否有 `[[wikilink]]` 支撑，引用是否恰当
- **ai-tells**：句子级的机器味——套话、假人味语气、模糊归属、增量锚定
默认行为：输出建议列表，由 Supervisor 确认后再执行修改。
---
## Steps
### Step 1 — 读取目标内容
读取 `target` 文件。如果指定了 `section`，定位到对应章节（通过标题匹配）。
```
Read(target)
# 若 section 非空，截取对应章节文本
```
记录文稿的基本信息：总字数（估算）、章节数、已有 `[[wikilink]]` 数量。
### Step 2 — 按维度审视
根据 `focus` 参数决定审视范围：
| focus 值 | 执行维度 |
|----------|----------|
| `structure` | 仅审视逻辑链与过渡 |
| `clarity` | 仅审视冗余/歧义/抽象 |
| `evidence` | 仅审视 claim-citation 匹配 |
| `ai-tells` | 仅审视机器味 |
| `all`（默认） | 四个维度全部审视 |
**structure 审视要点：**
- 段落首句是否清晰表达段落主旨？
- 段落间过渡是否有逻辑连词或过渡句？
- 论证路径是否遵循"问题 → 现有方法 → 不足 → 本文方案"？
- 是否存在论点跳跃（缺少中间推导步骤）？
**clarity 审视要点：**
- 是否有重复表达同一意思的冗余句子？
- 是否有模糊词（"一些"、"某种程度上"、"相关工作"）未加具体化？
- 是否有过长的从句可以拆分？
- 专业术语首次出现是否有解释？
**evidence 审视要点：**
- 每个"XX 方法表现更好/更差"等比较性 claim 是否有 `[[paper]]` 引用？
- 每个背景陈述（"现有方法普遍存在 X 问题"）是否有文献支撑？
- 已有 `[[wikilink]]` 是否指向实际存在的笔记（可用 Glob 验证）？
- 是否有孤立 claim（无任何引用支撑）？
**ai-tells 审视要点：**
先 `Read("references/writing-style.md")`，按其 §A 的四组逐条比对：
…Read the whole file at its exact version.
How to install
mdr add kendrick-stein/mcislab_deepread/writing-refine@sha256:62ce7d950fca6a8aThe line at the top of this page pins the label git:20260805.b2d71d9, 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_jxtibj4y72qm63em)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Apr 28, 2026 and Aug 5, 2026, about one every 99 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260805.b2d71d9 latest | 2026-08-05 | b2d71d9 | 9,196 B | A | view · diff |
| git:20260428.bf023ec | 2026-04-28 | bf023ec | 6,201 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 (9196 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
kendrick-stein/mcislab_deepread · 12 stars · license none declared · pushed 2026-10-19 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_jxtibj4y72qm63em GET https://markdownregistry.com/api/v1/resolve?ref=kendrick-stein/mcislab_deepread/writing-refine GET https://markdownregistry.com/api/v1/blob/62ce7d950fca6a8a6de44f5f92ef6828882d3ac9b3a618c6f3ec2c9258af291c
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.