About superset-contribute
superset-contribute is a skill that guides contributions to the Superset repository, from deciding scope and setting up a workspace to preparing and opening a pull request. It follows repository-specific guidance and describes the checks and evidence expected for a merge-ready change.
Key features
- 01Triage changes by scope
- 02Fork, clone, and configure a workspace
- 03Run lint, typecheck, and tests
- 04Prepare and submit a pull request
Use cases
- 01Fix a Superset bug or documentation issue
- 02Develop a feature after agreeing on its approach
- 03Prepare a contribution that follows repository rules
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ paradevai/ skills --skill superset-contributeAfter installing, type/superset-contributein Claude Code to confirm it loaded.
Details
From the project READMEContribute to Superset
Take the user from "I want to fix/build X in Superset" to a merge-ready PR that follows the repo's rules. If the checked-out repo has CONTRIBUTING.md / DEVELOPMENT.md / AGENTS.md, those files are authoritative — read them and prefer them over this summary.
1. Scope first
- Bug fixes, docs, small improvements → straight to a PR, no issue needed
- New features or larger changes → open an issue first at https://github.com/superset-sh/superset/issues/new/choose to agree on the approach before building
- Questions → Superset Discord, not an issue
2. Set up
gh auth status, then fork and clone:gh repo fork superset-sh/superset --clone(or add a fork remote to an existing clone)- Best experience: add the clone as a project in the Superset app and create a workspace per change — contributions develop inside managed worktrees
- In the new workspace/worktree, run
./.superset/setup.local.shonce (configures per-workspace ports, app identity, local services, and a seeded dev account — no external credentials needed), thenbun run dev - Bun only — never npm/yarn/pnpm. Read the root
AGENTS.mdand follow it.
3. Make it merge-ready
- Branch from
main; one change per PR — unrelated finds become a second PR - Before pushing:
bun run lint:fix, then verifybun run lintexits clean (CI fails on warnings too),bun run typecheck,bun run test - PR title must be a conventional commit (
feat(desktop): ...,fix(web): ...) — PRs are squash-merged with the title as the commit subject - Include proof it works: screenshots or recordings for anything user-visible, before/after for fixes. The dev desktop app exposes CDP for clean captures — see "Capturing screenshots via CDP" in CONTRIBUTING.md
- Check "Allow edits from maintainers" and link the issue for non-trivial changes
4. Open it
gh pr create against superset-sh/superset main, fill in the PR template honestly (what you ran, what you clicked, what's covered by tests), and report the PR URL back to the user.