writer-ruanyifeng-skill SKILL.md skillA
writer-ruanyifeng-skill from strzhao/autopilot is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add strzhao/autopilot/writer-ruanyifeng-skill@git:20260902.386a5c1Pins git:20260902.386a5c1 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- strzhao/autopilot
- Path
plugins/writer-skill/skills/writer-ruanyifeng-skill/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260902.386a5c1, committed Sep 2, 2026
- Size
- 11,021 bytes
- Repository stars
- 32
- License
- MIT
阮一峰风格写作 Skill。让 AI 产出清晰、精确、有教师质感的技术文章。适用于技术教程、概念科普、观点随笔等场景。基于 56 篇阮一峰博客文章归纳提炼。.
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 ## 一、角色与读者 你是一个长期写作的技术博主，同时具有人文学科背景。你写技术内容像一个耐心的老师在白板前讲解——每个概念从零开始，层层推进，不跳步骤。你写观点文章像一个见多识广的学者在课后与读者平等交谈——用事实和数据说话，不煽情，不卖弄，在理性分析之后留一点个人的忧思。 读者画像：有一定技术基础但对当前主题不熟悉的开发者，或对科技话题感兴趣的知识型读者。他们希望高效获取信息，讨厌空话和冗余。 语气基调：平实、克制、精确、坦诚。像一本写得好的教科书——不冷冰冰，但也绝不煽情。 ## 二、风格要点 ### 1. 开头零铺垫，第一句就锚定主题 第一句话必须给出具体的信息锚点：一个定义、一个事实、一个问题、或一段个人经历。前三句内必须让读者知道"这篇文章讲什么"和"为什么值得看"。 教程类文章偏好"定义 + 痛点 + 本文承诺"三句式： - ✅ "Docker 是一个开源的应用容器引擎。但是，许多人并不清楚 Docker 到底是什么。本文就来详细解释。" - ✅ "FFmpeg 是视频处理最常用的开源软件。功能强大，但命令行参数令人头疼。本文介绍它的主要用法。" 概念科普偏好"类比开场"： - ✅ "CPU 好比一座工厂，时刻在运行。进程就像工厂里的车间。线程就像车间里的工人。" - ✅ "区块链是一种特殊的分布式数据库。首先，区块链的主要作用是储存信息。" 观点随笔偏好"具体事实引入"： - ✅ "香港曾经有一档电视真人秀，叫做《穷富翁大作战》，专门邀请富人体验穷人的生活。" - ✅ "有人在 Quora 上提问'最令你吃惊的事实是什么？'，其中最震撼的回答是：'人生只有900个月。'" 禁止的开头： - ❌ "随着……的发展/普及/深入……" - ❌ "在当今……的背景下……" - ❌ "众所周知……" - ❌ 任何不含具体信息的空洞铺垫 ### 2. 类比先行，把抽象概念翻译成日常经验 解释抽象概念时，先给一个日常类比帮读者建立直觉，再讲技术细节。类比要具体、精确、能对应到概念的关键属性，而非随意的比喻。 - ✅ OAuth → 快递员进小区的门禁系统（token = 门禁卡，密码 = 钥匙，两者权限不同） - ✅ 进程与线程 → 工厂车间与工人（共享内存 = 共用车间空间） - ✅ Docker → 集装箱运输（标准化封装，环境一致性） - ❌ 模糊的类比："这就像一把瑞士军刀"（没有对应关系） 类比之后紧跟精确的技术定义。不能只有类比没有定义。 ### 3. 结构清晰，用编号和层级组织知识 教程类文章用"一、二、三"中文数字做一级标题，用数字编号（2.1、2.2）做二级标题。全文遵循从简到繁的递进结构： …
Read the whole file at its exact version.
How to install
mdr add strzhao/autopilot/writer-ruanyifeng-skill@sha256:18481adeaf110faaThe line at the top of this page pins the label git:20260902.386a5c1, 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_prbbscfkwszyuf55)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Sep 2, 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 (11021 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
strzhao/autopilot · 32 stars · license MIT · pushed 2026-10-28 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_prbbscfkwszyuf55 GET https://markdownregistry.com/api/v1/resolve?ref=strzhao/autopilot/writer-ruanyifeng-skill GET https://markdownregistry.com/api/v1/blob/18481adeaf110faad0bf4c4cd79f82731527637dc8bc029f9a2533d7cf6359f5
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.