Skip to main content
skill CX Codex

reuse — Claude Code skill: what it does, how to install

Skill for Claude Code enforces a strict reuse hierarchy: internal project parts first, maintained libraries next, custom code last. Flags duplicate UI components and stray styles during reviews.

MIT 175 installs ★ 69 updated 2026-11-14

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add raphaelsalaja/skills --skill reuse -a claude-code
Open on GitHub

What reuse does

This skill forces the coding agent to search the shared component package, token definitions, and icon sets before writing fresh code. It flags raw HTML elements when a project wrapper exists, rejects local className overrides on shipped primitives, and bans scaling icons away from their native size. When the project lacks a needed piece, the agent must pick native platform capabilities like Intl or a maintained package over bespoke logic.

Issues follow an explicit pair format showing the faulty line alongside its direct replacement. The reporting system uses rule identifiers such as reuse-house-component-first and reuse-fix-in-the-primitive. Any remaining HIGH severity finding instantly blocks pull request approval. If an external package is unmaintained, the rule mandates porting the pattern directly instead of installing the stale dependency.

What it helps with

  • Catch duplicate UI elements before they enter shared codebases
  • Prevent ad-hoc CSS overrides on standard component variants
  • Swap hand-written utility functions for platform APIs like Intl
  • Propagate single-line bug fixes directly into core primitives

Example prompts for the agent

  • Audit this pull request against the reuse guidelines
  • Review the new dialog code and check if we duplicate existing components
  • Inspect this branch for unmaintained dependencies or custom formatters

How to install reuse

1Skills CLI (Vercel)

npx skills add raphaelsalaja/skills --skill reuse -a claude-code

2Manually: put the files in place

~/.claude/skills/reuse/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/reuse/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about reuse

How to install reuse in Claude Code?

Run npx skills add raphaelsalaja/skills --skill reuse -a claude-code. The skill will be installed to ~/.claude/skills/reuse/SKILL.md.

What does the reuse skill do?

It enforces an implementation hierarchy that prioritizes house components, native platform features, and maintained libraries before allowing custom code.

When does reuse block a code review?

The agent issues a Block status whenever any HIGH severity issue is present, such as recreating a shared component or rebuilding a control already solved by a primitive.

Source text

SKILL.md · MIT
---
name: reuse
description: Reaches for the project's own components, then a maintained library, then a native feature, before writing new code.
---

# Reuse

This skill sets the order for building anything new. The project's own parts come first, then a maintained library or a platform feature. Custom code comes last.

## A duplicate is a finding

A new component, style or icon that duplicates one the project already has is a finding. Adding a primitive to the shared package and then using it is not. A project with no shared package is judged on the libraries it already depends on.

Cutting what nobody asked for belongs to `restraint`. Copying an outside app belongs to `match`.

## The project's parts come first

Search the shared component package, the icon set and the tokens before writing UI. Name what you found. A raw `<input>` beside the project's `Input` is `reuse-house-component-first`.

## Shipped components stay as shipped

Use a component's variants and `data-*` attributes. Restyling it with a local `className` is `reuse-no-local-restyle`.

## One style per kind of thing

Keep one menu, one table and one dialog shell. A second dropdown style is `reuse-one-standard`.

## Fix it once, in the primitive

When a fix applies to every instance, make it inside the shared component. Patching five call sites is `reuse-fix-in-the-primitive`. Then search for every sibling, remove its local fix and list the files. Fixing only the cited line is `reuse-sweep-siblings`.

## Then a library or the platform

When the project has nothing, use a maintained library or a platform feature before custom code. `Intl` formats dates and numbers. The native context menu handles right-click. A hand-written formatter is `reuse-library-before-custom`.

Check that a library is maintained. When it is not, port the pattern instead of installing it. That is `reuse-no-stale-dependency`.

## Read the docs before the props

Read a primitive's documentation before using it, and use its current APIs. A guessed prop is `reuse-read-the-docs`.

## Icons from the set, at native size

Use the project's icon set at the size it was drawn for. A generated SVG, or an `18px` icon scaled to `12px`, is `reuse-icon-set-native-size`. A glyph the set lacks, drawn by `icons` and added to the shared icon package or folder, is not a finding.

## The pair

Every check is a pair. The broken line sits beside the line that replaces it.

| Rule | Broken | Replacement |
| --- | --- | --- |
| `reuse-house-component-first` | `<input className={styles.search} />` | The project's `<Input />` |
| `reuse-no-local-restyle` | `.menu { border-radius: 6px }` beside the shared `Menu` | `Menu` as shipped |
| `reuse-one-standard` | Three dropdown styles on three screens | One `Menu` |
| `reuse-fix-in-the-primitive` | A scroll fade added at five call sites | The fade inside `ScrollArea` |
| `reuse-sweep-siblings` | The cited line fixed, its siblings left | Every sibling fixed, files listed |
| `reuse-library-before-custom` | A hand-written relative date formatter | `Intl.RelativeTimeFormat` |
| `reuse-no-stale-dependency` | An unmaintained package installed | Its pattern ported into the project |
| `reuse-read-the-docs` | `render={<button />}` on a trigger that is already a button | The prop the docs describe, or none |
| `reuse-icon-set-native-size` | An `18px` icon at `width: 12px` | The `12px` icon from the set |

## Reporting

**Severity.** `HIGH` is a duplicate of an existing shared component, or a hand-built control a primitive covers. `MEDIUM` is a local restyle, an icon from outside the set or a shared fix applied at one call site. `LOW` is a library chosen without checking that it is maintained.

**Format.** One finding per root cause:

```
file:line - [rule-id] what is wrong
```

Then a `Rule | Count | Severity` summary. `Block` when any `HIGH` remains, `Approve` otherwise. Never `Approve` a file you did not read. Mark every check you could not run as `Not verified`.

© raphaelsalaja · MIT · raphaelsalaja/skills

Similar skills

All skills for Code review and refactoring →

From the same set25

The whole set →
color Validates on-screen color contrast, enforces role tokens across components, and tunes dark mode palettes. Runs during interface reviews and frontend styling tasks. CX Codex +1 178installs audit Audits diffs, branches, or codebases against an entire skill set into a ranked report. Consolidates multi-rule findings before fixes begin. CX Codex +1 176installs frames This Claude Code skill records a browser interaction under CPU throttling and identifies dropped frames or input delays. It records the same steps again to check the fix. CX Codex +1 176installs match The match Claude Code skill rebuilds a named interface part from its source and compares the result with the reference. It activates when a request points to an app, URL, screenshot, or design file. CX Codex +1 175installs restraint The restraint Claude Code skill trims changes to the requested scope. It flags extra UI, settings, and code paths during implementation and cleanup. CX Codex +1 175installs defaults defaults — a skill for Claude Code enforces interface baseline rules across surfaces, scrolling, shadows, focus states, and overlays. Audits markup against common UI flaws directly in code. CX Codex +1 174installs lab lab — a skill for Claude Code that builds an isolated preview route displaying all states and variants of actual UI components. Runs during component styling and design tuning in local development. CX Codex +1 173installs copy copy — a Claude Code skill that inspects and edits interface text. Enforces Title Case on buttons and headers, cuts excess phrasing, and bans em dashes. CX Codex +1 172installs

Project sponsors

Companies that keep this analytics open