Make Interfaces Feel Better
samuelclay/NewsBlur
Design engineering principles for making interfaces feel polished.
Compozy visual-design authority for production UI, static artifacts, prototypes, and reviews.
$ npx skills add compozy/compozy --skill eng-design -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install compozy/compozy eng-design --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/compozy/compozy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/eng/eng-design .claude/skills/eng-design && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "eng-design" agent skill from https://github.com/compozy/compozy/tree/main/.agents/skills/eng/eng-design into .claude/skills/eng-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "eng-design", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/compozy/compozy/tree/main/.agents/skills/eng/eng-designType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add compozy/compozy --skill eng-design -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install compozy/compozy eng-design --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/compozy/compozy.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/eng/eng-design .agents/skills/eng-design && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "eng-design" agent skill from https://github.com/compozy/compozy/tree/main/.agents/skills/eng/eng-design into .agents/skills/eng-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "eng-design", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add compozy/compozy --skill eng-design -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install compozy/compozy eng-design --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/compozy/compozy.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/eng/eng-design .cursor/skills/eng-design && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "eng-design" agent skill from https://github.com/compozy/compozy/tree/main/.agents/skills/eng/eng-design into .cursor/skills/eng-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "eng-design", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/compozy/compozy.git --path .agents/skills/eng/eng-design--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add compozy/compozy --skill eng-design -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install compozy/compozy eng-design --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/compozy/compozy.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/eng/eng-design .gemini/skills/eng-design && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "eng-design" agent skill from https://github.com/compozy/compozy/tree/main/.agents/skills/eng/eng-design into .gemini/skills/eng-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "eng-design", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install compozy/compozy eng-designInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add compozy/compozy --skill eng-design -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/compozy/compozy.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/eng/eng-design .github/skills/eng-design && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "eng-design" agent skill from https://github.com/compozy/compozy/tree/main/.agents/skills/eng/eng-design into .github/skills/eng-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "eng-design", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add compozy/compozy --skill eng-design -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install compozy/compozy eng-design --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/compozy/compozy.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/eng/eng-design .opencode/skills/eng-design && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "eng-design" agent skill from https://github.com/compozy/compozy/tree/main/.agents/skills/eng/eng-design into .opencode/skills/eng-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "eng-design", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
eng-designCompozy visual-design authority for production UI, static artifacts, prototypes, and reviews.
Eng Design is an agent skill from compozy/compozy. Compozy visual-design authority for production UI, static artifacts, prototypes, and reviews. Use when creating or reviewing a Compozy surface or changing tokens, typography, spacing, depth, icons, or motion. Do not use for capture-only verification; use eng-ui-screenshot.
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Frontend & Design, covering Typography and UI design. The repository describes itself as: An operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each… The licence is MIT.
6 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit eec2ed1. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
makeFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Eng Design loads about 1.5k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 743 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from compozy/compozy at commit eec2ed1, republished under its MIT licence (© compozy). 743 words, ~1,488 tokens.
.claude/skills/eng-design/SKILL.md (or your agent's skills folder).Use the applicable canonical visual authorities for the design decision. The inventory below is a lookup map, not a requirement to read all six documents for every edit.
packages/ui/src/tokens.css: canonical token source consumed by Tailwind v4.DESIGN.md: rationale, generated token tables, anti-patterns, and semantic component contracts.packages/ui/src/index.ts: the @compozy/ui surface contract — the canonical primitive inventory.packages/ui/src/components/**/*.tsx: canonical production recipes.COPY.md: product voice, terms, and public claim rules.PRODUCT.md: audience, register, design principles, and anti-references.--color-accent target per viewport.--shadow-overlay for overlays and --shadow-highlight for active rims.--color-*, --text-*, --radius-*, --duration-*, and --shadow-* tokens; do not hardcode production hex or one-off sizes.<Eyebrow> is the only structural label contract — sentence case by default, uppercase only via variant="caps"; do not inline typography tuples for labels.DESIGN.md section 10 for the anti-pattern list and lint/test guardrails.When a task or spec names an OpenDesign artifact, mock, screenshot, or other
trusted visual reference, activate eng-ui-screenshot before implementation
and follow its Visual Contract Mode. Implement from the rendered reference,
not source inspection alone; an implementation-only screenshot never proves
parity. The reference is normative for visual language — layout, on-screen
anatomy, typography, tokens, motion — and lossy for everything else: content,
data, copy, brand marks, which controls exist, component identity, and any
host chrome it redraws around the named piece stay with runtime truth,
COPY.md, the brand inventory, the reuse gate below, and the live surface,
recorded as authorized differences. Before code, map every in-scope region to
a shipped @compozy/ui primitive or existing domain composite and integrate
the named piece into the live host surface; prototype markup is a stand-in,
never an implementation spec. This scope outranks stricter reproduction
doctrine in any other active skill (impeccable's comp reproduction
included).
Inline or import actual values from packages/ui/src/tokens.css. Mirror the class
structure and component anatomy in packages/ui/src/components where possible.
Keep artifacts dark, flat, calm, and functional. Use literal CSS only to represent
exported token values; do not invent a parallel palette.
Reuse gate — before authoring any component, map every generic UI need against
packages/ui/src/index.ts and import the primitive from @compozy/ui instead of
re-implementing it. Redefining an exported name in web/ or packages/site/
fails lint (compozy-ui-reuse/no-shadow-ui-primitive); genuinely
domain-specific variants take a domain-prefixed name. New generic primitives
land in packages/ui with story + test; domain composites in
web/src/systems/<domain>/.
Edit the owning surface: web/, packages/ui/, or packages/site/. Consume
CSS variables and bare Tailwind v4 token utilities. If tokens.css or
packages/site/app/global.css changes, run make codegen and then
make codegen-check so DESIGN.md stays synchronized.
The change is complete when it uses the canonical tokens and primitive owner, introduces no parallel palette or shadow primitive, respects the owning surface's instructions, regenerated design artifacts have no drift when a token source changed, and every named visual contract has a passing evidence bundle with zero unresolved blocking divergence.
DESIGN.md and runtime tokens disagree: treat packages/ui/src/tokens.css as source, run codegen, and inspect the regenerated spec rather than editing generated regions.packages/ui and domain composites to the owning Web system.@compozy/ui brand primitive or delete product content to match a mock.@compozy/ui/domain component inside the live host surface, keep the reference's read through its variants and tokens, and record the delta as authorized — never fork the component or rebuild the host to match prototype markup.© compozy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .agents/skills/eng/eng-design of compozy/compozy.
Open the folder on GitHubat commit eec2ed1
Eng Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Eng Design this skillcompozy/compozy | 2.8k | — | ~1.5k | Automated safety check: Pass | MIT | |
| Make Interfaces Feel Bettersamuelclay/NewsBlur | 7.6k | 10 repos | ~1.5k | Automated safety check: Pass | MIT | |
| UI UX Pro Maxsaoudi-h/solar-icons | 184 | 18 repos | ~11k | Automated safety check: Notes | Custom licence | |
| Baseline UIibelick/ui-skills | 9.5k | 8 repos | ~855 | Automated safety check: Pass | MIT | |
| Frontend Designanthropics/skills | 180k | 38 repos | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| Design Guidepaperclipai/paperclip | 99k | 1 repos | ~3.1k | Automated safety check: Pass | MIT |
samuelclay/NewsBlur
Design engineering principles for making interfaces feel polished.
saoudi-h/solar-icons
UI/UX design intelligence for web and mobile. An agent skill from saoudi-h/solar-icons.
ibelick/ui-skills
Applies a fixed set of UI rules for stack, components, interaction, animation, typography and layout, or reviews a file against them with concrete fixes.
anthropics/skills
Pushes the agent toward distinctive visual design for new or reworked UI: a clear aesthetic direction, deliberate typography and choices rooted in the subject.
paperclipai/paperclip
Paperclip UI design system guide for building consistent, reusable frontend components.
Galaxy-Dawn/claude-scholar
Turns a vague UI request into a concrete design system with style, palette, typography and layout guidance from a search script, plus stack-specific implementation advice.
compozy/compozy
Dogfoods Compozy through an autonomous startup scenario with live providers, cross-surface observation, and strict evidence audit.
compozy/compozy
Go test-shape discipline for Compozy. An agent skill from compozy/compozy.
compozy/compozy
Guide for assistant-ui library - AI chat UI components. An agent skill from compozy/compozy.
compozy/compozy
Guide for assistant-ui UI primitives - ThreadPrimitive, ComposerPrimitive, MessagePrimitive.
compozy/compozy
Guide for assistant-ui runtime system and state management. An agent skill from compozy/compozy.
compozy/compozy
Guide for assistant-stream package and streaming protocols. An agent skill from compozy/compozy.
Categories
Compozy visual-design authority for production UI, static artifacts, prototypes, and reviews. Eng Design is an agent skill from compozy/compozy. Compozy visual-design authority for production UI, static artifacts, prototypes, and reviews.
Eng Design fits situations like: reviewing a Compozy surface; changing tokens; capture-only verification; use eng-ui-screenshot.
Run `npx skills add compozy/compozy --skill eng-design -a claude-code`. Or copy the skill folder (.agents/skills/eng/eng-design in compozy/compozy) into .claude/skills/eng-design in your project. Claude Code loads it when a task matches its description.
Run `npx skills add compozy/compozy --skill eng-design -a codex`. Or copy the skill folder (.agents/skills/eng/eng-design in compozy/compozy) into .agents/skills/eng-design in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add compozy/compozy --skill eng-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/eng-design, .gemini/skills/eng-design, .github/skills/eng-design and .opencode/skills/eng-design in your project.
Going by SKILL.md and its folder, Eng Design needs the command-line tools its instructions call (make).
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Eng Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Eng Design: Make Interfaces Feel Better (samuelclay/NewsBlur, 7.6k stars), UI UX Pro Max (saoudi-h/solar-icons, 184 stars), Baseline UI (ibelick/ui-skills, 9.5k stars) and Frontend Design (anthropics/skills, 180k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
compozy (a GitHub organization) maintains it in compozy/compozy, which has 2,792 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 8, 2026.
Source: compozy/compozy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.