Skip to content
Skills Library
Programming · Building & coding

react-run

/react-run

Set up and enforce the tiny `run()` utility in a React/TypeScript project — `run(() => { if (…) return …; return …; })` for inline logic in JSX instead of nested ternaries or IIFEs — with three Biome GritQL lint rules. Use when the user says "add run", "/react-run", "set up the run utility", "enforce run()", or when starting or working in a React/TSX project that doesn't have `run` and its Biome rules yet.

Licence
MIT
Last repository change
06.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
2
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 06.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 2 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: run.ts, test/cases.tsx

What it does and when to use it

Set up and enforce the tiny `run()` utility in a React/TypeScript project — `run(() => { if (…) return …; return …; })` for inline logic in JSX instead of nested ternaries or IIFEs — with three Biome GritQL lint rules. Use when the user says "add run", "/react-run", "set up the run utility", "enforce run()", or when starting or working in a React/TSX project that doesn't have `run` and its Biome rules yet.

Triggers from the description

add runset up the run utilityenforce run()
Original author description

Set up and enforce the tiny `run()` utility in a React/TypeScript project — `run(() => { if (…) return …; return …; })` for inline logic in JSX instead of nested ternaries or IIFEs — with three Biome GritQL lint rules. Use when the user says "add run", "/react-run", "set up the run utility", "enforce run()", or when starting or working in a React/TSX project that doesn't have `run` and its Biome rules yet.

How it works

  1. The rules (files next to this SKILL.md)
  2. Steps
  3. Notes on the GritQL
Original SKILL.md headings · 47 lines, 527 words
SKILL.md preview
---
name: react-run
description: Set up and enforce the tiny `run()` utility in a React/TypeScript project — `run(() => { if (…) return …; return …; })` for inline logic in JSX instead of nested ternaries or IIFEs — with three Biome GritQL lint rules. Use when the user says "add run", "/react-run", "set up the run utility", "enforce run()", or when starting or working in a React/TSX project that doesn't have `run` and its Biome rules yet.
---

# run() utility + Biome rules

Pattern from https://www.edoardolunardi.dev/blog/writing-cleaner-react-with-a-tiny-utility (after Max Greenwald's "Do More With Run"):

```ts
export const run = <T,>(fn: () => T): T => fn();
```

- **Use it** for inline logic inside JSX (one condition per line with early returns, and TypeScript narrows per branch), for scoped async work in server components (`await run(async () => { … })`), and anywhere you'd otherwise write an IIFE.
- **Don't use it** when you're already in a function body (write the ifs directly) or for trivial cases (`run(() => x)` is just `x`). Keep each block short; extract a function when it grows.

## The rules (files next to this SKILL.md)

| File | Flags | Severity |
|---|---|---|
| `biome-plugins/run-no-nested-ternary-jsx.grit` | A ternary with another ternary in a branch, inside a JSX child `{…}` or attribute value | error |
| `biome-plugins/run-no-iife.grit` | `(() => …)()`, `(async () => …)()`, `(function () {…})()`, `(async function () {…})()` | error |
| `biome-plugins/run-misuse.grit` | `return run(…)` / `return await run(…)` (already in a function body) and trivial `run(() => expr)` without a block | warn |

Nested ternaries outside JSX are left alone (Biome's own `style/noNestedTernary` covers those if wanted). `test/cases.tsx` has 8 bad and 5 good examples; all 8 bad ones fire and no good ones. Parenthesised nested ternaries count too.

## Steps

1. **Check the project.** React + TS/JS (package.json, tsconfig). Find the package manager from the lockfile (package-lock → npm, pnpm-lock → pnpm, yarn.lock → yarn, bun.lock(b) → bun) and the utils folder the project already uses (`src/lib`, `src/utils`, `lib`, `app/lib`…).
2. **Add the utility.** Copy `run.ts` from this skill into that folder (default `src/lib/run.ts`). If the project already has an equivalent helper, keep theirs and point the rules' messages at it.
3. **Biome.**
   - Has Biome (`biome.json`/`biome.jsonc`): needs v2+ for plugins. Check `npx biome --version`; if it's 1.x, say so and ask before upgrading (`npx @biomejs/biome migrate`).
   - No Biome: install it pinned (`npm i -D -E @biomejs/biome`, or the project's package manager) and create `biome.json` with `npx biome init`. If the project already lints and formats with ESLint/Prettier, don't remove them: tell the user Biome will run next to them for these rules, and offer to turn Biome's formatter off (`"formatter": { "enabled": false }`) so the two don't fight.
4. **Copy the rules** into `biome-plugins/` at the project root and register them in biome.json:
   ```json
   "plugins": [
     "./biome-plugins/run-no-nested-ternary-jsx.grit",
     "./biome-plugins/run-no-iife.grit",
     "./biome-plugins/run-misuse.grit"
   ]
   ```
   Add a `lint` script if there's none (`"lint": "biome lint ."`).
5. **Run it**: `npx biome lint --only=plugin .` and report what fires. Don't rewrite existing code unless the user asks; when they do, convert each finding to `run()` by hand (the rules have no auto-fix because a fix would also need the import).
6. **Write new code to the rules** from then on.

## Notes on the GritQL

- Biome 2.x loads `.grit` files via `plugins`; diagnostics come from `register_diagnostic(span, message, severity)`. Docs: https://biomejs.dev/linter/plugins/
- Node names like `JsxExpressionChild()`, `JsxExpressionAttributeValue()`, `JsFunctionBody()` are Biome CST names; check with the Biome playground if a newer version renames them.
- Suppress a single finding with `// biome-ignore lint/plugin: <reason>`.
Files in this package (6)
  • SKILL.md 4 KB
  • run.ts 1 KB
  • biome-plugins/run-misuse.grit 1 KB
  • biome-plugins/run-no-iife.grit 1 KB
  • biome-plugins/run-no-nested-ternary-jsx.grit 1 KB
  • test/cases.tsx 2 KB

Versions

The database has no other skills named react-run.

Database snapshot: 13.11.2026 · package version 8c89a4870f3c (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100biome
    Biome is a single Rust-based tool that formats code and lints JavaScript, TypeScript, JSX, JSON and CSS, and sorts imports, as a faster replacement for ESLint plus Prettier. Use when a user wants to set up biome.json, replace ESLint or Prettier, migrate their configs, run lint…
  • 100react-best-practices
    Use when reading or writing React components (.tsx, .jsx files with React imports).
  • 100typescript-dev
    Full-stack TypeScript with Vite 8, React 19, Tailwind v4, shadcn/ui, Biome, Vitest, and Hono 4. Use when setting up or working in a TypeScript project - components, styling, build and HMR, tests, lint/CI, or a Hono API with type-safe RPC.
  • 100react
    React 18+ framework guardrails, patterns, and best practices for AI-assisted development. Use when working with React projects (.jsx/.tsx files), or when the user mentions React. Provides component patterns, hooks, state management, testing, and performance guidelines.
  • 100biome-linting
    Analyze, fix, and validate Biome linting workflows. Use when JavaScript or TypeScript projects need Biome commands, diagnostics, safe fixes, or CI lint gates.
  • 100single-tool-per-job
    Biome is enough. I don't run ESLint or Prettier — never alongside Biome, never instead of it. For every other job (types, tests, packages, build, scripts), one tool. Use when adding lint/format/build/test tooling, when proposing dev dependencies, or when user mentions "Biome",…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.