Index of every page on this site: llms.txt
All skills
tradermonty avatar

/skill-designer

@f95e770
Run it yourself

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.

Use this Skill: https://skilld.dev/gh/tradermonty/claude-trading-skills/skill-designer

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈68 tokens for metadata: the name and description. ≈642 when used: this file. ≈1.7k more on demand in 3 files.

Description uses 3.4% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈272 characters, or 3.4%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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)

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1mo5 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill is designed to generate prompts for building new AI agent skills. The primary security concern is the lack of sanitization for input data, which could lead to indirect prompt injection if a malicious idea specification is used.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

  • Runlayer8mo

    7 files scanned · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at f95e770. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 8 months ago

README badge

README badge for tradermonty/claude-trading-skills/skill-designer