Docs

The expert skills

Twenty-seven skills that teach an AI assistant how to build with Grit, plus the reference material they read. They are not a prompt: each one reads the docs out of the grit binary rather than from memory, interviews you once and remembers the answers, and files what Grit got wrong as an issue while it works.

grit skills install the pack, at user level
grit skills install --all the pack and the five skills it works better with
grit skills status what is installed

The pack is MUKE-coder/grit-expert-skills, and it is public, so you can read every skill before installing it. That is worth doing: a skill tells an agent how to write code in your project.

Start with one of them

grit-build is the router. It reads the project, works out which architecture it is, asks you the questions it cannot answer from the files, and then calls the others in order. You do not have to pick from the list below: the list is there so you can see what it will reach for, and so you can name one directly when you already know which you want.

Start here

SkillWhat it doesWhen it fires
grit-buildThe router for a Grit project. Reads the project, interviews you once, then assigns the work to the right experts in the right order and runs them.build X, add this feature, what should I do next, set up this project, or any request big enough to touch more than one layer.
grit-coreThe Grit framework itself: conventions, the API contract, the folder structure, what belongs in the framework versus what you build, and how to model a domain before any code is generated.how does Grit do X, where should this live, model this domain, is this the right shape, or any decision that the rest of the build will be derived from.
grit-setupInstall and check what the Grit experts depend on: the external skills they use for design research and browser testing, the GitHub CLI for filing issues, and the Grit binary itself.set up the grit experts, install the dependencies, or when another expert says a skill is missing.

The architecture you chose

SkillWhat it doesWhen it fires
grit-tripleThe triple architecture: the Go API, a customer-facing Next.js web app, and a separate Next.js admin, in one pnpm monorepo with a shared package.grit.json says triple, for scaffold a triple project, wire this resource into web and admin, or any monorepo or shared-package problem.
grit-doubleThe double architecture: the Go API plus one frontend, with the admin as a route group inside it.grit.json says double, for scaffold a double project, where does the admin live here, or when deciding between double and triple.
grit-singleThe single architecture: one app that is both the frontend and the project root, with the Go API beside it and the admin as a section.grit.json says single, for scaffold a single project, where is the shared package here, or Vite and TanStack questions in a Grit project.

Building

SkillWhat it doesWhen it fires
grit-resourceRun Grit's generator correctly: field types, the flags, inline fields versus a YAML definition, conditional fields, relationships, and removing a resource cleanly.generate a resource, add a field, what field type should this be, grit generate, grit remove.
grit-dataGORM, migrations, indexes, seeders, queries and Postgres in a Grit project.the query is slow, add an index, write a migration, seed some data, this hook is not firing, import a spreadsheet, or anything where the database is the thing being changed.
grit-adminThe Grit admin panel: resource definitions, the data table, the form builder, dashboard widgets, the sidebar, bulk actions and the system pages.add an admin screen, the admin table, a dashboard widget, the form is wrong, customise the admin, the sidebar.
grit-ui-uxDesign the customer-facing surfaces: research a pattern before building it, hold the result to the anti-slop standard, and get motion and accessibility right.design this page, make it look better, it looks generic, design review, add animation, a landing page, or any screen a customer sees.
grit-pluginsGrit plugins: what already exists so you do not rebuild it, whether a feature should be a plugin at all, writing one from scratch, and proposing one for Grit to ship officially.is there a plugin for this, write a plugin, should this be a plugin, grit plugin add, package this up, suggest a plugin, multi-tenancy, a kanban board, a calendar.
grit-blueprintsGrit blueprints: what complete applications already exist to start from or read, whether the thing being built should become one, working inside a blueprint repository, and proposing a new one.is there an example of this, what should I start from, how did they do chat, make this a blueprint, grit blueprint, suggest a blueprint.

Other surfaces

SkillWhat it doesWhen it fires
grit-mobileThe Expo app: screens against the shared API and types, offline field use, uploads, images, haptics, and getting through App Store and Play review.add a mobile app, the Expo app, field mode, submit to the store, my app was rejected, the image will not load on my phone.
grit-desktopThe Wails desktop app: offline-first with a local SQLite mirror and a sync outbox, Go bindings to React, packaging, and shipping updates through GitHub Releases.add a desktop app, make it work offline, the desktop build, auto-update, the installer.
grit-offlineDesign and build the offline engine for a desktop or mobile app: the local mirror, the write outbox, sync and replay, conflict rules, and what must never be queued.make it work offline, offline first, field mode, sync when the connection comes back, the outbox, it works but not on site.

Before you ship

SkillWhat it doesWhen it fires
grit-reviewerRead the diff and find the bugs before a user does, with the failure modes a Grit project actually has.review this, check my changes, did I break anything, review before I commit, or as the last step of any build.
grit-criticThe independent review of a feature somebody has marked done: runs it, reads the backend for bottlenecks, profiles it, looks at the UI, checks the tests actually test it, and says what to fix in priority order.review this feature, is this really done, quality check, find the bottlenecks, it is marked complete, sign this off, or before any demo.
grit-design-reviewAssess a page against Grit's visual contract in DESIGN.md: measures the budgets (type styles, radii, rhythm, shadows, contrast, measure, target size), diffs it against the designer's mockup, then looks at it, then says what to fix in order.review this page, does this meet our design standard, design review, is this page consistent, check the landing page, does this match the design, before I ship this page, or after building any new page or section.
grit-securityAuth, authorization, the WAF and the scanner in a Grit project: sessions, RBAC, per-resource policies, Sentinel, Scout, API keys and the route table.is this secure, add roles, who can do this, set up the WAF, run a security scan, a pentest found this, lock down this endpoint.
grit-perfMake a Grit app fast, starting from a measurement: Pulse for profiling and N+1 detection, k6 for load, caching, pagination and query work.it is slow, load test this, find the N+1, why is this endpoint slow, add caching, performance review.

Operations

SkillWhat it doesWhen it fires
grit-deployGet a Grit project onto a server and keep it there: Docker Compose, Dokploy on a VPS, environment variables, storage, migrations on deploy, CI, and the desktop release.deploy this, set up the VPS, dokploy, production env vars, the build fails in CI, ship a release.
grit-adoptBring an existing Grit project up to the current framework without breaking what already works, and decide which new features are worth adopting afterwards.Also checks whether the core batteries (Sentinel, Pulse, GORM Studio, Scout) are in step. Use for upgrade this project, we are on an old Grit, is this project out of date, what would upgrading cost, are our versions in sync, how do we adopt the new features, migrate this project.

About the work itself

SkillWhat it doesWhen it fires
grit-reportReport on how the experts are actually performing on this project: route accuracy, whether they verified, how much they asked, framework friction and rework.how are the experts doing, grit report, was that efficient, which expert is wasting time, or at the end of a phase.
grit-tokensWhat this project has spent on tokens, where it went and who the big spender is, read from Claude Code's own transcripts. Alerts at a threshold and reports every increment, and writes an HTML page with the full breakdown.how many tokens have we used, what is this costing, token report, why is my context filling up, which tool is expensive, or set it running to be told as the number grows.
grit-feedbackFile what Grit got wrong as a GitHub issue, and check later whether the fix shipped.an expert hits a framework bug, a missing feature, or has to hand-write something Grit should have given it, and for has that issue been fixed, check my grit issues, what did we file.
grit-advocateWatches the work and files what is worth telling people about as an issue in MUKE-coder/grit-stories, each with the evidence, the channel it suits and a draft ready to post.is there a story in this, write that up, what should I post about, turn this into a LinkedIn post, case study, what have we got to share, or at the end of a build.
grit-teacherTurns a feature that just shipped into a tutorial a beginner can follow in a fresh project, with the real-world scenario it is for and a checkpoint at every step. Writes one markdown file per lesson into .grit/tutorials/.write a tutorial for this, teach this to a beginner, how would someone new build this, explain this for a learner, turn this into a lesson, document how to do it from scratch, or after a feature is verified and shipped.

Read by the others

SkillWhat it doesWhen it fires
grit-referencesReference material the Grit experts read on demand.Not a skill to invoke on its own: the other grit-* skills name the file they need and read it from this directory. If you are looking for what to do, use grit-build.

Four things get called a Grit skill

They do different jobs, and knowing which one you are reading matters more than it sounds. Only the first is this pack:

this packThe twenty-seven above, plus the reference material. Installed by grit skills install into the configuration your agent reads, at user level or per project.
skills/grit/SKILL.mdOne general skill, in the Grit repository. Smaller, and not the same thing as the pack.
.claude/skills/grit/SKILL.mdWritten into your project by grit new, and tailored to the architecture you chose.
GRIT_SKILL.mdA single file of framework context to paste into an assistant that has no skill mechanism.

The last of those is for an assistant with no skill mechanism at all, and the LLM skill guide covers it.