Skip to content

docs: add grid-tutorial skill — interactive zero-to-running Grid demo#423

Draft
jklein24 wants to merge 1 commit intomainfrom
04-30-docs_add_grid-tutorial_skill_interactive_zero-to-running_grid_demo
Draft

docs: add grid-tutorial skill — interactive zero-to-running Grid demo#423
jklein24 wants to merge 1 commit intomainfrom
04-30-docs_add_grid-tutorial_skill_interactive_zero-to-running_grid_demo

Conversation

@jklein24
Copy link
Copy Markdown
Contributor

Adds a new Claude Code skill that scaffolds a small Next.js + TypeScript
demo into a developer's working directory and walks them step-by-step
through either the Payouts or Global Accounts flow with real sandbox API
calls. Sibling to the existing grid-api skill (which is curl-based and
built for one-off requests).

Highlights:

  • Choose-your-own-adventure routing (Payouts vs Global Accounts) via
    AskUserQuestion. Within Payouts, sub-routes by corridor (CLABE/IBAN/UPI/ACH)
    and customer type (INDIVIDUAL/BUSINESS).
  • Live API calls — the skill wires the user's sandbox creds into the
    scaffolded app and runs each of the 8 happy-path requests interactively.
  • Pacing rules in SKILL.md explicitly forbid dumping all 8 steps in one
    tool call, including via && or heredoc — the tutorial discipline is the
    skill's primary value.
  • Bundled Next.js 15 + React 19 template at
    .claude/skills/grid-tutorial/assets/nextjs-template/ with one API route
    per Grid endpoint, a stepper UI, and a server-only credentials boundary
    (lib/grid.ts is the only place the secret is read).
  • Reference files for credentials, payouts, global accounts, account-type
    cheatsheet, optional webhooks add-on, and troubleshooting. Cross-refs
    are URL-first (https://grid.lightspark.com/...) so the skill works
    globally-installed without depending on an in-repo clone.
  • 3-eval iteration via skill-creator: with-skill 7/7 across all evals;
    baseline 3/7, 4/7, 5/7. Delta +0.43 pass rate.

Documents the install path on the Building with AI page and in the
top-level README:

npx skills add lightsparkdev/grid-api --skill grid-tutorial -g -a claude-code

Also adds .claude/skills/*-workspace/ to .gitignore to keep skill-creator
eval artifacts out of git.

Adds a new Claude Code skill that scaffolds a small Next.js + TypeScript
demo into a developer's working directory and walks them step-by-step
through either the Payouts or Global Accounts flow with real sandbox API
calls. Sibling to the existing `grid-api` skill (which is curl-based and
built for one-off requests).

Highlights:
- Choose-your-own-adventure routing (Payouts vs Global Accounts) via
  AskUserQuestion. Within Payouts, sub-routes by corridor (CLABE/IBAN/UPI/ACH)
  and customer type (INDIVIDUAL/BUSINESS).
- Live API calls — the skill wires the user's sandbox creds into the
  scaffolded app and runs each of the 8 happy-path requests interactively.
- Pacing rules in SKILL.md explicitly forbid dumping all 8 steps in one
  tool call, including via && or heredoc — the tutorial discipline is the
  skill's primary value.
- Bundled Next.js 15 + React 19 template at
  .claude/skills/grid-tutorial/assets/nextjs-template/ with one API route
  per Grid endpoint, a stepper UI, and a server-only credentials boundary
  (lib/grid.ts is the only place the secret is read).
- Reference files for credentials, payouts, global accounts, account-type
  cheatsheet, optional webhooks add-on, and troubleshooting. Cross-refs
  are URL-first (https://grid.lightspark.com/...) so the skill works
  globally-installed without depending on an in-repo clone.
- 3-eval iteration via skill-creator: with-skill 7/7 across all evals;
  baseline 3/7, 4/7, 5/7. Delta +0.43 pass rate.

Documents the install path on the Building with AI page and in the
top-level README:

  npx skills add lightsparkdev/grid-api --skill grid-tutorial -g -a claude-code

Also adds .claude/skills/*-workspace/ to .gitignore to keep skill-creator
eval artifacts out of git.
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 30, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
grid-flow-builder Ready Ready Preview, Comment Apr 30, 2026 5:27pm

Request Review

Copy link
Copy Markdown
Contributor Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented Apr 30, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Grid 🟢 Ready View Preview Apr 30, 2026, 5:38 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant