
Writing Assistant
- 12 installs
- 108 repo stars
- Updated November 25, 2025
- ceeon/writing-assistant-skill
Guides self-media writing from topic selection to publishing with personas, method files, and a scored quality checklist.
About
An interactive writing assistant that routes across topic, outline, body, title, and layout methods with a scored publish checklist. A developer or creator uses it to draft, check, or diagnose underperforming articles.
- Interactive flow from topic selection through formatting (methods/01-05)
- Publish checklist with >=80% score gate and one-vote-veto rules
Writing Assistant by the numbers
- 12 all-time installs (skills.sh)
- Ranked #1,510 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Data as of Aug 1, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ceeon/writing-assistant-skill --skill writing-assistantAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 12 |
|---|---|
| repo stars | ★ 108 |
| Last updated | November 25, 2025 |
| Repository | ceeon/writing-assistant-skill ↗ |
What it does
Guides self-media writing from topic selection to publishing with personas, method files, and a scored quality checklist.
Files
写作助手
⚠️ 每次使用前必读
1. 读 about-me.md — 了解定位、禁区、术语降维 2. 读 user-personas.md — 了解3类用户、4层需求
---
文件索引
| 文件 | 内容 |
|---|---|
about-me.md | 定位、双品牌、5个主题池、禁区、术语降维 |
user-personas.md | 3类目标用户、4层需求、触达策略 |
content/methods/01-05 | 选题→大纲→正文→标题→排版 |
---
场景路由
| 场景 | 操作 |
|---|---|
| 写新文章 | 读 user-personas.md 确定≥3类人群 → 按 methods/01→05 执行 |
| 检查草稿 | 用检查清单打分,≥80分发布 |
| 诊断数据差 | 检查清单排查 → 读对应 methods/ |
| 取标题 | 读 methods/04-标题.md |
| 排版 | 读 methods/05-排版.md |
| 了解定位/禁区 | 读 about-me.md |
---
检查清单
≥80%发布,60-79%优化,<60%重做
选题 methods/01-选题.md
- [ ] 三维匹配:人×情境×信息定义清晰
- [ ] 市场洼地:搜索<10条
- [ ] 信息增量≥70%
- [ ] 覆盖≥3类人群(参考
user-personas.md)
大纲 methods/02-大纲.md
- [ ] 有"为什么"章节+3个理由
- [ ] 3-5个场景,≥3类人群
- [ ] 承诺:具体+可信+有吸引力
- [ ] ≤15章,40-60行/章
正文 methods/03-正文.md
- [ ] 抽象概念有图,操作有截图
- [ ] ≤5-7行/段
- [ ] 首段无术语(参考
about-me.md术语降维表) - [ ] 开头3秒:痛点/对比/反常识
标题 methods/04-标题.md
- [ ] 数字对比,倍数≥10倍
- [ ] 有戏剧性词汇
- [ ] 你妈妈能理解吗?
排版 methods/05-排版.md
- [ ] 只用H1/H2/H3
- [ ] 有序列表无空格(
1.项目) - [ ] 用
---换行 - [ ] 流程/步骤用 ASCII 图可视化
---
一票否决
- 无"为什么"章节
- <3个理由
- <3类人群
- 违反
about-me.md禁区
关于我
定位
- 领域:[你的领域,如:AI编程、健身、理财等]
- 目标:[你的目标,如:成为XX领域头部创作者]
- 受众:[你的受众,如:小白用户、开发者、职场人等]
双品牌(可选)
| 品牌 | 受众 | 形式 | 内容 |
|---|---|---|---|
| [品牌A] | 小白 | 视频 | 3-5分钟快速教程 |
| [品牌B] | 深度用户 | 图文 | 3000-5000字长文 |
主题池
1. [主题1] 2. [主题2] 3. [主题3] 4. [主题4] 5. [主题5]
禁区
- ❌ [不做的内容1]
- ❌ 高级内容为主(应80%基础+20%进阶)
- ❌ 跳过认知阶段
- ❌ 系列重复信息>30%
- ❌ 无先验调研的选题
- ❌ 单一人群内容(需≥3类)
术语降维
| 术语 | 降维表达 |
|---|---|
| [专业术语1] | [小白能懂的说法] |
| [专业术语2] | [小白能懂的说法] |
| [专业术语3] | [小白能懂的说法] |
01-选题
核心原则
>
1. 三维匹配:价值 = 人×情境×信息
2. 先验调研:不做调研=闭门造车
3. 市场洼地:搜索<10条=早期,>100条=晚期
4. 信息增量≥70%:重复内容=浪费时间
---
三维匹配法
价值 = 人 (Who) × 情境 (Context) × 信息 (What)
任何一维为0,价值就为0维度1:人 (Who)
人 = 认知结构 + 技能基础 + 资源约束
- 认知结构:知道什么,不知道什么
- 技能基础:会做什么,不会做什么
- 资源约束:时间/金钱/注意力维度2:情境 (Context)
情境 = 触发事件 + 当前状态 + 期望状态 + 行动阻碍
- 触发事件:什么事让他需要这个信息
- 当前状态:他现在在哪里
- 期望状态:他想到哪里
- 行动阻碍:什么阻止他到达维度3:信息 (What)
信息 = 信息增量 + 认知门槛 + 行动成本
- 信息增量:缩短"当前→期望"的距离
- 认知门槛:理解需要多少背景知识
- 行动成本:应用需要多少资源---
先验调研
必做步骤:
1. 搜索:小红书/知乎/微信搜一搜
2. 数量判断:
- <10条 = 早期市场(金矿)
- 10-100条 = 中期市场(可做)
- >100条 = 晚期市场(换主题)
3. 质量判断:现有内容好不好?有没有空间?---
市场洼地判断
搜索结果数量:
├─ <10条 → 金矿,快速介入
├─ 10-100条 → 中期,需要差异化
└─ >100条 → 晚期,建议换主题---
信息增量检查
□ 新信息占比 ≥ 70%?
□ 与现有内容有差异化?
□ 提供了新视角/新方法?---
检查清单
□ 三维匹配定义清晰?
□ 做了先验调研?
□ 市场洼地(搜索<10条)?
□ 信息增量≥70%?
□ 覆盖≥3类人群?02-大纲
核心原则
>
1. 销售漏斗4阶段:认知→兴趣→决策→行动
2. 承诺设计:承诺 = 实际价值 × 0.8
3. 必须有"为什么"章节:≥3个理由
4. 章节密度:40-60行/章最佳
---
销售漏斗4阶段
认知 → 兴趣 → 决策 → 行动
│ │ │ │
↓ ↓ ↓ ↓
为什么 适合我 怎么做 下一步
要用? 吗? 学什么?阶段1:认知(必须≥3个理由)
用户心理:为什么要用?
回答方式:
- 理由1:[解决什么问题]
- 理由2:[带来什么好处]
- 理由3:[为什么现在要用]
⚠️ 这是最常被跳过的阶段!阶段2:兴趣
用户心理:适合我吗?
回答方式:
- 场景1:"你是不是遇到过..."
- 场景2:"当你想要..."
- 场景3:"如果你正在..."
目标:3-5个场景,覆盖≥3类人群阶段3:决策
用户心理:难学吗?
回答方式:
- 详细步骤
- 截图演示
- 强调"简单"、"只需X步"阶段4:行动
用户心理:接下来学什么?
回答方式:
- 80%基础内容
- 20%进阶内容
- 标注:必学/可选---
承诺设计
承诺 = 实际价值 × 0.8
原则:稍微低承诺,超额交付承诺强度
| 承诺类型 | 强度 | 示例 |
|---|---|---|
| 强承诺 | 高 | "3分钟学会XX" |
| 中承诺 | 中 | "XX完整指南" |
| 弱承诺 | 低 | "聊聊XX" |
---
章节密度
最佳密度:40-60行/章
<40行/章:内容太稀疏
>60行/章:信息过载---
检查清单
□ 有"为什么"章节?
□ 认知阶段≥3个理由?
□ 3-5个场景?
□ 覆盖≥3类人群?
□ 承诺:具体+可信+有吸引力?
□ ≤15章?
□ 40-60行/章?03-正文
核心原则
>
1. 视觉优先:图像处理50ms,文字200ms
2. 块化阅读:段落≤5-7行
3. 术语降维:首段无术语或有解释
4. 开头3秒:痛点/对比/反常识
---
视觉优先
处理速度:
图像 50ms >> 文字 200ms
结论:抽象概念必须有图执行标准:
□ 抽象概念有图?
□ 操作步骤有截图?
□ 流程有流程图?---
块化阅读
1块 = 1个核心观点
1块 ≤ 5-7行
太长 → 拆分
太短 → 合并段落结构:
观点(1行)
↓
解释(2-3行)
↓
例子/证据(2-3行)---
术语降维
原则:首段无术语,或有即时解释
降维模板:
[术语],就是[小白能懂的说法]
示例:
- API → "程序之间的对话接口"
- Token → "AI的阅读成本"检查:
□ 首段无术语?
□ 必须用术语时有解释?
□ 用类比让小白理解?---
开头3秒
三种开头方式:
方式1:痛点前置
"你是不是遇到过这个问题:[具体痛点]"方式2:对比冲击
"以前需要[旧方法],现在只需要[新方法]"方式3:反常识
"大多数人以为[错误认知],其实[正确认知]"---
检查清单
□ 抽象概念有图?
□ 操作有截图?
□ ≤5-7行/段?
□ 首段无术语?
□ 开头3秒:痛点/对比/反常识?04-标题
核心原则
>
1. 数字冲击:倍数≥10倍
2. 戏剧性词汇:激发好奇心
3. 门槛降低:小白能理解
---
核心公式
标题吸引力 = 数字对比 × 戏剧性 × 低门槛三要素缺一不可:
- 只有数字 → 缺乏情绪
- 只有戏剧性 → 像标题党
- 门槛太高 → 看不懂
---
数字对比
大脑处理速度:
数字 <100ms
术语 500-1000ms
描述 1000-2000ms
结论:数字 = 最快触达倍数要求:
<10倍:冲击力不足
≥10倍:数量级差异,足够震撼示例:
❌ "效率提升2倍"
✅ "效率提升10倍"
✅ "从3小时→15分钟"---
戏剧性词汇
高吸引力词汇:
- 秘密、真相、颠覆
- 终极、完整、一文搞定
- 踩坑、避坑、血泪教训示例:
❌ "XX使用教程"
✅ "XX终极指南:3分钟上手"---
门槛降低
原则:你妈妈能理解吗?
方法:
1. 避免直接用术语
2. 用结果代替过程
3. 用场景代替概念示例:
❌ "MCP Server配置教程"
✅ "让AI帮你自动打车"---
标题模板
模板1:数字对比型
从[旧数字]到[新数字]:[主题]模板2:时间承诺型
[X分钟]学会[主题]模板3:问题解决型
[痛点]?[方案]帮你搞定---
检查清单
□ 有数字对比?
□ 倍数≥10倍?
□ 有戏剧性词汇?
□ 你妈妈能理解吗?05-排版
核心原则
>
1. 三级标题:只用H1/H2/H3
2. 公众号适配:有序列表无空格
3. 换行标记:用 --- 换行4. 流程可视化:用 ASCII 图
---
三级标题系统
只用3级标题:H1 / H2 / H3
四级以上 → 层级混乱标题规范:
| 标题 | 用途 |
|---|---|
| H1 | 主要章节 |
| H2 | 子章节 |
| H3 | 小节 |
---
公众号适配
有序列表格式
✅ 正确:
1.项目一(数字后直接接内容)
2.项目二
❌ 错误:
1. 项目一(数字后有空格)
2. 项目二换行标记
用 `---` 产生大间距
段落1
---
段落2---
ASCII 可视化
流程/步骤必须用 ASCII 图:
步骤1 → 步骤2 → 步骤3复杂流程:
┌─────────┐ ┌─────────┐
│ 输入 │ → │ 输出 │
└─────────┘ └─────────┘循环流程:
┌──────────────┐
│ │
↓ │
步骤1 → 步骤2 → 步骤3---
检查清单
□ 只用H1/H2/H3?
□ 有序列表无空格(`1.项目`)?
□ 用 `---` 换行?
□ 流程/步骤用 ASCII 图?Writing Assistant Skill
自媒体写作助手 Skill,帮助完成从选题到发布的完整流程。
安装
# 复制到 Claude Code skills 目录
cp -r writing-assistant ~/.claude/skills/文件结构
writing-assistant/
├── SKILL.md # 入口(场景路由+检查清单)
├── about-me.md # 关于我(定位+禁区+术语降维)⬅️ 需自定义
├── user-personas.md # 用户画像(3类用户+4层需求)⬅️ 需自定义
└── content/methods/
├── 01-选题.md # 三维匹配法
├── 02-大纲.md # 销售漏斗+承诺设计
├── 03-正文.md # 认知科学+可视化
├── 04-标题.md # 数字冲击力法
└── 05-排版.md # 公众号适配使用前必做
1. 编辑 `about-me.md` — 填入你的定位、禁区、术语降维表 2. 编辑 `user-personas.md` — 定义你的3类目标用户
使用流程
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 1. 读基础文件 │ → │ 2. 按阶段执行 │ → │ 3. 检查打分 │
│ │ │ │ │ │
│ about-me.md │ │ methods/01→05 │ │ ≥80% = 发布 │
│ user-personas │ │ 选题→大纲→正文 │ │ 60-79% = 优化 │
└─────────────────┘ └─────────────────┘ └─────────────────┘核心方法论
| 阶段 | 方法论 | 公式 |
|---|---|---|
| 选题 | 三维匹配法 | 价值 = 人 × 情境 × 信息 |
| 大纲 | 承诺设计法 | 承诺 = 实际价值 × 0.8 |
| 正文 | 认知科学 | 图像(50ms) >> 文字(200ms) |
| 标题 | 数字冲击力 | 吸引力 = 数字对比 × 戏剧性 × 低门槛 |
场景示例
"帮我检查一下这篇文章" → 用检查清单打分
"帮我写一篇关于XX的文章" → 按 methods/01→05 执行
"这篇数据不好,帮我诊断" → 检查清单排查License
MIT
用户画像
核心原则
- 必须≥3类人群
- 必须包含小白
- 从小白视角出发
---
3类目标用户
1. [用户类型1 - 小白](必须包含)⭐
- [特征描述]
- [痛点描述]
- 触达:[触达策略]
2. [用户类型2]
- [特征描述]
- 触达:[触达策略]
3. [用户类型3]
- [特征描述]
- 触达:[触达策略]
---
4层需求
| 层次 | 用户心理 | 我们的回答 |
|---|---|---|
| 认知 | 为什么要用? | [你的回答] |
| 兴趣 | 适合我吗? | [你的回答] |
| 决策 | 难学吗? | [你的回答] |
| 行动 | 接下来学什么? | [你的回答] |