skill-designer

Q: How do I install skill-designer?

Run npx skills add https://github.com/tradermonty/claude-trading-skills --skill skill-designer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/skill-designer/ (personal) or .claude/skills/skill-designer/ (project).

by tradermontyFrontend & Design

Design new Claude skills from structured idea specifications. Use when the skill auto-generation pipeline needs to produce a Claude CLI prompt that creates a complete skill directory (SKILL.md, references, scripts, tests) following repository conventions.

Installs: 3.2K
Last 24h: +19
Trending rank: #5984
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/tradermonty/claude-trading-skills --skill skill-designer

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads skill-designer automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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.

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

Prerequisites

Python 3.9+
No external API keys required
Reference files must exist under references/

Workflow

Step 1: Prepare Idea Specification

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.

Step 2: Build Design Prompt

Run the prompt builder:

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

Step 3: Feed Prompt to Claude CLI

The calling pipeline pipes the prompt into claude -p:

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

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

Output Format

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

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)

FAQ

What does the skill-designer skill do?

How do I install skill-designer?

Run npx skills add https://github.com/tradermonty/claude-trading-skills --skill skill-designer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/skill-designer/ (personal) or .claude/skills/skill-designer/ (project).

Which AI agents can use skill-designer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is skill-designer safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains skill-designer?

It is published by tradermonty in tradermonty/claude-trading-skills. It has 3,170 recorded installs.