skill-designer

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill Designer

技能设计器（Skill Designer）

Overview

概述

Generate a comprehensive Claude CLI prompt from a structured skill idea specification. The prompt instructs Claude to create a complete skill directory following repository conventions: SKILL.md with YAML frontmatter, reference documents, helper scripts, and test scaffolding.

从结构化的技能创意规范生成完整的Claude CLI提示词。该提示词会指导Claude按照仓库规范创建完整的技能目录：包含带YAML前言的SKILL.md、参考文档、辅助脚本和测试脚手架。

When to Use

适用场景

The skill auto-generation pipeline selects an idea from the backlog and needs a design prompt for
```
claude -p
```
A developer wants to bootstrap a new skill from a JSON idea specification
Quality review of generated skills requires awareness of the scoring rubric

技能自动生成流水线从待办列表中选取创意，需要为
```
claude -p
```
生成设计提示词
开发者想要基于JSON创意规范快速初始化新技能
生成的技能的质量审核需要参考评分规则

Prerequisites

前置要求

Python 3.9+
No external API keys required
Reference files must exist under
```
skills/skill-designer/references/
```

Python 3.9+
无需外部API密钥
参考文件必须存放在
```
skills/skill-designer/references/
```
目录下

Workflow

工作流程

Step 1: Prepare Idea Specification

步骤1：准备创意规范

Accept a JSON file (

--idea-json

) containing:

```
title
```
: Human-readable idea name
```
description
```
: What the skill does
```
category
```
: Skill category (e.g., trading-analysis, developer-tooling)

Accept a normalized skill name (

--skill-name

) that will be used as the directory name and YAML frontmatter

name:

field.

接收JSON文件（

--idea-json

参数），包含以下字段：

```
title
```
：人类可读的创意名称
```
description
```
：技能的功能描述
```
category
```
：技能分类（例如trading-analysis、developer-tooling）

接收标准化的技能名称（

--skill-name

参数），该名称将用作目录名称和YAML前言的

name:

字段值。

Step 2: Build Design Prompt

步骤2：构建设计提示词

Run the prompt builder:

bash

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root .

The script:

Loads the idea JSON
Reads all three reference files (structure guide, quality checklist, template)
Lists existing skills (up to 20) to prevent duplication
Outputs a complete prompt to stdout

运行提示词构建器：

bash

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root .

该脚本会执行以下操作：

加载创意JSON文件
读取全部三个参考文件（结构指南、质量检查清单、模板）
列出现有技能（最多20个）以避免重复
将完整的提示词输出到标准输出

Step 3: Feed Prompt to Claude CLI

步骤3：将提示词传入Claude CLI

The calling pipeline pipes the prompt into

claude -p

bash

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root . \
| claude -p --allowedTools Read,Edit,Write,Glob,Grep

调用流水线将提示词通过管道传入

claude -p

：

bash

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root . \
| claude -p --allowedTools Read,Edit,Write,Glob,Grep

Step 4: Validate Output

步骤4：验证输出

After Claude creates the skill, verify:

```
skills/<skill-name>/SKILL.md
```
exists with correct frontmatter
Directory structure follows conventions
Score with dual-axis-skill-reviewer meets threshold

Claude创建完技能后，验证以下内容：

```
skills/<skill-name>/SKILL.md
```
文件存在且包含正确的前言内容
目录结构符合规范
dual-axis-skill-reviewer的评分达到阈值

Output Format

输出格式

The script outputs a plain-text prompt to stdout. Exit code 0 on success, 1 if required reference files are missing.

该脚本会将纯文本提示词输出到标准输出。成功时退出码为0，缺少所需参考文件时退出码为1。

Resources

资源

```
references/skill-structure-guide.md
```
-- Directory structure, SKILL.md format, naming conventions
```
references/quality-checklist.md
```
-- Dual-axis reviewer 5-category checklist (100 points)
```
references/skill-template.md
```
-- SKILL.md template with YAML frontmatter and standard sections
```
scripts/build_design_prompt.py
```
-- Prompt builder script (CLI interface)

```
references/skill-structure-guide.md
```
-- 目录结构、SKILL.md格式、命名规范
```
references/quality-checklist.md
```
-- 双轴审核器5类检查清单（满分100分）
```
references/skill-template.md
```
-- 带有YAML前言和标准章节的SKILL.md模板
```
scripts/build_design_prompt.py
```
-- 提示词构建器脚本（CLI界面）