clear-communication SKILL.md skillA
clear-communication from dongshuyan/compass-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add dongshuyan/compass-skills/clear-communication@git:20261019.5bf1e5dPins git:20261019.5bf1e5d in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- dongshuyan/compass-skills
- Path
skills/clear-communication/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261019.5bf1e5d, committed Oct 19, 2026
- Size
- 5,049 bytes
- Repository stars
- 758
- 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
# 让读者准确理解 帮助读者找到答案、理解关系并完成当前任务。清楚和自然是手段；不能以删减必要信息或强化结论换取流畅。 ## 先确定信息，再选择结构 从请求和上下文判断读者知道什么、想解决什么。已有线索足够时直接写，不让用户额外填写受众问卷或寻找范文。只有缺失信息会改变结论或操作时才追问。 从材料中提取需要保留的事实、条件、例外、数字、否定、证据强度和执行状态。原回答也可能有错；改写应以可核对的原始材料为依据。材料冲突或不足时指出具体缺口，不补写合理但没有依据的细节。 按任务选择顺序： - 回答问题：直接回答，再解释成立的条件和理由。 - 解释概念：从当前读者需要理解的行为或问题切入，用一个有帮助的例子连接术语和机制；专业读者可以直接使用通行术语。 - 比较方案：围绕决策相关的差异组织，说明推荐在什么条件下成立。 - 报告进度或错误：说明实际状态、影响和下一步；让未验证的范围紧挨相关结论。 - 编写教程：按操作依赖排列步骤，把前提、检查方法和常见失败处理放到对应步骤附近。 - 学术写作：保留研究问题、论证关系、术语身份、限定条件和引用对应关系。遵守论文体裁；不擅自增加数据、引用、显著性、因果或新颖性主张。 这些是组织依据，不是每次必须出现的段落模板。 篇幅较长时，先用一句话确定读者读完应该明白什么或做什么。围绕它保留和排序信息：先让人获得足以理解或操作的一层，再补必要机制、依据和例外。读者问的是“现在怎么用”，就不要用实现细节做开头；读者在审查论证，则应先呈现结论成立的依据。不要把同一组信息分别重述为概述、正文和总结。 信息完整以读者的任务为准，不以原始记录的条数为准。先区分直接影响理解或操作的信息、需要时才查的信息，以及本次无关的记录。保留第一类；第二类只有确实有用时才作为短补充；第三类不搬进正文。这个取舍过程不用向读者展示。具体来说，上手说明应优先回答怎么开始、哪些功能尚不可用、如何启用可选功能或恢复；实现字段、事件名、测试计数和开发进度只有影响这些动作时才需要写出。不能因此删掉失败、尚未验证、恢复前提等重要限制。 ## 把关系写出来 让每句的动作、主体和指代容易辨认。连续出现抽象名词时，尝试写成“谁做了什么，产生什么结果”。拆长句时保留条件和因果，避免一串互不相连的短句。 熟悉的词足以表达同一含义时优先使用。术语有精确含义或读者需要检索它时应保留；解释它在这里如何工作，不按词典机械替换。一个概念保持同一个名称。 保留必要的逻辑桥梁：为什么这个事实支持这个结论、为什么先做这一步。例子和类比应说明机制或边界；假设例子标明是假设，不能变成新的事实依据。 …
Read the whole file at its exact version.
How to install
mdr add dongshuyan/compass-skills/clear-communication@sha256:a43dc264b21300cbThe line at the top of this page pins the label git:20261019.5bf1e5d, 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_3gplc5wz6zllnfic)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 19, 2026.
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 (5049 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
dongshuyan/compass-skills · 758 stars · license MIT · pushed 2026-10-19 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_3gplc5wz6zllnfic GET https://markdownregistry.com/api/v1/resolve?ref=dongshuyan/compass-skills/clear-communication GET https://markdownregistry.com/api/v1/blob/a43dc264b21300cbf9aa160c8cfa955231c8a5ac2d2bd4666df86eeb0e9670b9
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.