Design Guide
paperclipai/paperclip
Paperclip UI design system guide for building consistent, reusable frontend components.
A skill your agent uses when the user says: 'design', 'redesign', 'UI', 'UX', 'dashboard', 'page', 'component', 'make it look better', 'polish', 'pretty', 'professional', 'user experience'…
$ npx skills add FerroxLabs/ijfw --skill ijfw-design -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install FerroxLabs/ijfw ijfw-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/FerroxLabs/ijfw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/codex/skills/ijfw-design .claude/skills/ijfw-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 "ijfw-design" agent skill from https://github.com/FerroxLabs/ijfw/tree/main/codex/skills/ijfw-design into .claude/skills/ijfw-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ijfw-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/FerroxLabs/ijfw/tree/main/codex/skills/ijfw-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 FerroxLabs/ijfw --skill ijfw-design -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install FerroxLabs/ijfw ijfw-design --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FerroxLabs/ijfw.git skills-src && mkdir -p .agents/skills && cp -r skills-src/codex/skills/ijfw-design .agents/skills/ijfw-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 "ijfw-design" agent skill from https://github.com/FerroxLabs/ijfw/tree/main/codex/skills/ijfw-design into .agents/skills/ijfw-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ijfw-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 FerroxLabs/ijfw --skill ijfw-design -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install FerroxLabs/ijfw ijfw-design --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FerroxLabs/ijfw.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/codex/skills/ijfw-design .cursor/skills/ijfw-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 "ijfw-design" agent skill from https://github.com/FerroxLabs/ijfw/tree/main/codex/skills/ijfw-design into .cursor/skills/ijfw-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ijfw-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/FerroxLabs/ijfw.git --path codex/skills/ijfw-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 FerroxLabs/ijfw --skill ijfw-design -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install FerroxLabs/ijfw ijfw-design --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FerroxLabs/ijfw.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/codex/skills/ijfw-design .gemini/skills/ijfw-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 "ijfw-design" agent skill from https://github.com/FerroxLabs/ijfw/tree/main/codex/skills/ijfw-design into .gemini/skills/ijfw-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ijfw-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 FerroxLabs/ijfw ijfw-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 FerroxLabs/ijfw --skill ijfw-design -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/FerroxLabs/ijfw.git skills-src && mkdir -p .github/skills && cp -r skills-src/codex/skills/ijfw-design .github/skills/ijfw-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 "ijfw-design" agent skill from https://github.com/FerroxLabs/ijfw/tree/main/codex/skills/ijfw-design into .github/skills/ijfw-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ijfw-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 FerroxLabs/ijfw --skill ijfw-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 FerroxLabs/ijfw ijfw-design --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FerroxLabs/ijfw.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/codex/skills/ijfw-design .opencode/skills/ijfw-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 "ijfw-design" agent skill from https://github.com/FerroxLabs/ijfw/tree/main/codex/skills/ijfw-design into .opencode/skills/ijfw-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ijfw-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.
ijfw-designA skill your agent uses when the user says: 'design', 'redesign', 'UI', 'UX', 'dashboard', 'page', 'component', 'make it look better', 'polish', 'pretty', 'professional', 'user experience'…
Ijfw Design is an agent skill from FerroxLabs/ijfw. Use when the user says: 'design', 'redesign', 'UI', 'UX', 'dashboard', 'page', 'component', 'make it look better', 'polish', 'pretty', 'professional', 'user experience', 'layout', 'visual', 'accessibility', 'colors', 'typography', 'brand'.
Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 34 other files, including scripts (for example `README.md`, `data/brand-atlas.json` and `scripts/design-pass.sh`).
It sits in Frontend & Design, covering UI design, Typography and UX design. The repository describes itself as: IJFW — It Just Fcking Works. Ferrox Labs' local-first infrastructure for AI coding agents: shared memory, smart routing, multi-AI cross-audits, disciplined workflow. The licence is MIT.
4 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit eda62f3. 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.
Ships 3 files in scripts/ (Shell and JavaScript, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
nodeFrom 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.
Ijfw Design loads about 2.2k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 1,140 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); the scripts in this folder are not scanned.
The full file from FerroxLabs/ijfw at commit eda62f3, republished under its MIT licence (© FerroxLabs). 1,140 words, ~2,233 tokens.
.claude/skills/ijfw-design/SKILL.md (or your agent's skills folder). This skill also uses 30 other files; get the full folder from GitHub.When asked to show a design, mockup, layout, screen, or variant, produce REAL HTML and use the live design companion when a shell is available:
ijfw design start (or ijfw design start --no-open in CI/headless sessions). It serves http://localhost:<port>/design..planning/<feature>/mockups/<variant>/index.html or .planning/brainstorm/<option>.html.ijfw design push <file.html>. The open browser reloads automatically.viewer.html that loads option files from /design/files/<name>.html, then push the viewer and its option files together: ijfw design push .planning/brainstorm/*.html.Use the active DESIGN.md or the picked template as the source of truth -- real colors, real type scale, real spacing, real content. Prefer DESIGN.md tokens first, then the chosen template/brand direction, then internal heuristics.
ASCII wireframes in chat are a LAST-RESORT FALLBACK, permitted only when:
Do not default to ASCII boxes. Do not "sketch" in chat. The entire point of this skill is on-brand visual output; ASCII wastes the DESIGN.md contract, the palette, the type scale, and the user's time.
Structural diagrams (Mermaid architecture, data flow, component boundaries) are the exception -- those stay as text by convention.
For UI/design brainstorming, offer the live companion before SHAPE:
This is visual. Want me to open a live preview while we brainstorm?
If declined, continue with durable design notes in DESIGN.md or the current planning artifact and do not start a local server. If accepted, start the companion immediately and push a placeholder or first option so the user sees the loop working. For each design choice, update the HTML and run ijfw design push <file.html>; do not merely say where the file is. For multi-option viewers, push every supporting .html file so iframe tabs can resolve through /design/files/. If the companion cannot start, fall back to opening the HTML file directly and report the path.
The companion is for transient visual feedback: fast previews, option comparison, and live browser reloads. DESIGN.md is durable design memory: tokens, rationale, constraints, critiques, and handoff notes that should survive sessions, platforms, and project phases. Do not treat a pushed preview as the source of truth; persist decisions in DESIGN.md.
Use the durable ijfw design commands whenever the work needs a design contract, not just a preview. These commands are project-agnostic: they can apply to UI, content layout, brand systems, documents, diagrams, presentations, marketing surfaces, product packaging, or other non-code visual artifacts.
ijfw design init -- create or refresh DESIGN.md from detected project context, an existing template, or a chosen brand/style direction.ijfw design plan -- turn the current goal into a visual plan with scope, surfaces, constraints, success criteria, and DESIGN.md updates to make.ijfw design audit -- inspect the current design contract or artifact for consistency, accessibility, hierarchy, brand fit, and missing decisions.ijfw design critique -- challenge the design direction, naming weak assumptions, visual risks, and alternatives before execution.ijfw design polish -- propose refinements that improve visual quality while preserving the existing direction.ijfw design normalize -- reduce drift by aligning colors, typography, spacing, tone, components, or layout patterns back to the contract.ijfw design bolder -- explore a stronger or more distinctive version of the direction while keeping the project constraints visible.ijfw design quieter -- explore a calmer, more restrained version for dense, operational, editorial, or high-trust contexts.ijfw design handoff -- summarize the durable state: selected direction, open questions, accepted/rejected choices, artifact links, and next visual tasks.Prefer this split:
ijfw design start/open/status/stop/push/clear for the live companion loop.ijfw design init/plan/audit/critique/polish/normalize/bolder/quieter/handoff for durable design reasoning and DESIGN.md memory.Check project root for DESIGN.md. If it exists:
MCP-only platforms (OpenCode, Qwen Code, Kimi Code, OpenClaw) access the same picker via ijfw_memory_recall({context_hint: 'design_template[:<name>]'}). Aider reads DESIGN.md once written.
Present exactly three options. Wait for user selection before proceeding. If the user's input doesn't match a valid template name or brand, re-prompt with the numbered list.
package.json name/description/keywords, first paragraph of README.md, or project directory name.data/brand-atlas.json (skill-relative) -- 12 domains x 3-5 brands.aesthetic, palette_hint, and typography_hint fields.DESIGN.md so future sessions skip the picker.List the 12 templates from templates/design/ with a one-line description each (names are the filenames without .md: swiss-minimal, editorial-warm, terminal-native, cinematic-dark, glassmorphic, brutalist-luxe, maximalist-vibrant, neo-swiss-tech, data-dense-dashboard, warm-organic, bento-grid, magazine-editorial).
User picks -> read templates/design/<pick>.md -> use as design contract for this session. If the pick is unknown, show the numbered list again and ask for a valid name.
Offer to write it to project root as DESIGN.md so future sessions skip the picker.
Defer to the downstream specialist's native brainstorm flow. No preloaded template or brand.
Priority order -- best available wins:
enabledPlugins in ~/.claude/settings.json for ui-ux-pro-max@enabledPlugins for frontend-design@claude-plugins-officialenabledPlugins for superpowers@claude-plugins-officialnode scripts/search.js "<query>" --design-system (skill-relative)Force internal: set IJFW_PREFER_INTERNAL=1. If no external skill found, emit:
For richer design output, install ui-ux-pro-max. I'm using internal heuristics now.
Append these invariants to any downstream output IJFW itself generates (components, scripts, config):
templates/design/ include Google Fonts @import by design; that's the user's design contract, not IJFW infrastructureWhen complete, write .ijfw/design-pass.json:
{"ts": "<ISO>", "query": "<goal>", "source": "<external|internal>", "skill": "<name>"}Preflight gate design-pass checks for this sentinel on UI file changes.
Before any UI code is written, emit:
I'll run a design pass first. Say "show me" to open it, or "skip" to continue.
Wait for the user's next turn. One-word show me opens the design pass; skip continues without the visual companion.
© FerroxLabs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 30 other files (scripts) in codex/skills/ijfw-design of FerroxLabs/ijfw.
Open the folder on GitHubat commit eda62f3
Ijfw 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 |
|---|---|---|---|---|---|---|
| Ijfw Design this skillFerroxLabs/ijfw | 212 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Design Guidepaperclipai/paperclip | 99k | 1 repos | ~3.1k | Automated safety check: Pass | MIT | |
| Design GuideLF-Decentralized-Trust-labs/gitmesh | 144 | — | ~3.1k | Automated safety check: Pass | Apache-2.0 | |
| Distinctive Frontend Design Builderirahardianto/awesome-agv | 157 | — | ~2.4k | Automated safety check: Pass | MIT | |
| UI UX Pro MaxInternScience/DrClaw | 172 | — | ~2.9k | Automated safety check: Notes | None | |
| Frontend Blueprinttech-leads-club/agent-skills | 7k | 1 repos | ~5.3k | Automated safety check: Pass | CC-BY-4.0 |
paperclipai/paperclip
Paperclip UI design system guide for building consistent, reusable frontend components.
LF-Decentralized-Trust-labs/gitmesh
GitMesh Agents UI design system. An agent skill from LF-Decentralized-Trust-labs/gitmesh.
irahardianto/awesome-agv
Commits to one bold aesthetic direction, sets up a CSS token system for it, then builds the interface in Vue or plain HTML using those tokens.
InternScience/DrClaw
[Frontend] Frontend UI/UX design intelligence - activate FIRST when user requests beautiful, stunning, gorgeous, or aesthetic interfaces.
tech-leads-club/agent-skills
AI frontend specialist and design consultant that guides users through a structured discovery process before generating any code.
wshobson/agents
Apply typography, color theory, spacing systems, and iconography principles to create cohesive visual designs.
FerroxLabs/ijfw
Maintain canonical AGENTS.md (open spec). An agent skill from FerroxLabs/ijfw.
FerroxLabs/ijfw
A skill your agent uses when a milestone is shipping and you need to archive its artifacts, generate a summary, and seed the next milestone.
FerroxLabs/ijfw
Challenge decisions, surface counter-arguments, flag assumptions.
FerroxLabs/ijfw
Generate a cross-platform multi-model audit (Trident) on a diff, brief, or artifact.
FerroxLabs/ijfw
Root-cause analysis with hypothesis tracking. An agent skill from FerroxLabs/ijfw.
FerroxLabs/ijfw
A skill your agent uses when the user asks for a milestone summary, milestone recap, or to summarize a milestone -- or runs /ijfw-milestone-summary.
Categories
A skill your agent uses when the user says: 'design', 'redesign', 'UI', 'UX', 'dashboard', 'page', 'component', 'make it look better', 'polish', 'pretty', 'professional', 'user experience'…. Ijfw Design is an agent skill from FerroxLabs/ijfw. Use when the user says: 'design', 'redesign', 'UI', 'UX', 'dashboard', 'page', 'component', 'make it look better', 'polish', 'pretty', 'professional', 'user experience', 'layout', 'visual', 'accessibility', 'colors', 'typography', 'brand'.
Ijfw Design fits situations like: the user says: design; make it look better; user experience.
Run `npx skills add FerroxLabs/ijfw --skill ijfw-design -a claude-code`. Or copy the skill folder (codex/skills/ijfw-design in FerroxLabs/ijfw) into .claude/skills/ijfw-design in your project. Claude Code loads it when a task matches its description.
Run `npx skills add FerroxLabs/ijfw --skill ijfw-design -a codex`. Or copy the skill folder (codex/skills/ijfw-design in FerroxLabs/ijfw) into .agents/skills/ijfw-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 FerroxLabs/ijfw --skill ijfw-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/ijfw-design, .gemini/skills/ijfw-design, .github/skills/ijfw-design and .opencode/skills/ijfw-design in your project.
Going by SKILL.md and its folder, Ijfw Design needs a shell and JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js; A Bash shell.
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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Ijfw 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 2.2k tokens (SKILL.md is roughly 8.9k 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 Ijfw Design: Design Guide (paperclipai/paperclip, 99k stars), Design Guide (LF-Decentralized-Trust-labs/gitmesh, 144 stars), Distinctive Frontend Design Builder (irahardianto/awesome-agv, 157 stars) and UI UX Pro Max (InternScience/DrClaw, 172 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
FerroxLabs (a GitHub user) maintains it in FerroxLabs/ijfw, which has 212 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on October 5, 2026.
Source: FerroxLabs/ijfw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.