Terminal
Terminal/Skill
Helps build, edit, publish, share, or embed Dives, which are React and SQL data apps, on MotherDuck.
By MotherDuck
Works with
npx skills add motherduckdb/agent-skills --skill motherduck-create-diveget_dive_guide before generating Dive code and always before save_dive or update_dive. The guide defines the current component API and runtime libraries.get_dive_guide also surfaces relevant conventions from the reserved dives Guide topic. Apply those conventions when they do not conflict with the user's explicit requirements.motherduck-explore and motherduck-query; a good Dive starts with a correct query.useSQLQuery, a default export, supported runtime libraries, explicit loading/empty/error states, and no browser-side secrets.REQUIRED_DATABASES, keep the export on one line and mirror the real share dependencies in metadata or save/update inputs. Avoid aliases that collide with existing database names.list_dives returns current_version, and read_dive can fetch historical versions.motherduck-build-cfa-app when the app needs custom API contracts, writes, non-Dive routing, tenant policy enforcement, or richer authorization.get_dive_guide if MCP is available, then design the story, sections, interactions, and theme.save_dive, update_dive, or deploy only after queries, loading states, required resources, and visual behavior are correct.For answer, review, or planning requests, stop at the requested design or code artifact. For create, update, or deploy requests, carry the requested in-scope operation through preview and validation; ask before destructive replacement or a broader external rollout that the request did not authorize.
Read only the reference sections needed for the current task.
references/DIVE_DESIGN_GUIDE.md for authoring workflows, useSQLQuery mechanics, Dives-as-code, editing/version history, sharing, embedding, SQL functions, theming prompts, chart-selection rules, loading/error states, layout patterns, and implementation gotchasLoad related skills only for missing capabilities; reuse established context.
motherduck-explore for discovering the real tables, views, and dimensions before visualizing themmotherduck-query for validating the SQL each Dive section will runmotherduck-design-dive for mobile-first layout, light/dark themes, filter surfaces, reusable components, and responsive QAmotherduck-build-dashboard when the work is really a multi-section dashboard composition problemmotherduck-build-cfa-app when the requirement is a fuller product surface with per-customer isolation or backend policy controlmotherduck-cli when the agent has a shell and should keep Dive source in local filesmotherduck-manage-guides for reusable personal or organization Dive conventions