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

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 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 and 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 acts as the central configuration source. Referenced by multiple skills—particularly 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 – Core philosophy on UI polish, animation decision frameworks, and performance-first CSS patterns.
• review-animations/SKILL.md – Implements ten non-negotiable rules for auditing animation code, referencing line-specific standards to generate findings.
• improve-animations/SKILL.md – Generates prioritized, self-contained plans to upgrade existing animations with concrete mitigation steps.
• 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 – Provides exact terminology for prompting AI-generated animation code, ensuring consistent output quality.
• apple-design/SKILL.md – Distilled Apple design principles adapted for web motion implementation.
• pick-ui-library/SKILL.md – Decision matrix for selecting UI component libraries based on project constraints.
• 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:

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 and returns line-level citations:

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)
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)

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

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 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 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) contains executable logic, prompts, and workflow rules for a specific task. A standard (e.g., 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 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, this skill applies ten non-negotiable rules derived from 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.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}