cw-style-skill-creator
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseStyle Skill Creator
风格技能创建工具
Create style skills that teach Claude your writing style.
创建能教Claude掌握你的写作风格的风格技能。
Critical: Audience is AI
关键提示：受众是AI
This creates AI instructions (for Claude to read), NOT human documentation (for authors to read).
| AI Instructions | Human Documentation |
|---|---|
| "When writing X, do Y" | "The story uses X because Y" |
| Directive commands | Explanatory descriptions |
| Pattern + examples | Analysis + reasoning |
此工具生成的是供Claude读取的AI指令，而非供作者阅读的人类文档。
| AI指令 | 人类文档 |
|---|---|
| "写X内容时，要做Y" | "故事使用X是因为Y" |
| 指令式命令 | 解释性描述 |
| 模式+示例 | 分析+推理 |
Step 1: Ask About Format
步骤1：询问格式偏好
Always ask first:
Would you like me to create:
1. Simple markdown file (.md)
- Quick, lightweight
- Single file with style instructions
2. Full skill package (.skill)
- Properly structured and validated
- Can include reference files with examples
- Better for complex styles
Which format would you prefer?务必先询问：
你希望我创建以下哪种格式：
1. 简单Markdown文件（.md）
- 快速、轻量化
- 包含风格指令的单个文件
2. 完整技能包（.skill）
- 结构规范且经过验证
- 可包含带有示例的参考文件
- 更适合复杂风格
你偏好哪种格式？Simple Markdown Format
简单Markdown格式
markdown
---
description: [What this style covers]
alwaysApply: false
---markdown
---
description: [此风格涵盖的内容]
alwaysApply: false
---[Style Name]
[风格名称]
[Brief intro]
[简短介绍]
[Category]
[分类]
[Directive instructions with examples]
**Location:** `.cursor/rules/styles/[name].md` or user-specified[带有示例的指令式说明]
**存储位置：** `.cursor/rules/styles/[自定义名称].md` 或用户指定位置Full Skill Package Format
完整Skill包格式
Initialize
初始化
bash
python /mnt/skills/examples/skill-creator/scripts/init_skill.py [skill-name] --path [output-dir]Creates directory structure with SKILL.md, references/, scripts/, assets/
bash
python /mnt/skills/examples/skill-creator/scripts/init_skill.py [技能名称] --path [输出目录]创建包含SKILL.md、references/、scripts/、assets/的目录结构
Customize
自定义内容
SKILL.md structure:
markdown
---
name: [skill-name]
description: Style skill for [specific writing type]
---SKILL.md结构：
markdown
---
name: [技能名称]
description: 针对[特定写作类型]的风格技能
---[Style Name]
[风格名称]
Purpose
目的
Teaches Claude to write [X] in the author's style.
教Claude以作者的风格撰写[X类型内容]。
[Style Instructions]
[风格说明]
[Directive instructions organized by category]
**Add reference files if helpful:**
- `references/examples.md` - Good/bad examples
- `references/patterns.md` - Detailed pattern library
**Delete unused directories** (scripts/, assets/ if not needed)[按分类组织的指令式说明]
**如有需要可添加参考文件：**
- `references/examples.md` - 正面/反面示例
- `references/patterns.md` - 详细的模式库
**删除未使用的目录**（如不需要可删除scripts/、assets/）Package
打包
bash
python /mnt/skills/examples/skill-creator/scripts/package_skill.py [path-to-skill] [output-dir]Creates validated file ready to distribute.
.skillbash
python /mnt/skills/examples/skill-creator/scripts/package_skill.py [技能路径] [输出目录]生成经过验证、可分发的.skill文件
Writing Style: Directive and Technical
写作风格：指令化与技术化
Use imperative/command form:
✅ "Use short sentences during action"
✅ "Avoid dialogue tags"
✅ "Show emotion through action"
❌ "The author tends to use short sentences" (that's analysis, not instruction)
✅ "Avoid dialogue tags"
✅ "Show emotion through action"
❌ "The author tends to use short sentences" (that's analysis, not instruction)
Always include examples:
markdown
**Emotional beats:**
- Use action instead of emotional labels
- Example: "Her hands trembled" not "She felt nervous"Pattern + Example format:
markdown
**[Pattern name]:**
- [Instruction about the pattern]
- Example: [Concrete example]
- Avoid: [What NOT to do]使用祈使/命令句式：
✅ "动作场景使用短句"
✅ "避免使用对话标签"
✅ "通过动作展现情绪"
❌ "作者倾向于使用短句"（这是分析，而非指令）
✅ "避免使用对话标签"
✅ "通过动作展现情绪"
❌ "作者倾向于使用短句"（这是分析，而非指令）
务必包含示例：
markdown
**情绪表达：**
- 用动作替代情绪标签
- 示例："她的双手在颤抖" 而非 "她感到紧张"模式+示例格式：
markdown
**[模式名称]:**
- [关于该模式的指令]
- 示例：[具体示例]
- 避免：[禁止操作]Common Style Skill Types
常见风格技能类型
Master Prose: Overall writing voice, sentence structure, tone
Dialogue: Tag usage, action beats, subtext, character voice
Action: Sentence length, detail level, pacing
Description: Sensory detail, metaphors, level of detail
Character Voice: Per-character speech patterns and vocabulary
Formatting: Em dashes, ellipsis, scene breaks, thought formatting
Dialogue: Tag usage, action beats, subtext, character voice
Action: Sentence length, detail level, pacing
Description: Sensory detail, metaphors, level of detail
Character Voice: Per-character speech patterns and vocabulary
Formatting: Em dashes, ellipsis, scene breaks, thought formatting
主散文风格： 整体写作语气、句式结构、语调
对话风格： 标签使用、动作节拍、潜台词、角色语气
动作场景风格： 句子长度、细节程度、节奏
描述风格： 感官细节、隐喻、详细程度
角色语气： 每个角色的说话模式与词汇
格式规范： 破折号、省略号、场景切换、心理活动格式
对话风格： 标签使用、动作节拍、潜台词、角色语气
动作场景风格： 句子长度、细节程度、节奏
描述风格： 感官细节、隐喻、详细程度
角色语气： 每个角色的说话模式与词汇
格式规范： 破折号、省略号、场景切换、心理活动格式
Creation Process
创建流程
1. Gather Input
1. 收集输入
From user description:
- "Describe your style to me"
- "What patterns should this cover?"
From existing prose:
- "Can I read some chapters to identify patterns?"
- Read 2-3 chapters if provided
从用户描述中获取：
- "向我描述你的写作风格"
- "此技能应涵盖哪些模式？"
从现有散文中获取：
- "我可以读几章来识别模式吗？"
- 如提供，阅读2-3章内容
2. Ask About Format
2. 询问格式偏好
Simple .md or full .skill package?
选择简单.md文件还是完整.skill包？
3A. Simple Path
3A. 简单流程
- Create markdown with sections
- Add directive instructions + examples
- Save to or specified location
.cursor/rules/styles/
- 创建带有章节的Markdown文件
- 添加指令式说明+示例
- 保存至或指定位置
.cursor/rules/styles/
3B. Full Skill Path
3B. 完整Skill包流程
- Run
init_skill.py - Edit SKILL.md with style instructions
- Add reference files if helpful
- Delete unused directories
- Run
package_skill.py - Provide download link
- 运行
init_skill.py - 编辑SKILL.md添加风格说明
- 如有需要添加参考文件
- 删除未使用的目录
- 运行
package_skill.py - 提供下载链接
Examples
示例
Dialogue Style (Simple .md)
对话风格（简单.md格式）
markdown
---
description: Dialogue writing conventions
alwaysApply: false
---markdown
---
description: 对话写作规范
alwaysApply: false
---Dialogue Style
对话风格
Dialogue Tags
对话标签
Minimize "said":
- Use action beats instead
- Example: She crossed her arms. "Fine."
- When using tags, prefer "said" to fancy verbs
尽量减少使用"said"：
- 用动作节拍替代
- 示例：她抱起胳膊。"好吧。"
- 若必须使用标签，优先用"said"而非花哨的动词
Interruptions
话语中断
Use em dashes:
- For interrupted speech: "I thought we could—"
- Example: "Wait, I—" He grabbed her arm.
使用破折号：
- 表示被打断的话语："我以为我们可以——"
- 示例："等等，我——" 他抓住了她的胳膊。
Subtext
潜台词
Characters avoid directness:
- Show tension through what's NOT said
- Example: "That's nice." (flat, clearly upset)
- Avoid: "I'm angry!" (too direct)
undefined角色避免直接表达：
- 通过未说出的内容展现张力
- 示例："那挺好的。"（语气平淡，显然很生气）
- 避免："我很生气！"（过于直接）
undefinedCharacter Voice
角色语气
markdown
---
name: character-amber-voice
description: Amber's voice and speech patterns
---markdown
---
name: character-amber-voice
description: Amber的语气与说话模式
---Character Voice: Amber
角色语气：Amber
Speech Patterns
说话模式
Careful word choice:
- Adult consciousness = measured speech
- Avoids contractions when stressed
- Example: "I do not want to go" not "I don't wanna go"
Politeness as defense:
- Overly formal when uncomfortable
- Uses "please" and "thank you" excessively
用词谨慎：
- 成熟的思维模式=措辞严谨
- 紧张时避免使用缩写
- 示例："我不想去" 而非 "I don't wanna go"
用礼貌作为防御：
- 感到不适时过于正式
- 过度使用"请"和"谢谢"
Internal Monologue
内心独白
Analytical:
- Observes and categorizes
- Example: "Dr. Fuji's hands trembled—stress response, possibly guilt."
undefined分析型：
- 善于观察与归类
- 示例："Fuji博士的手在颤抖——这是压力反应，可能源于愧疚。"
undefinedIntegration
集成流程
The workflow:
- User writes chapters naturally
- This skill converts patterns into style skills
- cw-prose-writing loads and follows those skills
- Result: Consistent AI-written prose in user's style
工作流：
- 用户自然撰写章节内容
- 本技能将写作模式转化为风格技能
- cw-prose-writing技能加载并遵循这些风格规则
- 结果：AI生成的散文与用户风格保持一致