skill-creator/
├── SKILL.md              # 核心指南，只有357行
├── references/           # 参考文档
│   ├── output-patterns.md    # 输出模式
│   └── workflows.md          # 工作流模式
└── scripts/              # 辅助脚本
    ├── init_skill.py         # 技能初始化
    ├── package_skill.py      # 打包验证
    └── quick_validate.py     # 快速验证

---
name: skill-creator
description: |
  指导如何创建有效的技能。当用户想要创建新技能或更新已有技能时使用，
  这些技能可以通过专业知识、工作流程或工具集成来扩展Agent的能力。
license: MIT
---

级别1：元数据（name + description）
       始终加载，大概100个token
       
级别2：SKILL.md正文
       技能被触发时才加载，建议5000 token以内
       
级别3：脚本和参考资料
       按需加载，需要时才读

description: |
  全面的文档创建、编辑和分析能力，支持修订跟踪、评论、格式保留和文本提取。
  当Agent需要处理专业文档(.docx文件)时使用，包括：
  (1) 创建新文档
  (2) 修改或编辑内容
  (3) 处理修订跟踪
  (4) 添加评论
  或其他任何文档相关任务

description: "帮助处理PDF文件"

python scripts/init_skill.py <技能名> --path <输出目录>

python scripts/package_skill.py <技能文件夹路径>

技能名/
└── SKILL.md          # 必需

---
name: 技能名                    # 必需，1-64字符
description: 技能做什么          # 必需，1-1024字符
license: MIT                    # 可选
compatibility: 兼容性要求        # 可选
metadata:                       # 可选
  author: 作者名
  version: "1.0"
---
# 正文

docx-processor/
├── SKILL.md
├── scripts/
│   ├── extract_text.py
│   ├── add_toc.py
│   └── convert_format.py
├── references/
│   ├── ooxml-reference.md
│   └── formatting-guide.md
└── assets/
    └── letterhead-template.docx

---
name: docx-processor
description: |
  全面的Word文档(.docx)处理能力，包括文本提取、目录生成、格式转换。
  当用户需要处理Word文档、创建报告、转换格式或提取内容时使用。
  
  触发场景：
  - 提到"Word文档"、".docx"
  - 请求创建报告、备忘录
  - 需要目录、页码、页眉页脚
  - 提取或重组文档内容
license: MIT
metadata:
  author: your-name
  version: "1.0"
---

python scripts/extract_text.py 文档.docx

python scripts/add_toc.py 文档.docx

python scripts/convert_format.py 输入.docx 输出.pdf

from docx import Document

doc = Document('assets/letterhead-template.docx')
doc.add_paragraph('正文内容...')
doc.save('output.docx')

#!/usr/bin/env python3
"""
提取Word文档中的文本
用法：python extract_text.py <文档.docx>
"""

import sys
from docx import Document

def extract_text(docx_path):
    doc = Document(docx_path)
    paragraphs = [para.text for para in doc.paragraphs if para.text.strip()]
    return '\n\n'.join(paragraphs)

def main():
    if len(sys.argv) != 2:
        print('用法：python extract_text.py <文档.docx>')
        sys.exit(1)
    
    docx_path = sys.argv[1]
    
    try:
        text = extract_text(docx_path)
        output_path = docx_path.replace('.docx', '.txt')
        
        with open(output_path, 'w', encoding='utf-8') as f:
            f.write(text)
        
        print(f'文本已提取：{output_path}')
        
    except Exception as e:
        print(f'错误：{e}')
        sys.exit(1)

if __name__ == '__main__':
    main()

#!/usr/bin/env python3
"""
为Word文档添加目录
用法：python add_toc.py <文档.docx>
"""

import sys
from docx import Document

def add_table_of_contents(docx_path):
    doc = Document(docx_path)
    
    # 在开头插入目录标题
    first_para = doc.paragraphs[0]
    toc_title = first_para.insert_paragraph_before('目录')
    toc_title.style = 'Heading 1'
    
    # 收集标题并生成目录项
    prev_para = toc_title
    for para in doc.paragraphs:
        if para.style.name.startswith('Heading'):
            level = int(para.style.name.replace('Heading ', ''))
            indent = '    ' * (level - 1)
            text = para.text.strip()
            if text:
                toc_item = prev_para.insert_paragraph_before(f'{indent}{text}')
                prev_para = toc_item
    
    # 保存
    output_path = docx_path.replace('.docx', '-with-toc.docx')
    doc.save(output_path)
    return output_path

def main():
    if len(sys.argv) != 2:
        print('用法：python add_toc.py <文档.docx>')
        sys.exit(1)
    
    docx_path = sys.argv[1]
    
    try:
        output_path = add_table_of_contents(docx_path)
        print(f'目录已添加：{output_path}')
    except Exception as e:
        print(f'错误：{e}')
        sys.exit(1)

if __name__ == '__main__':
    main()