Back to Details

skill-creator-thepexcel

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Creator (ThepExcel Edition)

技能创建工具（ThepExcel 版本）

Based on Anthropic's official skill-creator (Apache 2.0). Enhanced with ThepExcel deployment workflow and enhancement pipeline.
基于Anthropic 官方技能创建工具（Apache 2.0 许可证），新增了ThepExcel部署工作流和增强流程。

Quick Start

快速开始

ต้องการใช้ Modeไปที่
สร้าง skill ใหม่Create→ Creation Process
ปรับปรุง skill เดิมEnhance→ Enhancement Mode
ตรวจคุณภาพAudit only→ Audit Rubric
需求使用模式前往
创建新技能Create→ 创建流程
改进现有技能Enhance→ 增强模式
质量审核Audit only→ 审核评分标准

Core Principles

核心原则

Concise is Key

简洁至上

Context window เป็นทรัพยากรที่แชร์กัน — ทุกบรรทัดต้องจ่ายค่า token
Claude ฉลาดอยู่แล้ว → ใส่เฉพาะสิ่งที่ Claude ไม่รู้:
  • "Claude ต้องการคำอธิบายนี้จริงไหม?"
  • "ย่อหน้านี้คุ้มค่า token ไหม?"
上下文窗口是共享资源——每一行内容都会消耗token
Claude本身已经很智能了 → 只添加Claude不知道的信息：
  • "Claude真的需要这段解释吗？"
  • "这段内容值得消耗token吗？"

Degrees of Freedom

自由度等级

Levelเมื่อไหร่ตัวอย่าง
High (text)หลายวิธีถูกได้Code review guidelines
Medium (pseudocode)มี pattern ที่ preferReport template
Low (scripts)ต้องการ consistencyDatabase migrations
等级适用场景示例
高（文本）多种实现方式均可行代码评审指南
中（伪代码）有偏好的模式报告模板
低（脚本）需要一致性数据库迁移

Test with All Models

全模型测试

ModelCheck
Haikuให้ guidance พอไหม?
Sonnetชัดเจนและ efficient?
Opusไม่ over-explain?
模型检查要点
Haiku提供的指导是否足够？
Sonnet是否清晰高效？
Opus是否存在过度解释？

Skill Structure

技能结构

skill-name/
├── SKILL.md (required)     ← < 500 lines
│   ├── YAML frontmatter    ← name + description only
│   └── Markdown body       ← loaded when triggered
├── scripts/                ← deterministic code
├── references/             ← loaded as needed (one level deep)
└── assets/                 ← templates, not loaded into context
skill-name/
├── SKILL.md (必填)     ← < 500行
│   ├── YAML 前置元数据    ← 仅包含名称+描述
│   └── Markdown 主体内容       ← 触发时加载
├── scripts/                ← 确定性代码
├── references/             ← 按需加载（仅一级目录）
└── assets/                 ← 模板，不加载到上下文

Frontmatter Rules

前置元数据规则

FieldRules
name
Max 64 chars, lowercase + numbers + hyphens
description
Max 1024 chars, third person, what + when
字段规则
name
最多64字符，仅小写字母+数字+连字符
description
最多1024字符，第三人称，说明功能+触发场景

Description Best Practices

描述最佳实践

yaml
undefined
yaml
undefined

Good: what + when + triggers

优秀示例：功能+场景+触发词

description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs or document extraction.
description: 从PDF文件中提取文本和表格、填写表单、合并文档。 适用于处理PDF文件或用户提及PDF/文档提取的场景。

Bad: first person, vague

糟糕示例：第一人称、模糊不清

description: I can help you with PDFs.

**"When to Use" in body = useless** — Claude only sees description when deciding to trigger.
description: 我可以帮你处理PDF。

**主体内容中的"适用场景"毫无意义** —— Claude仅在决定是否触发技能时查看描述字段。

Naming Conventions

命名规范

PatternExamples
Verb-noun
design-business-model
, 
create-visualization
Noun-verb-ing
power-query-coaching
, 
problem-solving
Recognized terms
triz
, 
deep-research
模式示例
动词-名词
design-business-model
, 
create-visualization
名词-动名词
power-query-coaching
, 
problem-solving
通用术语
triz
, 
deep-research

Bundled Resources

捆绑资源说明

Typeเมื่อไหร่โหลดเข้า context?
scripts/Code ที่ใช้ซ้ำ, ต้อง deterministicไม่ (execute ตรง)
references/Docs ที่อ้างอิงระหว่างทำงานใช่ (on demand)
assets/Templates, logos, boilerplateไม่
ห้ามสร้าง: README.md, CHANGELOG.md, INSTALLATION_GUIDE.md — skills สำหรับ AI ไม่ใช่คน
类型适用场景是否加载到上下文？
scripts/可复用的确定性代码否（直接执行）
references/工作中需要参考的文档是（按需加载）
assets/模板、图标、样板代码否
禁止创建： README.md、CHANGELOG.md、INSTALLATION_GUIDE.md —— 技能是给AI用的，不是给人类开发者的

Progressive Disclosure

渐进式披露

LevelWhenLimit
MetadataAlways loaded~100 words
SKILL.md bodyWhen triggered< 500 lines
ReferencesAs neededUnlimited
Details: See progressive-disclosure.md
层级加载时机限制
元数据始终加载~100词
SKILL.md主体内容触发时加载< 500行
参考文档按需加载无限制
详情： 查看 progressive-disclosure.md

Creation Process

创建流程

Overview

总览

1. Understand → 2. Plan → 3. Init → 4. Edit → 5. Package → 6. Deploy → 7. Iterate
1. 需求理解 → 2. 规划 → 3. 初始化 → 4. 编辑 → 5. 打包 → 6. 部署 → 7. 迭代

Step 1: Understand

步骤1：需求理解

ถามผู้ใช้:
  • "Skill นี้ต้องรองรับ functionality อะไรบ้าง?"
  • "ยกตัวอย่าง 2-3 scenarios ที่จะใช้"
  • "ผู้ใช้จะพูดอะไรที่ควร trigger skill นี้?"
Tip: ใช้ 
/extract-expertise
สำหรับ domain ที่ซับซ้อน
询问用户：
  • "该技能需要支持哪些功能？"
  • "请列举2-3个使用场景"
  • "用户说什么话时应该触发这个技能？"
提示： 对于复杂领域，使用
/extract-expertise
工具

Step 2: Plan

步骤2：规划

วิเคราะห์แต่ละ example:
TaskRepeatable?Resource
Same code every timeYes → script
scripts/rotate_pdf.py
Same boilerplateYes → asset
assets/template/
Rediscovering infoYes → reference
references/schema.md
分析每个示例场景：
任务是否可重复？资源类型
每次都用相同代码是 → 脚本
scripts/rotate_pdf.py
重复使用相同样板是 → 资源
assets/template/
需要反复查阅的信息是 → 参考文档
references/schema.md

Step 3: Initialize

步骤3：初始化

bash
scripts/init_skill.py <skill-name> --path <output-directory>
bash
scripts/init_skill.py <skill-name> --path <输出目录>

Step 4: Edit

步骤4：编辑

Order: resources first → test scripts → update SKILL.md last
Design pattern references:
  • workflows.md — Sequential, conditional, loops
  • output-patterns.md — Templates, formatting
  • anti-patterns.md — Common mistakes
顺序： 先处理资源 → 测试脚本 → 最后更新SKILL.md
设计模式参考：
  • workflows.md —— 顺序流程、条件流程、循环
  • output-patterns.md —— 模板、格式
  • anti-patterns.md —— 常见错误

Step 5: Package & Validate

步骤5：打包与验证

bash
scripts/package_skill.py <path/to/skill-folder>
scripts/quick_validate.py <path/to/skill-folder>
bash
scripts/package_skill.py <技能文件夹路径>
scripts/quick_validate.py <技能文件夹路径>

Step 6: Deploy (ThepExcel)

步骤6：部署（ThepExcel）

┌─ Skill ใหม่
│   ├─ Public? (ใครก็ใช้ได้)  → /mnt/d/agent-skills/[skill-name]/
│   └─ Private? (เฉพาะพี่ระ)  → /mnt/d/claude-private/skills/[skill-name]/
│
├─ Symlink ไป global
│   └─ ln -s /mnt/d/[repo]/[skill-name] ~/.claude/skills/[skill-name]
│
├─ Update registry
│   └─ เพิ่มใน /mnt/d/claude-master/CLAUDE.md → Skills Inventory
│
└─ Commit & Push
    └─ git add → commit → push (ทั้ง skill repo + claude-master)
┌─ 新技能
│   ├─ 公开？（所有人可用）  → /mnt/d/agent-skills/[skill-name]/
│   └─ 私有？（仅限内部使用）  → /mnt/d/claude-private/skills/[skill-name]/
│
├─ 链接到全局目录
│   └─ ln -s /mnt/d/[仓库]/[skill-name] ~/.claude/skills/[skill-name]
│
├─ 更新注册表
│   └─ 添加到 /mnt/d/claude-master/CLAUDE.md → 技能清单
│
└─ 提交与推送
    └─ git add → commit → push（同时提交技能仓库 + claude-master）

Step 7: Iterate

步骤7：迭代

  1. ใช้ skill กับงานจริง
  2. สังเกตจุดที่ติดขัด
  3. ปรับปรุง (ใช้ Enhancement Mode)
See evaluation.md for Claude A/B testing pattern.
  1. 在实际工作中使用技能
  2. 记录遇到的问题
  3. 优化改进（使用增强模式）
查看 evaluation.md 了解Claude A/B测试模式。

Content Guidelines

内容指南

Avoid Time-Sensitive Information

避免时效性信息

markdown
undefined
markdown
undefined

Bad

糟糕示例

If you're doing this before August 2025, use the old API.
如果在2025年8月前使用，请调用旧版API。

Good

优秀示例

Current method

当前方法

Use the v2 API endpoint.
undefined
使用v2 API端点。
undefined

Use Consistent Terminology

术语一致性

เลือกคำเดียว ใช้ตลอดทั้ง skill:
GoodBad
Always "API endpoint"Mix "endpoint", "URL", "route"
Always "extract"Mix "extract", "pull", "get"
选择统一术语并全程使用：
优秀糟糕
始终使用"API端点"混用"端点"、"URL"、"路由"
始终使用"提取"混用"提取"、"拉取"、"获取"

Quality Checklist

质量检查清单

Core

核心要求

  • Description: what + when, third person, specific triggers
  • SKILL.md body < 500 lines
  • No time-sensitive info, consistent terminology
  • Concrete examples (not abstract)
  • References one level deep
  • 描述：功能+场景，第三人称，明确触发词
  • SKILL.md主体内容 < 500行
  • 无时效性信息，术语一致
  • 包含具体示例（非抽象描述）
  • 参考文档仅一级目录

Code

代码要求

  • Scripts handle errors, no magic constants
  • Required packages listed
  • Forward slashes (no Windows paths)
  • 脚本处理错误，无魔法常量
  • 列出所需依赖包
  • 使用正斜杠（避免Windows路径）

Testing

测试要求

  • Tested with real usage scenarios
  • Tested with target models
  • 已用真实场景测试
  • 已用目标模型测试

Enhancement Mode

增强模式

ใช้เมื่อ ปรับปรุง skill เดิม
适用于改进现有技能的场景

Route Decision

路径选择

ConditionPath
Quick fix (typo, small gap)Direct edit → skip audit
Significant upgradeFull pipeline below
条件处理路径
快速修复（错别字、小漏洞）直接编辑 → 跳过审核
重大升级执行以下完整流程

Full Enhancement Pipeline

完整增强流程

1. AUDIT → 2. RESEARCH → 3. INTEGRATE → 4. OPTIMIZE → 5. VALIDATE
1. 审核 → 2. 调研 → 3. 整合 → 4. 优化 → 5. 验证

Step 1: AUDIT

步骤1：审核

อ่าน target skill → score ด้วย audit rubric:
DimensionScore 1-5
Coverageครอบคลุม domain แค่ไหน?
DepthSurface-level หรือ expert?
StructureProgressive disclosure ดีไหม?
ActionabilityClaude execute ได้เลยไหม?
Examplesมี concrete examples ไหม?
Present ผลแบบนี้:
SKILL: [name]
SCORES: Coverage [?] | Depth [?] | Structure [?] | Actionability [?] | Examples [?]
TOTAL: [?]/25 → [Draft/Working/Solid/Production]

จุดที่ควรปรับ:
1. [ปัญหา + ผลกระทบ]
2. [ปัญหา + ผลกระทบ]
→ ถามผู้ใช้ก่อน: "ปรับทั้งหมด หรือเลือกเฉพาะข้อ?"
阅读目标技能 → 使用审核评分标准打分：
维度评分1-5
覆盖范围覆盖领域的广度？
深度表面级还是专家级？
结构渐进式披露是否合理？
可执行性Claude能否直接执行？
示例是否有具体示例？
结果呈现格式：
技能: [名称]
评分: 覆盖范围 [?] | 深度 [?] | 结构 [?] | 可执行性 [?] | 示例 [?]
总分: [?]/25 → [草稿/可用/完善/生产级]

需要改进的点:
1. [问题 + 影响]
2. [问题 + 影响]
→ 先询问用户： "需要全部改进还是只选部分？"

Step 2: RESEARCH

步骤2：调研

ใช้ 
/deep-research
หรือ 
/extract-expertise
เพื่อเติม knowledge gaps
使用
/deep-research
或
/extract-expertise
工具填补知识空白

Step 3: INTEGRATE

步骤3：整合

Classify findings → prioritize by impact → merge ด้วย integration patterns
对调研结果分类 → 按影响优先级排序 → 使用integration-patterns.md合并内容

Step 4: OPTIMIZE

步骤4：优化

Apply skill-creator standards: progressive disclosure, conciseness, references/
应用技能创建标准：渐进式披露、简洁性、参考文档规范

Step 5: VALIDATE

步骤5：验证

Before/after comparison:
| Dimension | Before | After | เปลี่ยนอะไร |
|-----------|--------|-------|------------|
→ Log ใน enhancement-log.md
前后对比：
| 维度 | 改进前 | 改进后 | 变更内容 |
|-----------|--------|-------|------------|
→ 记录到 enhancement-log.md

Enhancement Rules

增强规则

  • Research BEFORE writing — อย่าเดา domain knowledge
  • Preserve what works — enhance ไม่ใช่ rewrite
  • Show evidence — link findings to changes
  • 先调研再编写 —— 不要猜测领域知识
  • 保留有效内容 —— 是增强不是重写
  • 展示依据 —— 将调研结果与变更关联

Example: boost-intel Enhancement

示例：boost-intel技能增强

BEFORE: 17/25 (Solid) — Examples 2/5, Actionability 3/5
CHANGES:
  1. +Quick Mode (30-sec sanity check)
  2. +Facilitation Guide (how Claude walks through phases)
  3. Move CAPTURE → reference (reduce bloat)
  4. +Concrete example (WordPress vs CMS — full loop)
  5. Expand REFLECT (deeper questions + pattern recognition)
AFTER: 23/25 (Production) — all dimensions ≥ 4
改进前: 17/25（完善）—— 示例2/5，可执行性3/5
变更:
  1. +快速模式（30秒 sanity check）
  2. +引导指南（Claude如何分步执行）
  3. 将CAPTURE移至参考文档（减少冗余）
  4. +具体示例（WordPress vs CMS —— 完整流程）
  5. 扩展REFLECT环节（更深层次问题+模式识别）
改进后: 23/25（生产级）—— 所有维度≥4

Facilitation Guide

引导指南

Create Mode

创建模式

1. ถาม: "อยากสร้าง skill อะไรคะ? ช่วยยกตัวอย่าง 2-3 scenarios"
2. วิเคราะห์: public หรือ private? simple หรือ complex?
3. ถ้า complex → ใช้ /extract-expertise ก่อน
4. Init → Edit → Test → Package → Deploy
5. สรุป: "Skill [name] สร้างเสร็จแล้วค่ะ อยู่ที่ [path]"
1. 询问: "您想要创建什么技能？请列举2-3个使用场景"
2. 分析: 公开还是私有？简单还是复杂？
3. 如果复杂 → 先使用/extract-expertise工具
4. 初始化 → 编辑 → 测试 → 打包 → 部署
5. 总结: "技能[name]已创建完成，路径为[path]"

Enhance Mode

增强模式

1. อ่าน SKILL.md + references ทั้งหมด
2. Audit → present ผลเป็นตาราง
3. ถาม: "ปรับทั้งหมด หรือเลือกข้อ?"
4. ทำตามที่ user เลือก
5. Before/after comparison → commit
1. 阅读SKILL.md及所有参考文档
2. 审核 → 以表格形式呈现结果
3. 询问: "需要全部改进还是只选部分？"
4. 按用户选择执行
5. 前后对比 → 提交变更

Key Behaviors

关键行为

  • ถามก่อนทำ — ไม่ rewrite โดยไม่ถาม
  • Show scores — ผู้ใช้ต้องเห็นว่าอะไรดี อะไรไม่ดี
  • ทำทีละ step — ไม่ dump ทุกอย่างทีเดียว
  • 先询问再执行 —— 不要未经询问就重写内容
  • 展示评分 —— 用户需要清楚了解优缺点
  • 分步执行 —— 不要一次性输出所有内容

References

参考文档

FileContent
progressive-disclosure.mdLoading patterns (high-level, domain, conditional)
workflows.mdSequential, conditional, feedback loops
output-patterns.mdTemplates, examples, terminology
anti-patterns.mdCommon mistakes to avoid
evaluation.mdClaude A/B testing pattern
audit-rubric.mdQuality scoring (5 dimensions, 1-5 each)
integration-patterns.mdHow to merge findings into skills
enhancement-log.mdHistory of skill enhancements
文件内容
progressive-disclosure.md加载模式（高级、领域、条件）
workflows.md顺序流程、条件流程、反馈循环
output-patterns.md模板、示例、术语
anti-patterns.md需避免的常见错误
evaluation.mdClaude A/B测试模式
audit-rubric.md质量评分标准（5个维度，各1-5分）
integration-patterns.md调研结果整合方式
enhancement-log.md技能增强历史记录

Related Skills

相关技能

  • /extract-expertise
    — Extract expert knowledge to inform skill content
  • /deep-research
    — Research domain before building or enhancing skill
  • /optimize-prompt
    — Optimize skill descriptions and system prompts
  • /extract-expertise
    —— 提取专家知识用于技能内容
  • /deep-research
    —— 在构建或增强技能前调研领域知识
  • /optimize-prompt
    —— 优化技能描述和系统提示词