react-expert

A research guide for React, the JavaScript library used to build user interfaces. It checks React’s source code, tests, and project discussions to find how an API or concept actually works.

In plain words
What is it for?
Use it when writing React documentation or checking APIs such as useTransition, Suspense, or startTransition. It can provide evidence-backed examples and explanations.
Why use it?
It reduces the risk of repeating outdated or incorrect React advice. It also helps uncover warnings, edge cases, and usage details that general documentation may miss.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/bskimball/tanstack-hono/react-expert
Any agent
npx skills add bskimball/tanstack-hono --skill react-expert
Clone the repo
git clone --depth 1 https://github.com/bskimball/tanstack-hono

Made for: Claude Code, Codex.

Per session 34 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,624 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00034 $0.02624
Opus 5 $0.00017 $0.01312
Sonnet 5 $0.00007 $0.00525
Haiku 4.5 $0.00003 $0.00262

Measured 2d ago against content hash bdaa978ac67a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

react-expert scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/react-expert/SKILL.md · 336 lines

How it starts

The opening of the file, as written. The whole thing — 336 lines — stays where its author put it; the contents beside it link to each section on GitHub.

React Expert Research Skill

Overview

This skill produces exhaustive documentation research on any React API or concept by searching authoritative sources (tests, source code, PRs, issues) rather than relying on LLM training knowledge.

Red Flags - STOP if you catch yourself thinking:

  • "I know this API does X" → Find source evidence first
  • "Common pattern is Y" → Verify in test files
  • Generating example code → Must have source file reference

Invocation

/react-expert useTransition
/react-expert suspense boundaries
/react-expert startTransition

Sources (Priority Order)

  1. React Repo Tests - Most authoritative for actual behavior
  2. React Source Code - Warnings, errors, implementation details
  3. Git History - Commit messages with context
  4. GitHub PRs & Comments - Design rationale (via gh CLI)
  5. GitHub Issues - Confusion/questions (facebook/react + reactjs/react.dev)
  6. React Working Group - Design discussions for newer APIs
  7. Flow Types - Source of truth for type signatures
  8. TypeScript Types - Note discrepancies with Flow
  9. Current react.dev docs - Baseline (not trusted as complete)

No web search - No Stack Overflow, blog posts, or web searches. GitHub API via gh CLI is allowed.

Workflow

Step 1: Setup React Repo

First, ensure the React repo is available locally:

# Check if React repo exists, clone or update
if [ -d ".claude/react" ]; then
  cd .claude/react && git pull origin main
else
  git clone --depth=100 https://github.com/facebook/react.git .claude/react
fi

Get the current commit hash for the research document:

cd .claude/react && git rev-parse --short HEAD

Step 2: Dispatch 6 Parallel Research Agents

Read the full file on GitHub · 336 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 336 lines · 34 tokens per session scan A bdaa978ac67a

Subscribe to this mod's changes

react-expert is a skill published in the GitHub repository bskimball/tanstack-hono (119 stars, last pushed 21d ago), licensed MIT. It adds 34 tokens to every session and 2,624 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

hono-jsx

Hono JSX - server-side rendering, streaming, async components, and HTML generation patterns.

bobmatnyc/claude-mpm-skills · 22 tokens

coss

Helps implement coss UI components correctly. Use when building UIs with coss primitives (buttons, dialogs, selects, forms, menus, tabs, inputs, toasts, etc.), migrating from shadcn/Radix to coss/Base UI, composing trigger-based overlays, or troubleshooting coss component behavior. Covers imports, accessibility…

usekaneo/kaneo · 80 tokens

release

Execute a Kobato release. Use when the user runs /release or asks to release the project. The first argument is the version to release, the second is the next development version.

syhily/kobato · 46 tokens

vercel-geist-design-system

Community skill for applying the Geist design system to Vercel-inspired rendered frontend UI across React/Next.js/Vite/Astro/Svelte/Vue/HTML/CSS, Tailwind, shadcn, and Radix. Use for typography, spacing, color, materials, components, app shells, dashboards, forms, tables, dialogs, states, responsive layout, and UI…

syhily/kobato · 141 tokens

posthog-debugger

Debug and inspect PostHog implementations on any website. Use this skill when a user wants to understand how PostHog is implemented on a page, troubleshoot tracking issues, verify configuration, check what events are being sent, or audit a PostHog setup. Works with Chrome DevTools MCP and Playwright MCP to inspect…

motormetrics/motormetrics · 72 tokens

survey-sdk-audit

Audit PostHog survey SDK features and version requirements.

motormetrics/motormetrics · 15 tokens