mkdir -p .claude/skill/your-skill-name
cd .claude/skill/your-skill-name

---
name: your-skill-name
description: Brief description with trigger keywords and scenarios
---
 
# Your Skill Title
 
## When to Use This Skill
 
-User asks to [specific scenario]
-User mentions "[keyword]"
 
## How It Works
 
1.Step 1: [Action]
2.Step 2: [Action]
 
## Examples
 
**Input**: User request
**Output**: Expected result

# ❌ 过度详细
1.创建 Python 文件
2.导入必要的库
3.定义函数
4.编写主程序逻辑
 
# ✅ 简洁有效
使用 `scripts/api_client.py` 调用内部 API。
请求头必须包含 `X-Internal-Token`(从环境变量 `INTERNAL_API_KEY` 获取)。

SKILL.md (主文档, 200-500行)
├── reference.md (详细文档)
├── examples.md (完整示例)
└── scripts/ (可执行脚本)

---
name: skill-name-here
description: Clear description of what this skill does and when to activate it
---

# ❌ 过于泛化
description: Helps with code tasks
 
# ✅ 具体且包含关键词
description: Processes CSV files and generates Excel reports with charts. Use when user asks to convert data formats or create visual reports.
 
# ✅ 说明触发场景
description: Analyzes Python code for security vulnerabilities using bandit. Activates when user mentions "security audit" or "vulnerability scan".

skill-name/
└── SKILL.md

skill-name/
├── SKILL.md
├── templates/
│   └── template.md
└── scripts/
    └── script.py

✅ 好的命名:
- processing-csv-files
- generating-api-docs
- managing-database-migrations
 
❌ 不好的命名:
- csv (过于简短)
- data_processor (使用下划线)
- helper (过于模糊)

# ❌ 错误
description: I help you process PDFs
 
# ✅ 正确
description: Processes PDF documents and extracts structured data

## When to Use This Skill
 
-User asks to analyze Python code for type errors
-User mentions "mypy" or "type checking"
-User is working in a Python project with type hints
-User needs to add type annotations

## How It Works
 
1.Scan the project for all `.py` files
2.Run `mypy --strict` on each file
3.Parse error output and categorize by severity
4.Generate summary report with fix suggestions

## Workflow
 
1.**Check project type**
   -If Django → Use `django-stubs` config
   -If Flask → Use `flask-stubs` config
   -Otherwise → Use default mypy config
 
2.**Run type checking**
   -If errors found → Proceed to step 3
   -If no errors → Report success and exit

## Pre-deployment Checklist
 
Execute in order. Stop if any step fails.
 
-[ ] Run tests: `npm test` (must pass)
-[ ] Build: `npm run build` (no errors)
-[ ] Check deps: `npm audit` (no critical vulnerabilities)

## Examples
 
### Example 1: Basic Check
 
**User Request**: "Check my code for type errors"
 
**Action**:
1.Scan for `.py` files
2.Run `mypy` on all files
 
**Output**:
   
   Found 3 type errors in 2 files:
   src/main.py:15: error: Missing return type
   src/utils.py:42: error: Incompatible types
   

#!/usr/bin/env python3
"""
Brief description of what this script does.
Usage:
    python script.py <arg> [--option value]
"""
import argparse
DEFAULT_VALUE = 80  # Use constants, not magic numbers
def main():
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("directory", help="Directory to process")
    parser.add_argument("--threshold", type=int, default=DEFAULT_VALUE)
    args = parser.parse_args()
    # Validate inputs
    if not Path(args.directory).is_dir():
        print(f"Error: {args.directory} not found")
        return 1
    # Execute
    result = process(args.directory, args.threshold)
    # Report
    print(f"Processed {result['count']} files")
    return 0
if __name__ == "__main__":
    exit(main())

---
name: skill-name
description: Brief description with trigger keywords
---

# Skill Title
 
## When to Use This Skill
-Scenario 1
-Scenario 2
 
## How It Works
1.Step 1
2.Step 2
 
## Examples
### Example 1
...
 
## References
-[Link](url)