zh-teaching-prose SKILL.md skillA

zh-teaching-prose from penstic123-code/interactive-course-kit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add penstic123-code/interactive-course-kit/zh-teaching-prose@git:20261031.a540092

Pins git:20261031.a540092 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
penstic123-code/interactive-course-kit
Path
skills/zh-teaching-prose/SKILL.md
Versions recorded
5
Latest version
git:20261031.a540092, committed Oct 31, 2026
First version recorded
Oct 26, 2026
Size
17,491 bytes
Repository stars
5
License
MIT

用户定下的中文讲解文风:古典风格(平克《风格感觉》)+ 非虚构写作,"平实但高级",专门去掉 AI 腔。凡是写、改、审中文的讲解性文字都要先用它,包括课程章节、科普文章、教程、概念讲解、知识类长文、网页课程正文、讲稿;也用于"去 AI 味""读着不自然""改得更流畅""这段像 AI 写的""帮我润色这段讲解"这类请求,以及给写作或审读 agent 派任务时附上文风要求。即使用户没提"风格",只要产出的是给普通读者看的中文讲解长文,就用。.

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

# 中文讲解文风:古典风格 + 非虚构写作

用途:写、改、审中文讲解文字的文风规范。目标是**平实但高级**:读者感到在听一个懂行的人顺着好奇心往下讲,不是在看一张知识清单被逐条打勾,也读不出"这是 AI 写的"。

动笔前读 `references/examples.md`(用户的逐句修改和一段完整的诊断与改写),审稿时按 `references/review.md` 的清单逐句查。写课程还要看文末"写课程时另看"。

## 三层规则

| 层 | 性质 | 在哪一节 |
|---|---|---|
| 原则 | 必守,做法灵活:目的不能丢,具体手法可以换 | 两种风格的混合、古典风格的四个动作、读者知道什么、句子、段落、叙事与结构 |
| 偏好 | 用户的审美,项目可调:项目文档里另有规定的,以项目为准 | 偏好 |
| AI 腔信号 | 审稿时逐句检查的症状,不是硬禁令:单个看上下文,成串必改 | AI 腔信号 |

冲突时,原则优先于偏好,偏好优先于对信号的机械清除:为了避开某个信号而把意思写歪、写僵,不如保留它。例外:标"必须避免"的信号是用户逐段验收后定的,单个出现也改。

## 两种风格的混合

- **古典风格**:作者领着读者去看一样东西,两人的目光都落在那样东西上,不落在作者或读者自己身上。所以不写"我们来看""你会发现""下面我想说明",直接写看见了什么、它为什么是这样。
- **非虚构写作**:克制、洗练、有画面感。不用一惊一乍的口头禅("神挡杀神""那才叫真正的……"),靠叙事的推进感和点到为止的留白吸引人。留白指讲清事实就停,不替读者把感想说尽、不在段尾补升华;不是卖关子,该讲清的知识一样讲清。

做到"平实但高级"主要靠三个微调:讲历史或发明经过时顺着时间线走(先讲 1801 年的事,再讲 1805 年的事;讲概念、结构、用法时按读者的疑问顺序走);把概念融进句子里(古典风格第 1 条);去掉刻意的反差修辞(见"AI 腔信号")。

## 古典风格的四个动作

1. **擦掉"名词解释"的痕迹**。读者先看到现象,名字顺手点亮。
   ✗ "人们给这个现象起了个名字,叫 AI 效应。""只擅长一类事的 AI,叫专用人工智能。"
   ✓ "麦考黛克在《会思考的机器》里早就记下过这种'AI 效应':……""今天绝大多数 AI 都是这种只在一条赛道上运转的专用人工智能。"
   真要单独一句时,写得短而顺:✓ "这个设想后来被称为中文房间。"每段的推进方式也要换着来,不段段都走"举例 → 下定义",那正是"贴标签"感的来源。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add penstic123-code/interactive-course-kit/zh-teaching-prose@sha256:f0d91057692ad112

The line at the top of this page pins the label git:20261031.a540092, 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_6wxmylqh2i7cewjm.svg)](https://markdownregistry.com/a/art_6wxmylqh2i7cewjm)

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

Versions

The registry has recorded 5 versions of this file, between Oct 26, 2026 and Oct 31, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261031.a540092 latest2026-10-31 a540092 17,491 BA view · diff
git:20261028.0b7f99c2026-10-28 0b7f99c 17,052 BA view · diff
git:20261026.3c056232026-10-26 3c05623 17,234 BA view · diff
git:20261026.38aaf8c2026-10-26 38aaf8c 16,916 BA view · diff
git:20261026.f2dde162026-10-26 f2dde16 16,982 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 (17491 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

penstic123-code/interactive-course-kit · 5 stars · license MIT · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6wxmylqh2i7cewjm
GET https://markdownregistry.com/api/v1/resolve?ref=penstic123-code/interactive-course-kit/zh-teaching-prose
GET https://markdownregistry.com/api/v1/blob/f0d91057692ad112ba8b314a089ee634fa4ec8c55fda2f4808d687d3d760ff66

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 penstic123-code/interactive-course-kit

course-kit-en SKILL.md skill
penstic123-code/interactive-course-kit · skills/course-kit-en/SKILL.md · Visual and component toolkit for interactive learning web courses. It has a skin-independent component library…
git:20261028.0b7f99c · audit A · 5 stars
course-kit SKILL.md skill
penstic123-code/interactive-course-kit · skills/course-kit/SKILL.md · 互动学习网页课程的视觉与组件工具箱:按功能组织、与皮肤无关的组件库(概念卡、原理框、图解模板、例子轮播、试试看、收起支线、动手题引擎等),验收过的视觉皮肤(手绘笔记本、纸片、掌机像素、田野手账、贴纸拼贴),配图、交互、动效、阅读激励的规矩,…
git:20261031.a540092 · audit A · 5 stars
en-teaching-prose SKILL.md skill
penstic123-code/interactive-course-kit · skills/en-teaching-prose/SKILL.md · The user's house style for English explanatory prose, which pairs classic style (Steven Pinker, The Sense of Style)…
git:20261031.8fb83a4 · audit A · 5 stars

Every file in penstic123-code/interactive-course-kit

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