Extract

educlopez/ui-craft/.agents/skills/extract

by educlopezceecc8e1fb0c2befda73da996435900d6dd0c1acNo license375 starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated 5 weeks ago

Refactoring pass — extracts repeated Tailwind class combos and markup into components, and lifts magic values into design tokens. Use when the codebase has obvious duplication, hardcoded hex values or pixel sizes, or when the user says "clean this up" / "extract components" / "tokenize styles". Invoke when the user asks for extract on their UI, or mentions 'extract' alongside design / UI / frontend work.

Instructions onlySoftware Development
AI-generated overview

Refactors frontend UI code by extracting repeated Tailwind classes and markup into components and hardcoded values into design tokens.

What it does
This skill performs a refactoring pass over a UI codebase: it scans for repeated Tailwind class combinations, repeated markup, and literal magic values such as hex colors, pixel sizes, shadows, font sizes and z-index values. It creates new component files and token additions, matches the project's existing naming, location and token conventions, and updates every call-site. It produces the new component files, a table of call-site changes, and a one-line summary of components and tokens extracted.
When to use it
Use it when a codebase shows obvious duplication, hardcoded hex values or pixel sizes, or when the user asks to clean up, extract components or tokenize styles. It is intended for design, UI or frontend work where repeated patterns should be consolidated.
Requirements
Instructions only; no scripts are shipped. It expects a UI codebase with Tailwind classes and, ideally, the broader ui-craft skill installed, plus reference files such as references/layout.md, references/typography.md and references/color.md.
<!-- HARNESS MIRROR — do not edit here. Canonical source: skills/ or commands/. After editing source, copy into cli/assets/<harness>/ and repo-root harness mirrors. -->

Context: this sub-skill is one lens of the broader ui-craft skill. If the ui-craft skill is also installed, read its SKILL.md first for Discovery + Anti-Slop + Craft Test, then apply the specific lens below.

Extract reusable pieces from $ARGUMENTS. Load the ui-craft skill.

Step 1 — Scan the target for extraction candidates:

  • Repeated Tailwind class combos — any class string that appears ≥3 times becomes a component (or a cva/tv variant if the project uses one — check first).
  • Magic values — hex colors, pixel sizes, shadow definitions, font sizes, z-index values appearing in literal form. Lift into CSS variables or theme.extend.
  • Repeated markup — blocks that differ only by text/props collapse into a single component with props.

Step 2 — Match the project's conventions, don't impose new ones:

  • Naming — look at neighboring components. PascalCase file? kebab-case file? Named export vs default export? Match exactly.
  • Location — check components/ui/, ui/, primitives/, src/components/ before creating a new directory. Reuse.
  • Tokens — respect existing CSS variable naming (--color-*, --space-*, --font-*, --radius-*). Don't introduce a parallel system.

Step 3 — Anti-Slop Test on every new component (from SKILL.md):

  • Component name must be domain-specific, not generic. MetricCard / PricingTier / InviteRow beats Card / Box / Item.
  • If the component is generic ("a card with a title and description"), ask yourself whether it should instead be an inline composition — premature abstraction is worse than repetition.

Step 4 — Update every call-site. No half-migrations.

Knob-agnostic — DRY is not tunable.

References to read: references/layout.md (composition patterns), references/typography.md and references/color.md (token naming), plus the project's existing component library (scan before writing).

Output:

  1. The new component file(s) + any token additions.
  2. A table showing every call-site update:
FileBeforeAfter
  1. A one-line delta: "Extracted N components, M tokens. Call-sites updated: X."

Next step: /tokens — lift the values you just centralized into the token spine (rung 2).

Source and attribution

Source:educlopez/ui-craftin.agents/skills/extractat commitceecc8e

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal