Design vs Docs & Writing · both proven

vercel-composition-patterns vs writing-plans

Both skills were run through Claude twice: once on a fixed brief without the skill, once with it. The briefs differ because each is written for the job the skill claims to do, so compare each skill against its own baseline, then decide which difference matters for your work. They are in different categories, so this is a choice of job, not a head-to-head on the same job.

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.

Category: Design
Source: vercel-labs/agent-skills
License: Not stated
Proof model: claude-opus-5-5
Brief: “Refactor this React Modal component. It currently takes fourteen props, including isConfirm, isDanger, showFooter, footerAlign, hideClose, title, subtitle, icon, primaryLabel, secondaryLabel, onPrimary, onSecondary, size and children, and a dozen screens pass different combinations of them. Present the refactor as a single HTML page with the new API, the implementation, three call sites rewritten before and after, and a short note on why the new shape scales.”
Skill commit: 063bee9

Without the skillWith vercel-composition-patterns

⇆

Without, runWith vercel-composition-patterns, run3 independent runs per side, none selected by hand.

Download the with-skill page

writing-plans

Use when you have a spec or requirements for a multi-step task, before touching code

Category: Docs & Writing
Source: obra/superpowers
License: MIT
Proof model: claude-opus-5-5
Brief: “Write the implementation plan for adding team accounts to a solo-user invoicing SaaS (Next.js, Postgres, Stripe): users must be able to create a team, invite members by email, assign owner or member roles, and share clients and invoices within the team, with billing moving from the user to the team. Present the plan as a single HTML page.”
Skill commit: bb92a77

Without the skillWith writing-plans

⇆

Without, runWith writing-plans, run3 independent runs per side, none selected by hand.

Download the with-skill page

We don’t pick a winner for you: the pages are the evidence. Both proofs can be repeated with the brief, model and commit shown above. See alternatives to vercel-composition-patterns or alternatives to writing-plans.