devtools-react — Claude Code skill: what it does, how to install
devtools-react is a skill that adds a developer panel to React json-render apps for spec inspection, state editing, and action and stream timelines.
Apache-2.0 215 installs ★ 19,802 updated 2026-10-24
npx skills add vercel-labs/json-render --skill devtools-react -a claude-codeWhat devtools-react does
The skill mounts JsonRenderDevtools inside the json-render provider and connects a developer panel with spec inspection, state editor, action and stream timelines, component catalog, and DOM picker. The panel opens with Ctrl/Cmd + Shift + J and is hidden in production builds.
Installation requires two packages: @json-render/devtools and @json-render/devtools-react. The useJsonRenderDevtools hook gives imperative access to the panel from any component inside the provider: devtools?.open(), devtools?.toggle(), devtools?.recordEvent(). In production or before mount, the hook returns null.
Server-side streams are instrumented through the core @json-render/devtools package; the adapter is client-only.
What it helps with
- mount the devtools panel in a React json-render app
- inspect renderer specs, state and actions
- record stream events and debug the timeline
- open or close the panel programmatically from a component
- pick a DOM element and view its spec
Example prompts for the agent
- Add
JsonRenderDevtoolsto the provider, passspec,catalogandmessages - Open the devtools panel with
Cmd+Shift+J - Show how to record a stream event with
useJsonRenderDevtools
How to install devtools-react
1Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill devtools-react -a claude-code2Manually: put the files in place
~/.claude/skills/devtools-react/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/devtools-react/
1Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill devtools-react -a codex2Manually: put the files in place
.agents/skills/devtools-react/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill devtools-react -a cursor2Manually: put the files in place
.cursor/skills/devtools-react/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install vercel-labs/json-render skills/devtools-react2Manually: put the files in place
.github/skills/devtools-react/SKILL.md1Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill devtools-react -a gemini-cli2Platform CLI
gemini skills install https://github.com/vercel-labs/json-render --path skills/devtools-reactManually: put the files in place
.devin/skills/devtools-react/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill devtools-react -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about devtools-react
How to install devtools-react in Claude Code?
Run npx skills add vercel-labs/json-render --skill devtools-react -a claude-code, then open ~/.claude/skills/devtools-react/SKILL.md.
What does devtools-react do?
React adapter for the json-render developer panel: spec inspection, state editing, action and stream timelines, component catalog, DOM picker. The panel is hidden in production.
Why do I need both devtools and devtools-react?
The core @json-render/devtools package contains the panel and server-side tools, while @json-render/devtools-react is the React adapter with the useJsonRenderDevtools hook for imperative control.
Source text
SKILL.md · Apache-2.0
---
name: devtools-react
description: React adapter for the json-render devtools inspector. Use whenever the user wants to add, configure, or troubleshoot @json-render/devtools-react in a React json-render app, including spec inspection, state editing, action and stream timelines, catalog browsing, or DOM picking.
---
# @json-render/devtools-react
React adapter for the json-render devtools panel. Read `skills/devtools/SKILL.md` for the shared panel capabilities, props, docking behavior, and server-side stream taps.
## Install
```bash
npm install @json-render/devtools @json-render/devtools-react
```
## Mount the panel
Mount `JsonRenderDevtools` inside the existing React json-render provider so it can observe the renderer's state, actions, and streams:
```tsx
import { JsonRenderDevtools } from "@json-render/devtools-react";
<JSONUIProvider registry={registry} handlers={handlers}>
<Renderer spec={spec} registry={registry} />
<JsonRenderDevtools spec={spec} catalog={catalog} messages={messages} />
</JSONUIProvider>;
```
The component renders nothing in production builds. The panel provides the shared devtools controls, including the `Ctrl`/`Cmd` + `Shift` + `J` shortcut.
## Imperative controls
Use `useJsonRenderDevtools` from any mounted React descendant:
```tsx
import { useJsonRenderDevtools } from "@json-render/devtools-react";
const devtools = useJsonRenderDevtools();
devtools?.open();
devtools?.toggle();
devtools?.recordEvent({ kind: "stream-text", at: Date.now(), text: "hi" });
```
The hook returns `null` in production or before the component has mounted. Keep server-side stream instrumentation in `@json-render/devtools`.
© vercel-labs · Apache-2.0 · vercel-labs/json-render