Skip to content
cccskills
FreePublished on GitHub

cmajor-external

Use Pulp's MIT-safe Cmajor support lane via source-owned patches, an external `cmaj` toolchain, and explicit generated-artifact workflows.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Cmajor External Toolchain

Use this skill when a task involves Pulp's current Cmajor support lane.

Truthful Position

Pulp supports Cmajor as an external toolchain, not as a vendored runtime.

Supported now:

  • .cmajor / .cmajorpatch source examples
  • patch-structure validation through tools/scripts/cmajor_external.py doctor
  • generated-artifact invocation through a user-provided cmaj
  • docs and workflow guidance for the MIT-safe lane

Not supported by this skill:

  • shipping the Cmajor engine/JIT/runtime in Pulp core
  • claiming a finished Processor adapter for arbitrary Cmajor patches
  • blanket hot-reload claims
  • broad multi-DSL parity claims

Core Files

  • docs/guides/cmajor.md
  • tools/scripts/cmajor_external.py
  • docs/contracts/pulp-dsl-v1.md
  • examples/cmajor-gain/

Recommended Workflow

1. Validate the example or patch layout first

python3 tools/scripts/cmajor_external.py doctor \
  --patch examples/cmajor-gain/CmajorGain.cmajorpatch

Use --require-tool when the next step truly depends on a real cmaj.

2. Keep cmaj external

Preferred resolution order:

  • --cmaj /path/to/cmaj
  • CMAJ_BIN=/path/to/cmaj
  • PATH

Do not turn the upstream Cmajor runtime/toolchain into a bundled dependency of Pulp unless the repo's license policy changes.

3. Generate artifacts explicitly

python3 tools/scripts/cmajor_external.py generate \
  --patch examples/cmajor-gain/CmajorGain.cmajorpatch \
  --target cpp \
  --output /tmp/CmajorGain.cpp

Pass through target-specific args with repeated --arg flags.

4. Keep docs truthful

When editing this lane, keep these in sync:

  • docs/guides/cmajor.md
  • docs/reference/capabilities.md
  • docs/guides/examples.md
  • planning/v3-phase14-gap-closure-status.md

What To Check

For the current Cmajor lane, verify:

  • patch manifest/source layout is valid
  • missing-tool diagnostics are explicit
  • helper commands target the user-supplied cmaj, not an assumed bundled tool
  • docs do not imply a shipped runtime or checked-in generated output

Boundaries

This skill is for the MIT-safe external lane only.

If a user wants true runtime embedding:

  • treat that as a separate BYO-runtime path
  • keep it opt-in
  • do not convert it into a default shipped dependency

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

aax

Free

Optional AAX support for Pulp, including developer-supplied Avid SDK setup, CMake enablement, DigiShell/AAX Validator workflows, and local AAX builds on macOS or Windows.

The English summary is being prepared. Showing the original description.

Generous-Corp/pulp22Updated Oct 19, 2026

Configure, implement, and test Pulp's optional desktop Ableton Link tempo-sync adapter while preserving the developer-supplied SDK, licensing, realtime, latency-compensation, and no-install boundaries.

The English summary is being prepared. Showing the original description.

Generous-Corp/pulp22Updated Oct 19, 2026

Maintain Pulp's installed design-time agent capability manifest and public-surface ledger. Use when adding, removing, renaming, or materially changing public audio, MIDI, signal, timebase, or sequence APIs; registering a new algorithm for generators; changing capability support or deprecation state; or repairing agent-capabilities freshness, schema, fingerprint, tombstone, or installed-SDK tests.

The English summary is being prepared. Showing the original description.

Generous-Corp/pulp22Updated Oct 19, 2026

Android platform development for Pulp — NDK cross-compilation, Oboe audio, Dawn/Skia GPU rendering, JNI bridge, touch interaction, emulator workflows, and end-to-end smoke validation. Covers build, deploy, debug, and the gotchas discovered during bringup.

The English summary is being prepared. Showing the original description.

Generous-Corp/pulp22Updated Oct 19, 2026

ara

Free

Optional ARA support for Pulp, including developer-supplied ARA SDK setup, CMake enablement, adapter companion APIs, validation, and ARA-aware plugin implementation guidance.

The English summary is being prepared. Showing the original description.

Generous-Corp/pulp22Updated Oct 19, 2026

The measurement surface for ALL Pulp DSP and audio-pipeline work — read it BEFORE writing or gating DSP, not only when something already sounds wrong. Covers the C++ harness (signal generators, metrics, assertions, RenderScenario, contracts), the offline Audio Doctor (magnitude/frequency response, THD/THD+N, phase/group delay), and their Python sibling the Audio Quality Lab (tools/audio/quality-lab — null residual + alignment, LTAS log-spectral distance, spectral flux/centroid, HNR, Theil-Sen drift slope, Kaiser-sinc resampling, license-guarded corpus, regression-net ratchet). TRIGGER on AUTHORING work — "build/design an oscillator/filter/synth/effect", "add a DSP module", "what should the acceptance gate be", "how do I measure aliasing / anti-aliasing / alias floor", "null against a reference", "is this DSP correct", "choose a tolerance", "golden/regression corpus for audio", "measure drift or jitter", "A/B two renders" — AND on DEBUGGING work — "is there sound / no audio / I hear nothing", "does this filter/compressor/synth/delay produce the right signal", "prove the DSP / prove the contract", "measure the frequency response", "what's the THD / is it distorting", "what's the group delay / phase response / measured latency", "magnitude response curve", "render a test tone and assert", "audio regression", "64-frame works but 128 is silent", "sample-rate change pitch-shifted it", "describe what's in this buffer", "audio doctor", "compare before/after a DSP refactor". Reach for this BEFORE hand-rolling any FFT, null test, alias measurement, pitch tracker, or golden-render script — most of it already exists in one of the two lanes. Test/tool layer over HeadlessHost — deterministic, no audio device, no speakers. Off the realtime thread entirely.

The English summary is being prepared. Showing the original description.

Generous-Corp/pulp22Updated Oct 19, 2026

See all skills by Generous-Corp

Report a problem with this skill