CtrlK
BlogDocsLog inGet started
Tessl Logo

improve-react

Survey a whole React codebase as a senior React engineer, using React Doctor's scan as evidence, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the React code", "audit this codebase", "make this app faster / more robust", or wants a roadmap of fixes rather than a review of a single diff. For a regression check or a fix-it-now pass, use the `react-doctor` skill instead.

76

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

92%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An operationally rich, well-sequenced workflow skill with concrete commands and clear validation checkpoints. Its one real defect is that the two referenced bundle files (AUDIT.md, PLAN-TEMPLATE.md) are missing, which breaks the progressive-disclosure navigation it otherwise sets up well.

Suggestions

Ship the referenced AUDIT.md and PLAN-TEMPLATE.md alongside SKILL.md, or inline the five audit categories and the plan template directly into the body so the signaled references actually resolve.

If the files are intentionally loaded lazily, add a one-line note in the body stating where they live and that they must be fetched before auditing/planning, so a missing bundle is detected early rather than at navigation time.

Trim rhetorical flourishes (e.g. the 'brutal eye for what ships to users' framing in Operating Posture) to tighten token efficiency further, though the body is already largely lean.

DimensionReasoningScore

Conciseness

Dense and operational throughout — it never explains basics Claude already knows (React, hooks, RSC) and each section carries executable guidance, with only minor rhetorical flourish that does not pad token budget meaningfully.

3 / 3

Actionability

Provides copy-paste-ready commands (npx react-doctor --json --json-out, git rev-parse --short HEAD, --scope changed), a concrete recipe URL pattern, file-naming conventions, and table schemas — fully executable, not pseudocode.

3 / 3

Workflow Clarity

Four explicitly sequenced phases (Recon, Audit, Vet, Plans) with validation checkpoints — re-read cited code, confirm at file:line, stop-and-wait for user selection, and mechanical+behavioral plan verification — plus an effort-level table.

3 / 3

Progressive Disclosure

References to AUDIT.md and PLAN-TEMPLATE.md are well-signaled and one-level-deep, but neither file exists in the bundle (no references/, scripts/, assets/, or root .md files), so the signaled navigation is broken — capping it below the 'easy navigation' anchor.

2 / 3

Total

11

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that states concrete capabilities, explicit natural-language triggers, and a clear distinction from a sibling skill. It answers what, when, and how it differs without padding.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — survey a React codebase, produce a prioritized audit, write self-contained implementation plans — with an explicit read-only constraint, matching the 'multiple specific concrete actions' anchor.

3 / 3

Completeness

Clearly answers both what (survey/audit/plan, read-only) and when via an explicit 'Use when...' clause, satisfying the full what+when anchor.

3 / 3

Trigger Term Quality

Quotes natural phrasings a user would actually say ('improve the React code', 'audit this codebase', 'make this app faster / more robust', 'roadmap of fixes'), giving good coverage of natural terms.

3 / 3

Distinctiveness Conflict Risk

Explicitly contrasts itself with the react-doctor skill (planner vs. fix-it-now) and gives distinct triggers, carving a clear niche unlikely to trigger the wrong skill.

3 / 3

Total

12

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 4 missing

Warning

Total

15

/

16

Passed

Repository
millionco/react-doctor
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.