docs: improve react devtools performance routing

Author: thymikee

skills/react-devtools/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: react-devtools
-description: Inspect and profile React Native component trees from agent-device. Use when debugging React Native props, state, hooks, render causes, slow components, excessive rerenders, or questions like why a component rerendered.
+description: Inspect and profile React Native component trees from agent-device. Use for React Native performance, profiling, props, state, hooks, render causes, slow components, excessive rerenders, or questions like why a component rerendered.
 ---
 
 # react-devtools
@@ -11,7 +11,7 @@ Router for React Native internals. Read current CLI guidance:
 agent-device help react-devtools
 ```
 
-Use `agent-device react-devtools ...` for component tree, props, state, hooks, render ownership, slow components, or rerenders. It dynamically runs pinned `agent-react-devtools@0.4.0`. Use normal `agent-device` commands for visible UI, refs, screenshots, logs, network, or perf.
+Use `agent-device react-devtools ...` for component tree, props, state, hooks, render ownership, performance profiling, slow components, or rerenders. It dynamically runs pinned `agent-react-devtools@0.4.0`. Use normal `agent-device` commands for visible UI, refs, screenshots, logs, network, or device-level perf.
 
 Core loop:
 

src/__tests__/cli-help.test.ts

@@ -48,7 +48,7 @@ test('help react-devtools prints agent workflow topic and skips daemon dispatch'
   assert.equal(result.code, 0);
   assert.equal(result.calls.length, 0);
   assert.match(result.stdout, /agent-device help react-devtools/);
-  assert.match(result.stdout, /React Native internals/);
+  assert.match(result.stdout, /React Native performance\/profiling/);
   assert.match(result.stdout, /agent-device react-devtools status/);
 });
 

src/utils/__tests__/args.test.ts

@@ -793,7 +793,10 @@ test('usage includes agent workflows, config, environment, and examples footers'
   assert.match(usageText, /Agent Workflows:/);
   assert.match(usageText, /help workflow\s+Normal bootstrap, exploration, and validation loop/);
   assert.match(usageText, /help debugging\s+Logs, network, alerts, diagnostics, and traces/);
-  assert.match(usageText, /help react-devtools\s+React Native component tree and render profiling/);
+  assert.match(
+    usageText,
+    /help react-devtools\s+React Native performance, profiling, component tree, and renders/,
+  );
   assert.match(usageText, /Configuration:/);
   assert.match(
     usageText,

src/utils/command-schema.ts

@@ -161,7 +161,10 @@ const FIND_SNAPSHOT_FLAGS = ['snapshotDepth', 'snapshotRaw'] as const satisfies
 const AGENT_WORKFLOWS = [
   { label: 'help workflow', description: 'Normal bootstrap, exploration, and validation loop' },
   { label: 'help debugging', description: 'Logs, network, alerts, diagnostics, and traces' },
-  { label: 'help react-devtools', description: 'React Native component tree and render profiling' },
+  {
+    label: 'help react-devtools',
+    description: 'React Native performance, profiling, component tree, and renders',
+  },
   { label: 'help remote', description: 'Remote config, tenants, leases, and companion tunnels' },
   { label: 'help macos', description: 'Desktop, frontmost-app, and menu bar surfaces' },
   { label: 'help dogfood', description: 'Exploratory QA report workflow' },
@@ -295,7 +298,7 @@ React DevTools minimum loop:
 
 Escalate:
   help debugging       logs, network, alerts, traces, flaky runtime failures
-  help react-devtools  props, state, hooks, component tree, slow renders, rerenders
+  help react-devtools  React Native performance, profiling, props/state/hooks, slow renders, rerenders
   help remote          remote-config, tenant, lease, remote Android companion tunnel
   help macos           desktop, frontmost-app, menu bar surfaces
   help dogfood         exploratory QA report workflow`,
@@ -346,13 +349,13 @@ Stabilizers:
   Re-enable settings you changed before finishing.
 
 React Native internals:
-  If the question is about props, state, hooks, render causes, slow components, or rerenders, use help react-devtools instead of inferring from screenshots or logs.`,
+  If the question is about React Native performance, profiling, props, state, hooks, render causes, slow components, or rerenders, use help react-devtools instead of inferring from screenshots or logs.`,
   },
   'react-devtools': {
-    summary: 'React Native component tree and profiling workflow',
+    summary: 'React Native performance, profiling, and component internals',
     body: `agent-device help react-devtools
 
-Use this for React Native internals that the accessibility tree cannot expose: components, props, state, hooks, ownership, slow renders, and rerenders.
+Use this for React Native performance/profiling and internals that the accessibility tree cannot expose: components, props, state, hooks, ownership, slow renders, and rerenders.
 
 Core commands:
   agent-device react-devtools status
@@ -1507,8 +1510,8 @@ const COMMAND_SCHEMAS: Record<string, CommandSchema> = {
     usageOverride: 'react-devtools [...args]',
     listUsageOverride: 'react-devtools [...args]',
     helpDescription:
-      'Run pinned agent-react-devtools commands for React Native component trees, props/state/hooks, and render profiling',
-    summary: 'Inspect and profile React Native component trees',
+      'Run pinned agent-react-devtools commands for React Native performance profiling, component trees, props/state/hooks, and render analysis',
+    summary: 'Profile React Native performance and component renders',
     positionalArgs: ['args?'],
     allowsExtraPositionals: true,
     allowedFlags: [],