Claude Skills 写作指南:从0到1看完就会,不会来找我

495 阅读7分钟

💡 本文由 claude opus 4.5 + skills + Nano banana pro 辅助写作

嘿!我是成峰。


作为自媒体博主,AI 写作是常用场景。但每次写文章,都要:

1.找之前的提示词
2.复制粘贴到对话框
3.写完再找检查清单对照


太麻烦了。

而且提示词越写越长,Token 放不下,每次还要手动更新…


Skills 解决的就是这三个问题:

skills 优势


举个例子

传统提示词 vs skills


一、什么时候用 Skills?

判断标准

1.这个任务你会反复做吗?
2.你有一套方法论/检查清单吗?


两个都是 ✅ → 用 Skills

否则 → 不需要


常见适用场景

管理提示词

  • ✅ 写作检查(反复做 + 有检查清单)
  • ✅ 代码审查(反复做 + 有规范)
  • ✅ 周报生成(反复做 + 有模板)

对接 Nano banana API

群友用 Skills 对接了图片生成 API,说一句话就能出图:

群友 Skills 对接 Nano banana


不适合的场景

  • ❌ 一次性任务
  • ❌ 纯创意工作
  • ❌ 简单问答

后续还有更多场景,会分享给大家。


二、什么是 Skills?

一句话定义

Skills = 按需加载的提示词(上下文)管理系统


传统提示词是"一次性塞给 AI",Skills 是"AI 需要什么,才读什么"。


提示词可以是:

1.工作流
2.任务说明
3.代码


重要的是:Skills 是一个容器/框架

不是取代其他工具,而是组织和调用它们:

skills 管理

互补,不冲突!  ✅


实际体验是怎么样的

如何让写作skills 给内容打分

skills 检查文档


如何让写作skills 给出优化建议

skills 如何优化文档


就这么简单。背后的加载和检查,Skills 自动完成。

你也可以直接让 AI 根据 skills 来优化内容


体验下来,最大优势

Skills 可以通过 人+AI 管理笔记一样管理提示词——用文件夹组织,随时更新,版本可控。


三、Skills 原理:Claude 怎么用 Skills

先看:一个 Skill 长什么样

假设你做了一个「周报助手」:


文件结构

skills 文件长什么样


SKILL.md 里面有什么

**SKILL.md 长什么样


三层结构

  • 元数据(SKILL.md 头部):名称 + 简介
  • 指令(SKILL.md 正文):告诉 Claude 怎么做、读哪些文件
  • 资源(其他文件夹):模板、示例、方法论等

路径你自己定:写 templates/,Claude 就去读 templates/;写 docs/,就去读 docs/


场景:你说"帮我检查选题",Claude 做了什么?

第1步:启动时,提示词里已经有书架目录

当你打开 Claude Code,系统自动把所有 Skills 的「名称 + 简介」写进提示词:

系统提示词

Claude 不用去找,一开始就知道有哪些 Skills 可用。

关键:只有「名称 + 简介」,没有具体内容 → 省 Token


第2步:选书

你说"帮我检查选题"
→ Claude 匹配:哪个 Skill 的简介最相关?
→ 选中《写作助手》


第3步:翻目录(读 SKILL.md)

打开《写作助手》的 SKILL.md,看到指令和文件路径:

skill.md内容

你要"检查选题" → 找到路径 methods/03-market.md

路径是你自己定的,SKILL.md 里写什么路径,Claude 就去读什么文件。


第4步:读章节,执行任务

Claude 读取 methods/03-market.md,执行检查,返回结果:

✅ 受众明确
⚠️ 痛点需补充
✅ 选题有实用性


省了多少 Token?

只读了 1 个文件:330 token
如果读完整个 Skill:1000+ token

这就是「按需加载」的威力


四、从 0 开始写一个 Skill

3 步搞定

3个步骤


第1步:创建文件夹

在 ~/.claude/skills/ 下创建一个文件夹,名字就是你的 Skill 名称。

Claude Code 会自动识别这个目录下的所有 Skills


第2步:写 SKILL.md

---
name: my-skill
description: 一句话描述这个 Skill 能做什么
---

# 使用说明

当用户说「xxx」时:
1.读取 templates/xxx.md
2.执行 xxx 任务
3.返回结果

关键

  • name + description 是元数据,Claude 启动时自动加载
  • 正文是指令,告诉 Claude 怎么做

第3步:添加资源文件

~/.claude/skills/my-skill/
├── SKILL.md           ← 元数据 + 指令
└── templates/         ← 资源文件(你自己定义)
    └── xxx.md

资源文件夹的名字和结构你自己定,SKILL.md 里写什么路径,Claude 就读什么文件。


验证是否生效

"我有哪些可用的 Skills?"

Claude 应该能列出你刚创建的 Skill。


懒人方案:让 AI 帮你生成

不想手动写?直接用这个提示词:

帮我创建一个 Skill:

名称:[例如:weekly-report]
功能:[例如:帮我写周报]
使用场景:[例如:用户说"写周报"时,整理本周工作生成周报]

生成到:~/.claude/skills/[名称]/
包含:SKILL.md + 必要的资源文件

Claude 会自动帮你创建完整的 Skill 结构。


五、我的写作 Skills 实践

我的设计思路

我遇到过 3 个问题,所以设计了对应的解决方案:

写作问题

每个阶段有检查清单,写完打分:≥80% 发布,60-79% 优化,<60% 重写


文件结构

writing-assistant/
├── SKILL.md           # 入口
├── about-me.md        # 我是谁
├── user-personas.md   # 写给谁
└── content/methods/   # 怎么写(5个阶段)

使用流程

使用流程是怎么样的


怎么建立?

方法1:一键生成提示词

把你的定位、用户画像、方法论喂给 AI,一键生成完整 Skill。完整模板见附录 A。


方法2:直接用我的模板

复制 https://github.com/Ceeon/writing-assistant-skill
到 ~/.claude/skills/

然后修改 about-me.md 和 user-personas.md 成你自己的。


持续迭代:越用越强

正向循环


成功了 ✅

“这篇文章数据很好,帮我分析成功原因,更新 methods”

案例:CLI 教程 1000+ 赞

  • 覆盖 3 类人群
  • 内容密度好(54 行/章)
  • 小白化表达

失败了 ❌

“这篇数据不好,帮我诊断问题,更新 methods”

案例:拓展插件教程数据差

  • 跳过认知阶段
  • 信息重复 60%
  • 受众太窄

看到好方法 💡

“我看到一个好观点:[方法论],帮我加到 methods 里”

案例:罗永浩播客里 Tim 说"短视频合集 > 短视频"

  • 生成检查项:“是否符合合集逻辑?”

迁移到新项目

直接拷贝文件夹:~/.claude/skills/writing-assistant/

Claude Code 自动识别,无需配置。


六、我的完整写作工作流

写作流程


写作前:找素材

  • 小红书 → 搜关键词,看高互动话题
  • 公众号监控 → 看阅读量高的文章,学结构

写作中:语音口述 + Skills 检查

语音口述

工具:闪电说

  • 先说痛点 → 读者为什么要看
  • 再说方案 → 我要教什么
  • 逐步展开 → 每个要点
  • 最后总结 → 读者能得到什么

Skills 辅助检查

我:帮我检查一下这篇文章

Claude:
✅ 覆盖人群:3类
✅ 章节密度:合理
⚠️ 第七章内容较薄,建议补充示例

得分:85/100,可以发布

方法论在 Skills 里,Claude 自动检查,不用手动对照清单


发布前:排版

工具:Obsidian + AI 排版插件

  • 写完 Markdown → 一键转换格式 → 复制到公众号

发布后:迭代 Skills

成功了

我:这篇文章数据很好,帮我分析成功原因,更新 workflows

Claude:分析结果... 已更新 workflows/选题检查.md

失败了

我:这篇数据不好,帮我诊断问题,更新 workflows

Claude:诊断结果... 已更新 workflows/结构检查.md,加入警示

这样 Skills 会越来越强!


附录 A:完整生成提示词模板

第五章提到的完整版,直接复制使用

我要创建一个 [领域] Skill,帮我生成完整结构。

## 基本信息
- Skill 名称:[例如:writing-assistant]
- 领域:[例如:自媒体写作]
- 使用场景:[例如:检查文章质量、诊断数据不佳原因]

## 文件位置
生成到:~/.claude/skills/[skill名称]/

## 核心功能
我需要这个 Skill 帮我:
1. [功能1 - 例如:写作前的选题检查]
2. [功能2 - 例如:写作中的结构优化]
3. [功能3 - 例如:发布前的终审打分]

## 我的定位
[about-me.md 内容]

## 检查框架
- 写作前:目标用户、选题验证、先验调研
- 写作中:结构检查、表达优化
- 发布前:标题优化、终审打分
- 发布后:数据诊断

## 我的成功案例
[粘贴你的成功案例]

## 我的失败教训
[粘贴你的失败教训]

## 我的方法论
[粘贴你学到的方法论]

## 架构要求
1.生成完整的 YAML frontmatter(name + description)
2.在 workflows/ 目录创建独立的检查文件
3.每个 workflow 包含:
   - 具体检查项(checkbox 格式)
   - 重要程度标注(⭐数量)
   - 我的成功/失败案例对照
4.使用渐进式披露结构(SKILL.md 引用 workflows)

## 输出格式
请按照以下结构生成所有文件内容:
1.先生成目录结构说明
2.然后逐个文件输出完整内容
3.最后提供安装和验证步骤

附录 B:更多 Skills 资源

官方 Skills 案例:github.com/anthropics/…