jakubkrehel/skills installation guide

Install `jakubkrehel/skills` for Claude Code on macOS Tahoe (Apple silicon)

What this repository is

`jakubkrehel/skills` is a public, MIT-licensed collection of Agent Skills for building and reviewing product interfaces. Its skills cover UI polish, typography, colors, accessibility, layout and interface writing. It also includes user-invoked workflows for reviewing changes, comparing UI variants, stress-testing a component and explaining how an interface was built.

Claude Code classification

**Classification: Claude Code Agent Skills plugin using context injection.**

The repository has a first-party Claude Code plugin manifest named `interfaces`, and its README documents installation through Claude Code’s plugin marketplace. Installing it adds Markdown-based skills that give Claude task-specific procedures and design guidance. The supplied files do not show an MCP server, a new external tool surface or a standalone application.

The repository supports two installation methods:

1. **Claude Code plugin:** installs every skill together, gives commands an `interfaces:` namespace and supports in-place updates.
2. **Skills CLI:** lets you select individual skills or install all of them, and keeps commands under their plain names.

For someone using Claude Code, the **plugin method is the clearest default** because it is explicitly packaged for Claude Code and has a documented update command.

Before you begin

You need an existing, working Claude Code installation. The supplied repository files do not state a minimum Claude Code version or provide a command for installing Claude Code itself.

If you choose the Skills CLI method, you also need a working `npx` command. The repository does not specify a Node.js version and does not document how to install Node.js or `npx`, so this guide does not provide an unsupported setup command for them.

There are no repository-specific Apple silicon steps. The repository is described as documentation-only, with no build, lint or test tooling. No native compilation, Rosetta installation or architecture-specific package is documented. The same repository-supported commands therefore apply on macOS Tahoe with Apple silicon.

You do **not** need to clone the GitHub repository for either documented installation method.

Method 1: Install as a Claude Code plugin

Use this method when you want the complete collection in Claude Code and want the documented in-place update path.

Step 1: Open Claude Code

Start a Claude Code session using your normal method. The next two entries are Claude Code slash commands, not macOS Terminal commands. Type them into Claude Code’s input area one at a time.

Step 2: Add the repository as a plugin marketplace

Copy and paste this into Claude Code:

/plugin marketplace add jakubkrehel/skills

This registers the marketplace supplied by the repository. Wait for Claude Code to finish before continuing. The repository’s plugin and marketplace are both named `interfaces`.

Step 3: Install the plugin

Copy and paste this into the same Claude Code session:

/plugin install interfaces@interfaces

This installs every skill in the repository together. According to the README, plugin-installed skills are namespaced under `interfaces`.

Step 4: Restart Claude Code

After installation, restart Claude Code before relying on the newly installed skills. The source explicitly requires a restart after an update; restarting after initial setup is also a cautious way to begin a fresh session, although the supplied files do not state that it is mandatory for first installation.

Step 5: Confirm the command naming

The plugin form uses namespaced commands. For example, the documented change-review command is:

/interfaces:interface-review

The documented variants command is:

/interfaces:variant

`interface-review` is intended for reviewing uncommitted work, the current branch or a pull request for interface quality. `variant` builds several genuinely different UI versions behind a picker so you can compare them in the real page. These are user-invoked skills, so run them deliberately when you want those workflows.

A successful installation should make the plugin’s skills available under this `/interfaces:<skill-name>` naming pattern. The repository does not provide a separate diagnostic or version-check command for end users.

Method 2: Install with the Skills CLI

Use this alternative if you already have `npx`, want to choose which skills to install or prefer plain, non-namespaced skill commands.

Step 1: Open Terminal

On macOS Tahoe, open the Terminal application. This method’s installation command belongs in Terminal, unlike the slash commands used by the plugin method.

Step 2: Run the documented installer

Copy and paste:

npx skills add jakubkrehel/skills

The README says this works with Claude Code, Codex, Opencode and other agents. It also says you can choose which skills to install or install all of them. Follow the choices presented by the documented installer; the repository does not provide additional flags or a second noninteractive command, so none are added here.

Step 3: Use plain skill names

Skills installed through this method keep their plain names. The documented change-review invocation is:

/interface-review

This differs from the plugin form, which uses `/interfaces:interface-review`. Choose the name that matches the installation method you actually used.

The two methods install the same skills, according to the README. You generally need only one method. Installing both is not documented as necessary and may leave you with both plain and namespaced forms, so the simpler approach is to select one route.

What gets installed

The collection includes these documented skills:

• `better-interface` coordinates a cross-discipline interface review.
• `interface-review` reviews interface-related changes in uncommitted work, a branch or a pull request.
• `variant` builds multiple UI directions for comparison.
• `break` renders one component under realistic stressful states and reports visible failures.
• `explain-interface` explains layers behind an interface effect from a URL or screenshot.
• `better-ui` covers visual polish, shadows, radii, icons and motion.
• `better-typography` covers typefaces, scales, spacing, wrapping and truncation.
• `better-colors` covers palettes, tokens, theming and measured contrast.
• `better-accessibility` covers focus, keyboard use, ARIA, forms, screen readers, hit areas and motion.
• `better-layout` covers grouping, alignment, reading order and adaptive layouts.
• `better-writing` covers labels, errors, settings, empty states and other interface copy.

Some skills can be selected by Claude when their descriptions match your task. Four workflows are explicitly user-invoked: `interface-review`, `variant`, `break` and `explain-interface`.

Updating the Claude Code plugin

The plugin manifest identifies the plugin as `interfaces`; the supplied version is `1.6.2`. To request an update later, enter this documented command inside Claude Code:

/plugin update interfaces@interfaces

Then restart Claude Code. The repository states that plugin updates happen in place and that its manifest version is the update signal.

No corresponding Skills CLI update command is supplied in the provided first-party files. Do not guess one. If you used the CLI method, consult the repository’s current first-party README before attempting an update.

Troubleshooting without undocumented commands

A slash command is not recognized

First check where you entered it. Commands beginning with `/plugin` and skill invocations beginning with `/interfaces:` or `/interface-review` belong inside Claude Code, not in Terminal.

Next check the naming method:

• Plugin installation: use `/interfaces:interface-review`.
• Skills CLI installation: use `/interface-review`.

If you updated the plugin but do not see a change, restart Claude Code as the README directs.

Terminal says `npx` is unavailable

Use the Claude Code plugin method instead, or install the prerequisite from its own first-party documentation. This repository does not document a Node.js or `npx` installation command, so no command can be responsibly supplied here.

Installation still fails

The supplied repository files do not document cache-clearing, manual file copying, uninstalling or repair commands. Avoid improvised commands. Check the public repository at `https://github.com/jakubkrehel/skills` for current first-party documentation or use its GitHub issues.

Finished

For the recommended Claude Code route, setup is complete after adding the marketplace, installing `interfaces@interfaces` and restarting Claude Code. Invoke plugin skills with the `/interfaces:` prefix, and use the documented update command when you want a newer plugin version.