Gadget Best Practices

Best practices for building Gadget apps. Use for Gadget-specific models, fields, actions, routes, access control, Shopify/BigCommerce integrations, frontend patterns, API client usage, internal API usage, webhooks, background jobs, testing, deployment, ggt CLI workflows, environment sync, logs, problems, and parallel agent development loops.

8 stars 2 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add gadget-inc/skills --skill gadget-best-practices
Manual install
git clone --depth 1 https://github.com/gadget-inc/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/gadget/gadget-best-practices ~/.claude/skills/gadget-best-practices

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

## How to use

This skill provides quick reference patterns and best practices for building with Gadget.

**📖 Resources:**
- Full documentation: [docs.gadget.dev](https://docs.gadget.dev)

Read individual rule files for detailed explanations and code examples:

### Core Data Modeling
- [references/models.md](references/models.md) - Data model design patterns and naming conventions
- [references/fields.md](references/fields.md) - Field types, validations, and configuration
- [references/relationships.md](references/relationships.md) - Relationship patterns (belongsTo, hasMany, hasManyThrough)
- [references/data-access.md](references/data-access.md) - Computed views and computed fields (Gelly aggregates, group by, time-series, access control)

### Backend Logic
- [references/actions.md](references/actions.md) - Model actions vs global actions, hooks, and patterns
- [references/routes.md](references/routes.md) - HTTP routes and when to use them vs actions
- [references/background-jobs.md](references/background-jobs.md) - Enqueueing actions and scheduled tasks

### Access Control & Security
- [references/access-control.md](references/access-control.md) - RBAC, permission filters, and Gelly expressions
- [references/shopify-multi-tenancy.md](references/shopify-multi-tenancy.md) - Shop isolation patterns for Shopify apps

### Platform Integrations
- [references/shopify-integration.md](references/shopify-integration.md) - Shopify app patterns (webhooks, sync triggers, metafields)
Read the full skill on GitHub

Details

Skill name
gadget-best-practices
Path
skills/gadget/gadget-best-practices/SKILL.md
Repo updated
12 November 2026

FAQ

What does the Gadget Best Practices skill do?

Best practices for building Gadget apps. Use for Gadget-specific models, fields, actions, routes, access control, Shopify/BigCommerce integrations, frontend patterns, API client usage, internal API usage, webhooks, background jobs, testing, deployment, ggt CLI workflows, environment sync, logs, problems, and parallel agent development loops.

How do I install the Gadget Best Practices skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add gadget-inc/skills --skill gadget-best-practices. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Gadget Best Practices popular?

It lives in gadget-inc/skills, which has 8 GitHub stars and 2 forks.

Related skills

Building an Exo V25 Codex

10

Exponential-Organizations/building-an-exo-skill

Apply ExO 3.0 and The Organizational Singularity OS Outline v25 to redesign a founder-led, CEO-led, board-mandated, or mission-driven organization around AI. Use for building an ExO, AI-native firms, agentic operating models, MTP protocols, the Intelligence Stack, REWRITE, DRIVE, SHAPE, Edge Twins, MVIS, Appendix A diagnostics, tokenmaxxing, vendor shortcuts, HIDO data questions, decision traces, log ownership, workforce transition, and GOVERN/ASSURE controls. Supports Direct Mode for 50 or fewer employees, Light Edge Mode, and Full Edge Mode.

Software Development

Explain

9

imgly/agent-skills

Explain how the IMG.LY SDK (CE.SDK) works: scenes, blocks, pages, fills, effects, timeline, rendering, export, asset sources, plugins. Use for "how does X work / why" questions about the engine or editor architecture.

Software Development

Cocos Creator 2415

9

hoaile2kdev/cocos-agent-skills

Use when Codex needs Cocos Creator 2.4.x/2.4.15 engine-specific guidance for TypeScript cc.Component scripts, cc._decorator/@property editor bindings, prefab/UI creation from screenshots or mockups, serialized .prefab/.fire scene authoring, cc.Node hierarchy/events/transforms, cc.assetManager/resources/bundles, cc.tween/actions, Spine sp.Skeleton, web-mobile builds, or fixes that must avoid newer Cocos APIs.

Software Development

Docuseal Code

9

docusealco/docuseal-agent-skills

DocuSeal development reference. Embed signing forms and template builder into web and mobile apps (JS/React/Vue/Angular, WebView, JWT, CSS theming). REST API with all endpoints, request/response schemas, code examples (cURL, CLI, Node.js, TypeScript, Python, Ruby, PHP, Go, C#, Java), and webhooks. Use when the user wants to integrate DocuSeal document signing or template management into their application.

Software Development

Code Review

9

quanru/code-review-skill

Perform architecture- and maintainability-focused code reviews. Use when the user asks for code review, style review, refactoring feedback, or review of architecture, cohesion, coupling, TypeScript rigor, naming, tests, responsibility boundaries, or unnecessary abstractions.

Software Development

Docuseal CLI

9

docusealco/docuseal-agent-skills

Manage DocuSeal e-signature workflows from the terminal via the DocuSeal CLI - create templates from PDF/DOCX/HTML, send documents for signing, track submissions, and update submitters. Use when the user wants to run DocuSeal commands in the shell, scripts, or CI/CD pipelines. Always load this skill before running `docuseal` commands.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.