# What Is the emilkowalski/skills Repository? A Design Engineer's Knowledge Base

> Explore the emilkowalski/skills repository, a markdown knowledge base for AI agent design-engineering best practices. Install and use these modules with the skills CLI.

- Repository: [Emil Kowalski/skills](https://github.com/emilkowalski/skills)
- Tags: getting-started
- Published: 2026-08-08

---

**The emilkowalski/skills repository is a curated collection of markdown-defined knowledge modules that encode design-engineering best practices for AI agents and developers, installable via the `skills` CLI.**

The emilkowalski/skills repository serves as a **knowledge-base-as-code** for design engineers seeking deterministic UI quality. It packages Emil Kowalski’s design philosophy into discrete, machine-readable skill files that enforce high-craft standards when generating or reviewing interface code. Each skill is a self-contained markdown module consumable by both human developers and automated agents.

## Architecture and Core Components

The repository follows a modular architecture where knowledge is separated from execution. The **[`README.md`](https://github.com/emilkowalski/skills/blob/main/README.md)** provides the high-level description and CLI installation instructions, while individual skill definitions reside as standalone markdown files.

**Skill definitions (`*.md`)** form the core payload. Located in paths such as [`skills/emil-design-eng/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/skills/emil-design-eng/SKILL.md) and [`skills/review-animations/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/skills/review-animations/SKILL.md), each file declares a name, description, and deterministic rules that an AI or CLI can follow. These cover domains including design philosophy, animation review, improvement plans, vocabulary standardization, library selection, and rapid prototyping.

**[`STANDARDS.md`](https://github.com/emilkowalski/skills/blob/main/STANDARDS.md)** acts as the central configuration source. Referenced by multiple skills—particularly [`skills/review-animations/STANDARDS.md`](https://github.com/emilkowalski/skills/blob/main/skills/review-animations/STANDARDS.md)—this file concretezes abstract principles into measurable values: easing curves, duration tables, spring configurations, performance rules, and accessibility guidelines.

The **CLI entry point** bridges these markdown definitions to developer workflows. The command `npx skills@latest add emilkowalski/skills` pulls the repository into a user’s project, transforming static markdown into executable prompt templates that can be invoked programmatically via chat assistants or CI pipelines.

## Available Skills and Workflow Coverage

The repository targets specific design-engineering workflows through domain-specialized skills:

- **[`emil-design-eng/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/emil-design-eng/SKILL.md)** – Core philosophy on UI polish, animation decision frameworks, and performance-first CSS patterns.
- **[`review-animations/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/review-animations/SKILL.md)** – Implements ten non-negotiable rules for auditing animation code, referencing line-specific standards to generate findings.
- **[`improve-animations/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/improve-animations/SKILL.md)** – Generates prioritized, self-contained plans to upgrade existing animations with concrete mitigation steps.
- **[`find-animation-opportunities/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/find-animation-opportunities/SKILL.md)** – Detects UI areas that would benefit from motion while explicitly identifying when animation adds noise rather than value.
- **[`animation-vocabulary/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/animation-vocabulary/SKILL.md)** – Provides exact terminology for prompting AI-generated animation code, ensuring consistent output quality.
- **[`apple-design/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/apple-design/SKILL.md)** – Distilled Apple design principles adapted for web motion implementation.
- **[`pick-ui-library/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/pick-ui-library/SKILL.md)** – Decision matrix for selecting UI component libraries based on project constraints.
- **[`prototype/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/prototype/SKILL.md)** – Guidelines for building and switching between multiple UI variants during rapid iteration.

## Installation and Usage

Install the skill pack once per project using the global CLI:

```bash
npx skills@latest add emilkowalski/skills

```

Invoke a specific skill against a target file to receive a structured audit report. For example, running the **review-animations** skill analyzes code against the standards defined in [`STANDARDS.md`](https://github.com/emilkowalski/skills/blob/main/STANDARDS.md) and returns line-level citations:

```bash
npx skills review-animations src/components/Button.jsx

```

**Sample output format:**

| Before | After | Why |
|---|---|---|
| `transition: all 300ms` | `transition: transform 200ms ease-out` | Specify exact properties; `all` animates unintended properties off-GPU ([review-animations/SKILL.md#L46-L48](https://github.com/emilkowalski/skills/blob/main/skills/review-animations/SKILL.md#L46-L48)) |
| `ease-in` on dropdown | `ease-out` + custom curve | `ease-in` delays the moment the user watches most; feels sluggish ([emil-design-eng/SKILL.md#L95-L102](https://github.com/emilkowalski/skills/blob/main/skills/emil-design-eng/SKILL.md#L95-L102)) |

Apply the suggested fixes and re-run the skill until the report yields an **"Approve"** verdict:

```bash
npx skills review-animations src/components/Button.jsx

```

This pattern applies across all skills, including `npx skills improve-animations`, `npx skills find-animation-opportunities`, and `npx skills pick-ui-library`.

## Summary

- The emilkowalski/skills repository treats design engineering knowledge as version-controlled code, storing rules in markdown files that both humans and AI agents can parse.
- **Skills** are located in `skills/*/SKILL.md` files, while **standards** live in [`STANDARDS.md`](https://github.com/emilkowalski/skills/blob/main/STANDARDS.md) to provide concrete values like easing curves and duration tables.
- Installation requires a single CLI command: `npx skills@latest add emilkowalski/skills`.
- The **review-animations** skill enforces ten non-negotiable rules, citing specific line references from [`skills/review-animations/STANDARDS.md`](https://github.com/emilkowalski/skills/blob/main/skills/review-animations/STANDARDS.md) to justify findings.
- This workflow enables continuous UI quality assurance without relying solely on ad-hoc code reviews.

## Frequently Asked Questions

### How do I install the emilkowalski/skills repository in my project?

Run `npx skills@latest add emilkowalski/skills` from your project root. This command pulls the latest skill definitions and makes them available to the local CLI, allowing you to invoke any skill (such as `review-animations` or `improve-animations`) against your source files.

### What is the difference between a skill and a standard in this repository?

A **skill** (e.g., [`skills/review-animations/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/skills/review-animations/SKILL.md)) contains executable logic, prompts, and workflow rules for a specific task. A **standard** (e.g., [`skills/review-animations/STANDARDS.md`](https://github.com/emilkowalski/skills/blob/main/skills/review-animations/STANDARDS.md)) contains the concrete data—easing curves, millisecond durations, spring configurations—that skills reference to ensure consistency across audits.

### Can I use these skills without the CLI?

Yes. The skills are plain markdown files with structured definitions. AI agents, custom scripts, or documentation generators can parse files like [`skills/emil-design-eng/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/skills/emil-design-eng/SKILL.md) directly. However, the CLI automates the invocation pattern and provides the structured report formatting shown in the usage examples.

### Which skill should I use to audit existing animation code?

Use **`review-animations`**. Located at [`skills/review-animations/SKILL.md`](https://github.com/emilkowalski/skills/blob/main/skills/review-animations/SKILL.md), this skill applies ten non-negotiable rules derived from [`STANDARDS.md`](https://github.com/emilkowalski/skills/blob/main/STANDARDS.md) to evaluate your code. It outputs a markdown table of findings with specific line citations and required changes, such as replacing `transition: all` with explicit property transitions.