What problem does it solve? Public React component and hook APIs often allow invalid prop combinations, ambiguous controlled/uncontrolled state ownership, and vague callback contracts that break consumers. This Skill audits exported TypeScript component and hook contracts and reports concrete, severity-ranked findings with suggested signature rewrites. ## Core Features & Use Cases - API Contract Audit: Inspects exported props types, hook signatures, children contracts, callbacks, generics, and polymorphic as props for unsound or ambiguous consumer contracts. - Severity-Ranked Findings: Reports blockers, medium, and low-risk issues with concrete invalid call sites and before/after type rewrites using discriminated unions and never props. - Detailed Checklist Reference: Loads references/component-api-rules.md covering boolean flag explosions, controlled/uncontrolled unions, compound components, reusable hooks, and acceptable tradeoffs. - Use Case: Before publishing a design-system Select component, run this review to catch that multiple does not change the value and onValueChange types, then apply the suggested single/multi discriminated union. ## Quick Start Ask the agent to review the public API of your exported React components and hooks in the current working changes and report findings with file locations without editing code.
