lesstruct-plugin-development/

lesstruct-plugin-development

A skill for AI agents that helps Lesstruct users write, debug, audit, and upgrade WASM plugins for their Lesstruct installation. It works entirely from your plugins/ directory and the running Lesstruct install; it does not require access to the Lesstruct source tree.

Quick start

Install with the open agent-skills CLI — it auto-detects your agent (Claude Code, OpenCode, Cursor, Codex, Gemini CLI, Copilot, and 25+ others) and writes the skill to the correct path:

# Install just this skill
npx skills add aristorinjuang/lesstruct --skill lesstruct-plugin-development

# Or, to install all Lesstruct skills at once
npx skills add aristorinjuang/lesstruct

Add -g for a global (user-wide) install, or -a <agent> to target a specific one. Restart your agent, then invoke the skill:

"Help me write a WASM plugin for my Lesstruct installation that enriches content from an external API."

For manual cp -r fallbacks and the full per-agent path table, see references/install-paths.md.

What it does

Walks you through:

• Picking the right hook (the 3 currently-invoked hooks are before_save, after_create, after_publish).
• Implementing the memory protocol (input at offset 65536, return result offset; optional __hook_result_len).
• Calling host functions (HTTP, DB, logging) with the //go:wasmimport bindings.
• Writing a capability manifest.
• Building with TinyGo, Rust, or C/C++.
• Deploying to plugins/ and verifying.
• Auditing an existing plugin.

The full workflow is in SKILL.md. The user-facing contract is in references/plugin-development.md and references/plugin-capabilities.md.

What ships with the skill

• references/examples/ — four Go/TinyGo example plugins, copied from pkg/sdk/examples/. Three of them use invoked hooks; one uses a reserved hook (see SKILL.md Step 4).
• references/host-function-imports.go.txt — a copy-pasteable //go:wasmimport block. The Lesstruct SDK does not currently ship these declarations.
• references/hook-data-example.json — the actual JSON shape the host sends to a before_save hook.

Directory layout

lesstruct-plugin-development/
  SKILL.md                              # The workflow
  customize.toml                        # BMad-specific extension (optional)
  README.md                             # This file
  references/
    plugin-development.md               # User-facing plugin contract
    plugin-capabilities.md              # User-facing capabilities contract
    host-function-imports.go.txt        # //go:wasmimport declarations
    hook-data-example.json              # Real hookData shape
    dev-vs-prod.md                      # DEV_MODE caveats
    plugin-checklist.md                 # Pre-flight audit checklist
    install-paths.md                    # Per-agent install snippets
    examples/                           # Four bundled Go/TinyGo plugins
      go-hello-world/
      go-content-transform/
      go-system-fields/
      go-validation/

Uninstall

# If installed via the CLI
npx skills remove lesstruct-plugin-development

# Or remove the directory manually
rm -rf ~/.claude/skills/lesstruct-plugin-development

Where to get help

• Lesstruct repository: github.com/aristorinjuang/lesstruct
• Issue tracker: open an issue in the Lesstruct repo with the plugin-development label.
• Developer-facing docs: the Lesstruct repo's docs/plugin-development.md and docs/plugin-capabilities.md (the canonical, source-tree-aware versions of the contract this skill uses).
• The loaded reference: when the skill runs, the user-facing contract is at references/plugin-development.md and references/plugin-capabilities.md inside this skill.

License

This skill is part of the Lesstruct project and is released under the same license as Lesstruct itself.