Skill

skill-designer

Generates Claude CLI prompts from JSON skill idea specs to create complete skill directories (SKILL.md, references, scripts, tests) following repository conventions. Use in auto-generation pipelines or for bootstrapping new skills.

Python

Bash

developer-tools

automation

Install

npx claudepluginhub joshuarweaver/cascade-business-ops --plugin tradermonty-claude-trading-skills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Generate a comprehensive Claude CLI prompt from a structured skill idea

Supporting Assets

references/quality-checklist.mdreferences/skill-structure-guide.mdreferences/skill-template.mdscripts/build_design_prompt.pyscripts/tests/conftest.pyscripts/tests/test_build_design_prompt.py

SKILL.md

Similar Skills

design-system

Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.

team-skills-platform

167.4k

ui-demo

Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.

team-skills-platform

167.4k

kotlin-patterns

Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.

team-skills-platform

167.4k

Stats

Stars1056

Forks235

Last CommitMar 30, 2026

Actions

View Source View Plugin View on GitHub View README

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)