skill designer
- Repo stars 1,568
- Author repo claude-trading-skills
- Domain
- Design
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tradermonty · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- Python >=3.9
- Detected file/system behavior
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Step 4: Validate Output
- `skills/<skill-name>/SKILL.md` exists with correct frontmatter
- Directory structure follows conventions
- Score with dual-axis-skill-reviewer meets threshold 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
Run the prompt builder: 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
The calling pipeline pipes the prompt into `claude -p`:
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
# 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:
```bash
python3 skills/skill-designer/scripts/build_design_prompt.py \
--idea-json /tmp/idea.json \
--skill-name "my-new-skill" \
--project-root .
```
The script:
1. Loads the idea JSON
2. Reads all three reference files (structure guide, quality checklist, template)
3. Lists existing skills (up to 20) to prevent duplication
4. Outputs a complete prompt to stdout
### Step 3: Feed Prompt to 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
```
### 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)
Listed in source order.
sections -> Overview → When to Use → Prerequisites → Workflow → Step 1: Prepare Idea Specification → Step 2: Build Design Prompt
terms -> Generate a comprehensive Claude CLI prompt from a structured skill idea specification. · Accept a normalized skill name (--skill-name) that will be used as the directory name and YAML frontmatter name: field. · The script: 1. · The script outputs a plain-text prompt to stdout.
files/cmd -> claude -p · references/ · --idea-json · title · description · category · --skill-name · name:
body sha256 -> 7308f376b7a8
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 -pA developer wants to bootstrap a new skill from a JSON idea specification Quality review of generated skills requires awareness of the scoring rubricPrerequisites
Python 3.9+ No external API keys required Reference files must exist under
references/Step 1: Prepare Idea Specification
Accept a JSON file (
--idea-json) containing:title: Human-readable idea namedescription: What the skill doescategory: Skill category (e.g., trading-analysis, developer-tooling) Accept a normalized skill name (--skill-name) that will be used as theStep 2: Build Design Prompt
Run the prompt builder: 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