mcpField
S
skill-designer

skill-designer

github.com/mphinanceAgent workflows3284 installsUpdated 5d ago
Repository

About skill-designer

This skill builds a design prompt for Claude CLI from a structured JSON skill idea. It draws on repository guides and templates, and lists existing skills to help avoid duplication.

Key features

  1. 01Reads a JSON skill idea
  2. 02Builds a Claude CLI design prompt
  3. 03Loads structure, quality, and template references
  4. 04Lists existing skills to avoid duplication
  5. 05Writes the prompt to stdout

Use cases

  1. 01Starting skill creation from a backlog idea
  2. 02Bootstrapping a skill from JSON specifications
  3. 03Preparing prompts for an automated generation pipeline
  4. 04Reviewing generated skills against a scoring rubric

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mphinance/alpha-skills --skill skill-designer

After installing, type/skill-designerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
references/
quality-checklist.md
skill-structure-guide.md
skill-template.md
scripts/
build_design_prompt.py
scripts/tests/
conftest.py
test_build_design_prompt.py

Details

From the project 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:

  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:

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)

Comments

Markdown supported