Index of every page on this site: llms.txt
All skills
Run it yourself

Reaches for the project's own components, then a maintained library, then a native feature, before writing new code.

Use this Skill: https://skilld.dev/gh/raphaelsalaja/skills/reuse

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈31 tokens for metadata: the name and description. ≈1.4k when used: this file. ≈22 more on demand in 1 file.

Description uses 1.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈124 characters, or 1.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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, including a helper with one caller, 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.

Spacing and radius come from the project's tokens. A raw 16px where --space-4 holds the same value is reuse-tokens-not-values. Colour tokens belong to color, and the z-index and type scales to defaults.

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.

The platform often removes the install. crypto.randomUUID() replaces an id package, structuredClone() a deep-copy helper and URLSearchParams a query-string parser.

Read package.json before installing. A library for a job an installed one already does, such as a second date library, is reuse-one-library-per-job.

A dependency is checked before it lands

Take the package name from the library's own documentation, never from memory. A remembered name may not exist, or may be a look-alike someone published to catch that guess. Installing a name nobody checked is reuse-confirm-the-package.

Then run npm view <name> deprecated time.modified repository.url. Install it only when it is not deprecated, its repository is not archived and it released within 12 months. A small finished utility may stay quiet longer when its issues get answers. When it fails, port the pattern instead of installing it. That is reuse-no-stale-dependency.

Read the docs before the props

Read the installed version in package.json or the lockfile, then the documentation for that major version. Use its current APIs, not ones remembered from an older release. 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-tokens-not-values padding: 16px in a project with --space-4: 16px padding: var(--space-4)
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-one-library-per-job dayjs installed beside date-fns The formatter date-fns already ships
reuse-confirm-the-package npm install of a name typed from memory The name copied from the library's docs, npm view showing its repository
reuse-no-stale-dependency A package installed whose repository is archived Its pattern ported into the project
reuse-read-the-docs render={<button />} on a trigger that is already a button The prop the docs for the installed version 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. It is also a package installed under a name nobody checked. MEDIUM is a local restyle, a second style for one kind of thing or a shared fix applied at one call site. It is also a raw value beside its token, a second library for one job or custom code a library or the platform covers. So is a prop guessed from an older version, or an icon from outside the set or off its drawn size. 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.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warningtoday3 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    This skill provides a framework for code reuse and safe dependency management. It instructs the agent to check package metadata (deprecation status, activity) before installation, which is a security best practice. However, it introduces an indirect prompt injection surface by requiring the agent to process data from project manifests and external documentation to guide its actions.

  • Sockettoday

    No alerts

  • Snyktoday

    Risk: MEDIUM · 1 issue

Signed by skilld at b2e4283. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 12 hours ago.

Activeupdated yesterday

README badge

README badge for raphaelsalaja/skills/reuse