Add Claude Code skill for scaffolding and deploying plugins#46
Draft
guyathomas wants to merge 2 commits intomainfrom
Draft
Add Claude Code skill for scaffolding and deploying plugins#46guyathomas wants to merge 2 commits intomainfrom
guyathomas wants to merge 2 commits intomainfrom
Conversation
Adds .claude/skills/sigma-plugin/SKILL.md — a Claude Code skill that walks a developer from idea to deployed plugin in one session. The skill is intentionally thin on API specifics: it delegates the @sigmacomputing/plugin API surface to the context7 MCP (with a fallback to reading the installed .d.ts), so it stays correct across library releases without edits. Paired with three MCP tools exposed by crossover (createPlugin, pushPluginCode, listPlugins) in sigmacomputing/mono-node. What the skill teaches - Create vs. update decision (avoid re-scaffolding working plugins) - Where to fetch API details (context7 preferred, .d.ts fallback) - Deploy workflow with error-recovery rules (never re-call createPlugin on retry; write .sigma-plugin.json immediately so pluginId survives failures) - Single-file bundle constraints enforced by vite-plugin-singlefile - When to stop and ask (data unavailable, bundle too large, unconfirmed API shapes) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Replaces the MCP-based createPlugin/pushPluginCode/listPlugins flow with sigcli plugins create/upload-bundle/list, matching the new /v2/plugins REST API in mono-node#32009 and the sigcli commands in cli#24. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
guyathomas
force-pushed
the
add-claude-code-skill
branch
from
6733ec1 to
3d3fcb0
Compare
Collaborator
|
I thought we were still exploring how we wanted to handle plugin uploads and if we even wanted to host them on our servers. Where is this being uploaded to? Are we running any sort of security scan on the uploaded bundle? |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
.claude/skills/sigma-plugin/SKILL.md— a Claude Code skill that scaffolds a Vite +vite-plugin-singlefileproject pinned to@sigmacomputing/plugin, then deploys viasigcli plugins create/upload-bundle/listagainst the/v2/pluginsAPI (mono-node#32009 for CRUD, mono-node#32254 for bundle upload, sigcli wiring in cli#24). Gated on theplugins_v2Statsig flag.Design
The skill deliberately does not embed
@sigmacomputing/pluginhook names or option shapes — those drift across versions. It instructs Claude to fetch them at runtime viacontext7(or fall back to the installed.d.ts) and refuse to ship code for any API call it can't confirm. The skill owns: create-vs-update decision,.sigma-plugin.jsondurability, single-file bundle constraints (incl. the 10 MB server cap), and when to stop and ask.Part 4 of 4
Part 1: mono-node#32009 (CRUD) · Part 2: mono-node#32254 (bundle upload) · Part 3: cli#24 · Part 4: this PR.
Followups
cpd into~/.claude/skills/).package.jsontemplate.context7from soft to hard requirement once it's canonical.Test plan
cp .claude/skills/sigma-plugin/SKILL.md ~/.claude/skills/sigma-plugin/SKILL.mdsigcli profile listworks;plugins_v2flag enabledsigcli plugins createcalled once,.sigma-plugin.jsonwritten, build produces single-filedist/index.html,sigcli plugins upload-bundlereturns a CDN URLpluginId, no duplicate🤖 Generated with Claude Code