AgentSkillsCN

pix-skill-creator

当用户请求创建新的代理技能时，应使用此技能。可通过“创建技能”、“构建代理”、“开发技能”、“制作技能”、“生成代理”、“创建代理技能”等短语触发。此技能遵循 Trae Skills 架构，提供结构化的指导，帮助您按照 SKILL.md 格式、激活模式与最佳实践，完整地创建代理技能。

SKILL.md
--- frontmatter
name: pix-skill-creator
description: This skill should be used when the user asks to create a new agent skill. Activates with phrases like create skill, build agent, develop skill, make skill, generate agent, create agent skill. Provides structured guidance for creating complete agent skills following Trae Skills architecture, including SKILL.md format, activation patterns, and implementation best practices.

pix-skill-creator 技能

📂 基础信息

属性值
名称pix-skill-creator
版本1.0.0
类型元技能 (Meta-Skill)
核心功能生成 agent skill
适用环境Trae

🎯 核心目标

pix-skill-creator 是一个元技能，旨在帮助用户创建完整的 agent skill，遵循 Trae Skills 架构和最佳实践。它提供结构化的指导，从技能设计到实现的全过程。

解决的问题

痛点解决方案
不知道如何创建 agent skill提供完整的技能创建流程
不熟悉 SKILL.md 格式规范详细的格式指南和模板
技能激活不生效激活条件配置指南
技能结构不规范标准化的技能结构模板

🛠️ 技能创建流程

当用户请求创建 agent skill 时，pix-skill-creator 会引导用户完成以下 5 个阶段：

阶段 1: 需求分析

目标：理解用户的技能需求，确定技能的核心功能和适用场景。

流程：

  1. •分析用户的技能需求
  2. •确定技能的核心功能
  3. •识别技能的适用场景
  4. •定义技能的激活条件

阶段 2: 结构设计

目标：设计技能的目录结构和文件组织。

流程：

  1. •选择技能类型（简单技能或复杂技能套件）
  2. •设计目录结构
  3. •规划文件组织
  4. •确定命名规范

阶段 3: 内容创作

目标：创建技能的核心文件内容，包括 SKILL.md。

流程：

  1. •创建 SKILL.md 文件
  2. •编写技能描述和功能说明
  3. •设计技能的激活模式

阶段 4: 实现指南

目标：提供技能实现的详细指南，包括代码结构和最佳实践。

流程：

  1. •提供代码结构模板
  2. •分享实现最佳实践
  3. •指导错误处理和边界情况
  4. •建议测试策略

阶段 5: 测试与部署

目标：指导用户测试和部署技能。

流程：

  1. •提供技能测试方法
  2. •指导技能部署步骤
  3. •建议技能维护策略
  4. •分享技能优化技巧

📋 SKILL.md 格式规范

必要内容

YAML 前端内容（文件开头）：

yaml
---
name: skill-name
description: This skill should be used when... Activates with phrases like... Provides...
---

核心部分：

  1. •技能名称和描述
  2. •基础信息（版本、类型、核心功能等）
  3. •核心目标（解决的问题）
  4. •使用方法（激活方式、预期输出等）
  5. •功能实现（代码示例、使用示例等）
  6. •最佳实践（使用建议、注意事项等）

格式要求

  • •使用 Markdown 格式
  • •采用清晰的层级结构
  • •使用表格和列表提高可读性
  • •包含具体的代码示例
  • •避免过度复杂的内容

🏗️ 技能目录结构

简单技能 (Simple Skill)

code
skill-name/
├── SKILL.md              ← 核心技能文件
├── README.md             ← 技能说明文档
├── scripts/              ← 支持脚本（可选）
│   └── main.py           ← 主要脚本文件
├── references/           ← 参考文档（可选）
│   └── examples/          ← 示例文件
└── assets/               ← 资源文件（可选）

复杂技能套件 (Complex Skill Suite)

code
skill-suite/
├── component-1/
│   └── SKILL.md          ← 子技能1
├── component-2/
│   └── SKILL.md          ← 子技能2
└── shared/               ← 共享资源

🚀 技能激活配置

激活条件设置

为了确保技能能够可靠激活，你可以在技能描述中设置明确的激活条件：

1. 关键词激活：

  • •在技能描述中包含明确的关键词
  • •使用具体的动词短语
  • •避免过于通用的词汇

2. 模式激活：

  • •考虑用户可能的提问方式
  • •包含相关的同义词和变体
  • •确保激活条件与技能功能匹配

3. 描述优化：

  • •详细描述技能的核心功能
  • •包含具体的使用场景
  • •使用自然、清晰的语言

📚 技能创建模板

SKILL.md 模板

markdown
---
name: skill-name
description: This skill should be used when... Activates with phrases like... Provides...
---

# 技能名称

## 📂 基础信息

| 属性 | 值 |
| :--- | :--- |
| **名称** | 技能名称 |
| **版本** | 1.0.0 |
| **类型** | 技能类型 |
| **核心功能** | 核心功能描述 |
| **适用环境** | Trae |

## 🎯 核心目标

技能的核心目标和解决的问题。

## 🚀 使用方法

### 激活方式

技能的激活关键词和短语。

### 预期输出

技能的预期输出格式和内容。

## 🌟 功能示例

技能的使用示例。

## 📋 最佳实践

使用技能的最佳实践和注意事项。

🔧 实现最佳实践

代码结构

  • •模块化设计：将功能拆分为独立的模块
  • •清晰的命名：使用描述性的变量和函数名
  • •错误处理：全面的错误捕获和处理
  • •文档注释：详细的代码注释和文档

性能优化

  • •缓存策略：合理使用缓存减少重复计算
  • •异步处理：使用异步操作提高性能
  • •资源管理：及时释放不需要的资源
  • •代码优化：减少不必要的计算和操作

用户体验

  • •清晰的输出：结构化、易读的输出格式
  • •友好的错误信息：详细、有用的错误提示
  • •进度反馈：长时间操作的进度提示
  • •合理的默认值：为参数提供合理的默认值

📝 技能创建示例

示例 1: 简单技能创建

用户请求："创建一个天气查询技能"

响应：

markdown
# 天气查询技能创建指南

## 阶段 1: 需求分析

- **核心功能**：查询指定城市的天气信息
- **适用场景**：用户需要了解天气状况
- **激活条件**："查询天气", "天气怎么样", "今天天气"

## 阶段 2: 结构设计

weather-query/ ├── SKILL.md ├── README.md └── scripts/ └── main.py

code

## 阶段 3: 内容创作

**SKILL.md**：
```markdown
---
name: weather-query
description: This skill should be used when the user asks about weather conditions. Activates with phrases like weather query, what's the weather, how's the weather, today's weather, weather in city.
---

# 天气查询技能

## 📂 基础信息

| 属性 | 值 |
| :--- | :--- |
| **名称** | weather-query |
| **版本** | 1.0.0 |
| **类型** | 简单技能 |
| **核心功能** | 查询天气信息 |
| **适用环境** | Trae |

## 🎯 核心目标

提供实时天气查询功能，包括温度、湿度、天气状况等信息。

## 🚀 使用方法

### 激活方式

- "查询北京天气"
- "上海今天天气怎么样"
- "广州的天气"

### 预期输出

北京天气：

  • •温度：22°C
  • •湿度：60%
  • •天气状况：晴
  • •更新时间：2026-01-28 12:00
code

## 🌟 功能示例

```python
# scripts/main.py
import requests

def get_weather(city):
    """获取指定城市的天气信息"""
    # API调用获取天气数据
    # 处理和格式化数据
    # 返回天气信息
    pass

📋 最佳实践

  • •使用免费的天气API
  • •实现缓存减少API调用
  • •处理城市名称的多种表达方式
  • •提供友好的错误信息
code



## 阶段 4: 实现指南

1. **API选择**：选择合适的天气API，如OpenWeatherMap
2. **代码实现**：实现天气查询功能
3. **错误处理**：处理API调用失败、城市不存在等情况
4. **测试**：测试不同城市的天气查询

## 阶段 5: 测试与部署

1. **本地测试**：在本地环境测试技能
2. **部署**：将技能部署到Trae环境
3. **验证**：验证技能在Trae环境中的工作情况
4. **优化**：根据测试结果优化技能

示例 2: 复杂技能套件创建

用户请求："创建一个金融分析技能套件"

响应：

markdown
# 金融分析技能套件创建指南

## 阶段 1: 需求分析

- **核心功能**：金融数据分析，包括股票分析、基金分析、债券分析
- **适用场景**：用户需要进行金融投资决策
- **激活条件**："金融分析", "股票分析", "基金分析"

## 阶段 2: 结构设计

financial-analysis-suite/ ├── stock-analysis/ │ └── SKILL.md ├── fund-analysis/ │ └── SKILL.md ├── bond-analysis/ │ └── SKILL.md └── shared/ └── utils.py

code

## 阶段 3: 内容创作



## 阶段 4: 实现指南

1. **模块划分**：将不同金融工具的分析功能划分为独立模块
2. **共享代码**：提取共享功能到shared目录
3. **API集成**：集成金融数据API
4. **分析算法**：实现各种金融分析算法

## 阶段 5: 测试与部署

1. **模块测试**：测试每个子技能的功能
2. **集成测试**：测试技能套件的整体功能
3. **部署**：将技能套件部署到Trae环境
4. **验证**：验证技能套件在Trae环境中的工作情况

🚀 如何使用

激活方式

当你询问以下类型的问题时，pix-skill-creator 会自动激活：

  • •"创建一个天气查询技能"
  • •"构建一个股票分析agent"
  • •"开发一个翻译技能"
  • •"制作一个计算器技能"
  • •"生成一个新闻查询agent"

预期输出

pix-skill-creator 会提供：

  1. •完整的技能创建流程
  2. •详细的文件格式指南
  3. •标准化的配置示例
  4. •实用的实现建议
  5. •全面的测试策略

📚 参考资源

技能结构模板

  • •简单技能：包含SKILL.md和必要的脚本
  • •复杂技能套件：包含多个子技能

配置示例

  • •SKILL.md：完整的格式示例
  • •激活条件：有效的激活条件配置
  • •测试查询：测试查询示例

最佳实践

  • •命名规范：使用描述性的技能名称
  • •目录结构：标准化的目录组织
  • •代码质量：模块化、可维护的代码
  • •用户体验：清晰、友好的输出格式

🎓 总结

pix-skill-creator 是一个强大的元技能，旨在帮助用户创建高质量的agent skill。通过遵循本指南，你可以创建结构规范、功能完整、激活可靠的技能，为Trae环境增添新的能力。

记住，一个好的技能应该：

  1. •目标明确：解决特定的问题
  2. •结构规范：遵循Trae Skills架构
  3. •激活可靠：配置有效的激活条件
  4. •实现优质：提供高质量的功能实现
  5. •用户友好：提供清晰、有用的输出

现在，你已经准备好创建自己的agent skill了！