Skip to content
cccskills
FreePublished on GitHub

vercel-composition-patterns

React composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.

The English summary is being prepared. Showing the original description.

Works withVercel
See how to install

Files included (11)

  • SKILL.md2.8 KB
  • AGENTS.md22.1 KB
  • README.md2.1 KB
  • rules/architecture-avoid-boolean-props.md2.2 KB
  • rules/architecture-compound-components.md2.5 KB
  • rules/patterns-children-over-render-props.md1.8 KB
  • rules/patterns-explicit-variants.md2.3 KB
  • rules/react19-no-forwardref.md953 B
  • rules/state-context-interface.md4.9 KB
  • rules/state-decouple-implementation.md2.6 KB
  • rules/state-lift-state.md3.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

React Composition Patterns

Composition patterns for building flexible, maintainable React components. Avoid boolean prop proliferation by using compound components, lifting state, and composing internals. These patterns make codebases easier for both humans and AI agents to work with as they scale.

When to Apply

Reference these guidelines when:

  • Refactoring components with many boolean props
  • Building reusable component libraries
  • Designing flexible component APIs
  • Reviewing component architecture
  • Working with compound components or context providers

Rule Categories by Priority

PriorityCategoryImpactPrefix
1Component ArchitectureHIGHarchitecture-
2State ManagementMEDIUMstate-
3Implementation PatternsMEDIUMpatterns-
4React 19 APIsMEDIUMreact19-

Quick Reference

1. Component Architecture (HIGH)

  • architecture-avoid-boolean-props - Don't add boolean props to customize behavior; use composition
  • architecture-compound-components - Structure complex components with shared context

2. State Management (MEDIUM)

  • state-decouple-implementation - Provider is the only place that knows how state is managed
  • state-context-interface - Define generic interface with state, actions, meta for dependency injection
  • state-lift-state - Move state into provider components for sibling access

3. Implementation Patterns (MEDIUM)

  • patterns-explicit-variants - Create explicit variant components instead of boolean modes
  • patterns-children-over-render-props - Use children for composition instead of renderX props

4. React 19 APIs (MEDIUM)

⚠️ React 19+ only. Skip this section if using React 18 or earlier.

  • react19-no-forwardref - Don't use forwardRef; use use() instead of useContext()

How to Use

Read individual rule files for detailed explanations and code examples:

rules/architecture-avoid-boolean-props.md
rules/state-context-interface.md

Each rule file contains:

  • Brief explanation of why it matters
  • Incorrect code example with explanation
  • Correct code example with explanation
  • Additional context and references

Full Compiled Document

For the complete guide with all rules expanded: AGENTS.md

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image/font optimization, bundling

The English summary is being prepared. Showing the original description.

vercel-labs/openreview1.7KUpdated Mar 7, 2026

Next.js 16 Cache Components - PPR, use cache directive, cacheLife, cacheTag, updateTag

The English summary is being prepared. Showing the original description.

vercel-labs/openreview1.7KUpdated Mar 7, 2026

Upgrade Next.js to the latest version following official migration guides and codemods

The English summary is being prepared. Showing the original description.

vercel-labs/openreview1.7KUpdated Mar 7, 2026

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

The English summary is being prepared. Showing the original description.

vercel-labs/openreview1.7KUpdated Mar 7, 2026

React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.

The English summary is being prepared. Showing the original description.

vercel-labs/openreview1.7KUpdated Mar 7, 2026

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

The English summary is being prepared. Showing the original description.

vercel-labs/openreview1.7KUpdated Mar 7, 2026

See all skills by vercel-labs

Report a problem with this skill