Back to Details

skill-creator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Creator

技能创建器

Generate production-ready Claude Code skills following established conventions.
按照既定约定生成可用于生产环境的Claude Code技能。

Core Workflow

核心工作流

  1. Define skill purpose: Clear name, description, and use cases
  2. Determine category: Place in correct folder (foundation, frontend, backend, etc.)
  3. Create SKILL.md: Main skill file with frontmatter and content
  4. Add references: Optional templates.md, conventions.md, or patterns.md
  5. Include examples: Production-ready code samples
  6. Write checklist: Output verification checklist
  1. 定义技能用途：清晰的名称、描述和使用场景
  2. 确定分类：放置到正确的文件夹（foundation、frontend、backend等）
  3. 创建SKILL.md：包含frontmatter和内容的主技能文件
  4. 添加参考文件：可选的templates.md、conventions.md或patterns.md
  5. 包含示例：可用于生产环境的代码示例
  6. 编写检查清单：输出验证检查清单

Skill Categories

技能分类

CategoryPathPurpose
Foundation
foundation/
Project setup, dev environment, git, docs
Frontend
frontend/
React, Vue, UI components, styling, UX
Backend
backend/
APIs, auth, server logic, services
AI Engineering
ai-engineering/
LLMs, RAG, agents, prompts
Architecture
architecture/
System design, ADRs, tech decisions
CI/CD
ci-cd/
Automation, deployments, pipelines
Database
database-management/
Migrations, queries, data engineering
Testing
testing/
Unit tests, integration, e2e, mocks
Security
security/
Vulnerabilities, auth, hardening
Performance
performance/
Observability, monitoring, optimization
分类路径用途
Foundation
foundation/
项目搭建、开发环境、Git、文档
Frontend
frontend/
React、Vue、UI组件、样式、UX
Backend
backend/
API、身份验证、服务器逻辑、服务
AI Engineering
ai-engineering/
LLM、RAG、Agent、提示词
Architecture
architecture/
系统设计、ADR、技术决策
CI/CD
ci-cd/
自动化、部署、流水线
Database
database-management/
迁移、查询、数据工程
Testing
testing/
单元测试、集成测试、端到端测试、模拟对象
Security
security/
漏洞、身份验证、加固
Performance
performance/
可观测性、监控、优化

SKILL.md Template

SKILL.md 模板

markdown
---
name: skill-name-in-kebab-case
description: One-line description of what the skill does and when to use it. Include trigger phrases like "use when users request X, Y, or Z".
---
markdown
---
name: skill-name-in-kebab-case
description: One-line description of what the skill does and when to use it. Include trigger phrases like "use when users request X, Y, or Z".
---

Skill Title

Skill Title

Brief tagline explaining the skill's value proposition.
Brief tagline explaining the skill's value proposition.

Core Workflow

Core Workflow

  1. Step one: Description
  2. Step two: Description
  3. Step three: Description ...
  1. Step one: Description
  2. Step two: Description
  3. Step three: Description ...

[Main Content Sections]

[Main Content Sections]

Section with Code Examples

Section with Code Examples

```typescript // Production-ready code example ```
```typescript // Production-ready code example ```

Patterns / Templates

Patterns / Templates

Document reusable patterns with examples.
Document reusable patterns with examples.

Best Practices

Best Practices

  • Practice one
  • Practice two
  • Practice three
  • Practice one
  • Practice two
  • Practice three

Output Checklist

Output Checklist

Every output should include:
  • Item one
  • Item two
  • Item three
undefined
Every output should include:
  • Item one
  • Item two
  • Item three
undefined

Reference Files Structure

参考文件结构

When skills need supplementary documentation:
skill-name/
├── SKILL.md              # Main skill file (required)
└── references/            # Optional reference materials
    ├── templates.md       # Code/file templates
    ├── conventions.md     # Standards and conventions
    └── patterns.md        # Reusable patterns
当技能需要补充文档时：
skill-name/
├── SKILL.md              # Main skill file (required)
└── references/            # Optional reference materials
    ├── templates.md       # Code/file templates
    ├── conventions.md     # Standards and conventions
    └── patterns.md        # Reusable patterns

Frontmatter Requirements

Frontmatter 要求

yaml
---
name: kebab-case-skill-name # Must match folder name
description: >
  Clear description including:
  - What the skill does
  - When to use it
  - Trigger phrases ("use when X", "create Y", "generate Z")
---
yaml
---
name: kebab-case-skill-name # Must match folder name
description: >
  Clear description including:
  - What the skill does
  - When to use it
  - Trigger phrases ("use when X", "create Y", "generate Z")
---

Content Guidelines

内容指南

Code Examples

代码示例

  • Must be production-ready, not pseudocode
  • Include TypeScript types where applicable
  • Show complete, working examples
  • Use modern syntax and best practices
  • 必须是可用于生产环境的代码，而非伪代码
  • 适用时包含TypeScript类型定义
  • 展示完整、可运行的示例
  • 使用现代语法和最佳实践

Sections to Include

需包含的章节

  1. Core Workflow: Numbered steps for using the skill
  2. Main Content: Patterns, templates, examples
  3. Best Practices: Industry-proven recommendations
  4. Output Checklist: Verification items
  1. 核心工作流：使用该技能的分步说明
  2. 主要内容：模式、模板、示例
  3. 最佳实践：行业验证的建议
  4. 输出检查清单：验证项

Writing Style

写作风格

  • Active voice, imperative mood
  • Concise, scannable formatting
  • Tables for structured comparisons
  • Code blocks for all technical content
  • 使用主动语态、祈使语气
  • 简洁、便于快速浏览的格式
  • 用表格呈现结构化对比内容
  • 所有技术内容使用代码块

Skill Quality Criteria

技能质量标准

Completeness

完整性

  • Solves a specific, well-defined problem
  • Includes working code examples
  • Has clear trigger phrases in description
  • Provides output verification checklist
  • 解决特定、定义明确的问题
  • 包含可运行的代码示例
  • 描述中包含清晰的触发短语
  • 提供输出验证检查清单

Consistency

一致性

  • Follows naming conventions (kebab-case)
  • Uses standard section headings
  • Matches existing skill format
  • Placed in correct category folder
  • 遵循命名约定（kebab-case）
  • 使用标准章节标题
  • 与现有技能格式保持一致
  • 放置在正确的分类文件夹中

Usefulness

实用性

  • Examples are copy-paste ready
  • Covers common use cases
  • Anticipates edge cases
  • References external docs where helpful
  • 示例可直接复制使用
  • 覆盖常见使用场景
  • 考虑到边缘情况
  • 在有帮助时引用外部文档

Example: Creating a New Skill

示例：创建新技能

Step 1: Define the Skill

步骤1：定义技能

Name: api-rate-limiter
Category: backend
Purpose: Implement rate limiting for APIs
Triggers: "add rate limiting", "protect API", "throttle requests"
Name: api-rate-limiter
Category: backend
Purpose: Implement rate limiting for APIs
Triggers: "add rate limiting", "protect API", "throttle requests"

Step 2: Create Folder Structure

步骤2：创建文件夹结构

bash
mkdir -p backend/api-rate-limiter
touch "backend/api-rate-limiter/SKILL.md"
bash
mkdir -p backend/api-rate-limiter
touch "backend/api-rate-limiter/SKILL.md"

Step 3: Write SKILL.md

步骤3：编写SKILL.md

markdown
---
name: api-rate-limiter
description: Implements rate limiting for APIs using token bucket, sliding window, or fixed window algorithms. Use when users request "add rate limiting", "protect API from abuse", or "throttle requests".
---
markdown
---
name: api-rate-limiter
description: Implements rate limiting for APIs using token bucket, sliding window, or fixed window algorithms. Use when users request "add rate limiting", "protect API from abuse", or "throttle requests".
---

API Rate Limiter

API Rate Limiter

Protect your APIs from abuse with production-ready rate limiting.
Protect your APIs from abuse with production-ready rate limiting.

Core Workflow

Core Workflow

...
undefined
...
undefined

Step 4: Add References (if needed)

步骤4：添加参考文件（如有需要）

bash
mkdir -p backend/api-rate-limiter/references
touch backend/api-rate-limiter/references/algorithms.md
bash
mkdir -p backend/api-rate-limiter/references
touch backend/api-rate-limiter/references/algorithms.md

Output Checklist

输出检查清单

When creating a new skill:
  • Skill name is kebab-case
  • Description includes trigger phrases
  • Placed in correct category folder
  • SKILL.md follows template structure
  • Code examples are production-ready
  • Includes Core Workflow section
  • Has Output Checklist section
  • Reference files added if needed
创建新技能时需检查：
  • 技能名称为kebab-case格式
  • 描述中包含触发短语
  • 放置在正确的分类文件夹中
  • SKILL.md遵循模板结构
  • 代码示例可用于生产环境
  • 包含核心工作流章节
  • 包含输出检查清单章节
  • 按需添加参考文件