Procedural Instrument Synthesis | zx-procgen | ClaudePluginHub

Skill

Community

Procedural Instrument Synthesis

From zx-procgen

1

Description

Generate instrument samples for ZX game music. **Spec-Driven Workflow (RECOMMENDED):** 1. Create `.spec.py` in `.studio/specs/instruments/` 2. Run `python .studio/generate.py --only instruments` **Load references when:** - Instrument specs → `procedural-sounds/references/sound-spec-format.md` - Example specs → `examples/bass.spec.py`, `examples/lead.spec.py` - Karplus-Strong → `references/karplus-strong.md` - FM synthesis → `references/fm-synthesis.md` - Drum examples → `references/drum-examples.py` **Before generating:** Check `.studio/sonic-identity.md` for audio specs.

Install

1

Add the repository(one-time)

$

/plugin marketplace add nethercore-systems/nethercore-ai-plugins

2

Install the plugin

$

/plugin install zx-procgen@nethercore-ai-plugins

Tool Access

This skill inherits all available tools. When active, it can use any tool Claude has access to.

Supporting Assets

View in Repository

examples/acoustic-guitar.py

examples/bass.spec.py

examples/brass-lead.py

examples/electric-piano.py

examples/fm-bell.py

examples/kick.spec.py

examples/lead.spec.py

examples/organ.py

examples/pad.spec.py

examples/pluck-synth.py

examples/strings-pad.py

examples/synth-bass.py

lib/__init__.py

lib/drums.py

lib/effects.py

lib/synthesis.py

lib/waveforms.py

references/additive-synthesis.md

references/drum-examples.py

references/fm-synthesis.md

Skill Content

Procedural Instrument Synthesis

Generate production-quality instrument samples using a spec-driven workflow.

Spec-Driven Workflow

Step 1: Create Spec

# .studio/specs/instruments/bass.spec.py
INSTRUMENT = {
    "instrument": {
        "name": "bass",
        "base_note": "C2",
        "synthesis": {
            "type": "karplus_strong",
            "damping": 0.994,
            "brightness": 0.5
        },
        "envelope": {"attack": 0.01, "decay": 0.4, "sustain": 0.3, "release": 0.3},
        "output": {"duration": 1.5, "bit_depth": 16, "loop": True}
    }
}

Step 2: Run Generator

python .studio/generate.py --only instruments

See procedural-sounds/references/sound-spec-format.md for complete format.

Technique Selection

Instrument	Technique	Reference
Acoustic Guitar	Karplus-Strong	`karplus-strong.md`
Electric Piano	FM Synthesis	`fm-synthesis.md`
Bells	FM (inharmonic)	`fm-synthesis.md`
Organ	Additive	`additive-synthesis.md`
Strings/Pads	Wavetable	`wavetable-synthesis.md`
Synth Lead/Bass	Subtractive	`subtractive-synthesis.md`
Drums	See examples	`drum-examples.py`

Why Basic Synthesis Sounds Chiptuney

Problem	Why It Sounds Bad
Raw `np.sin()`	Static timbre, no evolution
Simple ADSR	Real instruments have complex envelopes
Instant attack	Real instruments have transients
Single oscillator	Real instruments have multiple components

Quality Checklist

No clicks (attack/release ramps)
Pitch correct (verify frequency)
Timbre evolves (envelope on filter/index)
Attack has character (transient noise)
Sounds musical (test in context)

Related Skills

procedural-sounds - SFX synthesis
sound-design/sonic-style-language - Audio style specs
tracker-music/xm-format - XM writer

Links

GitHub Stats

0 forks

Updated 13 hours ago

Similar Skills

Command Development

This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.

53.4k

Agent Development

This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.

53.4k

Hook Development

This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.

53.4k