OJO-Design-Skills
Reusable UI/UX design skills for AI coding agents — Codex, Claude Code, ZCode, and more.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/touchine-ojo--ojo-design-skills)HTML
<a href="/listings/touchine-ojo--ojo-design-skills"><img src="/api/listings/touchine-ojo--ojo-design-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
Install all skills with one command — replace `<client>` with your agent:
curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target <client>
The remote installer requires Bash, `curl`, and `tar`.
| Client | `--target` | Default install directory | | --- | --- | --- | | Codex | `codex` | `${CODEX_HOME:-~/.codex}/skills` | | Claude Code | `claude-code` | `${CLAUDE_HOME:-~/.claude}/skills` | | ZCode | `zcode` | `${AGENTS_HOME:-~/.agents}/skills` | | DeepCode | `deepcode` | `${AGENTS_HOME:-~/.agents}/skills` | | WorkBuddy | `workbuddy` | `${WORKBUDDY_HOME:-~/.workbuddy}/skills` | | OpenCode | `opencode` | `${OPENCODE_CONFIG_DIR:-~/.config/opencode}/skills` | | Generic agent | `generic` | `${AGENTS_HOME:-~/.agents}/skills` |
Restart or reload the client if it does not pick up the new skills.
<details> <summary>Advanced install options</summary>
Replace existing copies without backups:
curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target codex --force
Install to a custom client home:
curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | CLAUDE_HOME=/path/to/.claude bash -s -- --target claude-code
Install to an explicit directory:
curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target opencode --dest /path/to/skills
Install from a local checkout (useful for development):
./scripts/install.sh
Install from a different local checkout:
./scripts/install.sh --source /path/to/OJO-Design-Skills --target codex
Install a pinned tag or commit for a reproducible remote install:
curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target codex --ref <tag-or-commit>
Preview what would be written without changing files:
./scripts/install.sh --target opencode --dry-run
Install a single skill (`--skill` can be repeated):
./scripts/install.sh --target zcode --skill app-ui-ux-best-practices
</details>
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 180 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- # OJO Design Skills
- **Reusable UI/UX design skills for AI coding agents — Codex, Claude Code, ZCode, and more.**
- [](./LICENSE)
- [](https://github.com/touchine-ojo/OJO-Design-Skills/stargazers)
- [](https://github.com/touchine-ojo/OJO-Design-Skills/commits/main)
- [](#quick-start)
- [](#skills)
- **English** · [简体中文](./docs/README.zh-CN.md) · [日本語](./docs/README.ja-JP.md) · [한국어](./docs/README.ko-KR.md) · [Español](./docs/README.es-ES.md)
- </div>
- ---
- OJO Design Skills is a drop-in skill bundle that teaches your AI coding agent how to make real design decisions — not generic "AI-looking" layouts. Install once, and your agent gains a complete UI/UX methodology: brand-driven visual direction, design tokens, component recipes, motion specs, and a strict anti-pattern guardrail that keeps output from looking like slop.
- It is agent-agnostic and ships with a single installer that targets every major client.
- ---
- ## Features
- - **Two-track methodology.** *Convention Track* adopts a proven design language for SaaS and utility products; *Innovation Track* builds brand-driven identity via Material Metaphor, archetype, narrative, or cultural-semiotic approaches.
- - **Anti-AI-slop guardrails.** Hard-banned combinations (purple-blue gradients, gray-box placeholders, single-hue palettes) are enforced as rules, not suggestions.
- - **Real-imagery requirement.** Any screen that shows imagery must use real, subject-specific assets — no decorative placeholders, fake stock smiles, or gradient blobs.
- - **Code-grade output.** Components resolve to atomic Tailwind class strings with an 8-state interaction model; motion uses spring physics, not fixed curves.
- ## Showcase
- The same brief, with and without these skills installed.
- <table>
- <tr>
- <th>With OJO Skills</th>
- <th>Without OJO Skills</th>
- </tr>
- <tr>
- <td align="center"><img src="./docs/images/showcase-1-with.gif" alt="Coffee app home with OJO Skills" width="360"></td>
- <td align="center"><img src="./docs/images/showcase-1-without.gif" alt="Coffee app home without OJO Skills" width="360"></td>
- </tr>
- <tr>
- <td colspan="2" align="center"><img src="./docs/images/showcase-2-riot.gif" alt="Rock festival landing page with OJO Skills" width="720"></td>
- </tr>
- </table>
- ## Design samples
- Additional output produced with these skills installed — one product, multiple surfaces.
- <p align="center"><img src="./docs/images/showcase-design.png" alt="Landing page full section"></p>
- <p align="center"><img src="./docs/images/showcase-design-3.png" alt="Feature section"></p>
- <p align="center"><img src="./docs/images/showcase-design-4.png" alt="Feature section"></p>
- <p align="center"><img src="./docs/images/showcase-design-2.png" alt="Analytics dashboard"></p>
- ## Quick start
- Install all skills with one command — replace `<client>` with your agent:
- ```bash
- curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target <client>
- ```
- The remote installer requires Bash, `curl`, and `tar`.
- | Client | `--target` | Default install directory |
- | --- | --- | --- |
- | Codex | `codex` | `${CODEX_HOME:-~/.codex}/skills` |
- | Claude Code | `claude-code` | `${CLAUDE_HOME:-~/.claude}/skills` |
- | ZCode | `zcode` | `${AGENTS_HOME:-~/.agents}/skills` |
- | DeepCode | `deepcode` | `${AGENTS_HOME:-~/.agents}/skills` |
- | WorkBuddy | `workbuddy` | `${WORKBUDDY_HOME:-~/.workbuddy}/skills` |
- | OpenCode | `opencode` | `${OPENCODE_CONFIG_DIR:-~/.config/opencode}/skills` |
- | Generic agent | `generic` | `${AGENTS_HOME:-~/.agents}/skills` |
- Restart or reload the client if it does not pick up the new skills.
- <details>
- <summary>Advanced install options</summary>
- Replace existing copies without backups:
- ```bash
- curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target codex --force
- ```
- Install to a custom client home:
- ```bash
- curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | CLAUDE_HOME=/path/to/.claude bash -s -- --target claude-code
- ```
- Install to an explicit directory:
- ```bash
- curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target opencode --dest /path/to/skills
- ```
- Install from a local checkout (useful for development):
- ```bash
- ./scripts/install.sh
- ```
- Install from a different local checkout:
- ```bash
- ./scripts/install.sh --source /path/to/OJO-Design-Skills --target codex
- ```
- Install a pinned tag or commit for a reproducible remote install:
- ```bash
- curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target codex --ref <tag-or-commit>
- ```
- Preview what would be written without changing files:
- ```bash
- ./scripts/install.sh --target opencode --dry-run
- ```
- Install a single skill (`--skill` can be repeated):
- ```bash
- ./scripts/install.sh --target zcode --skill app-ui-ux-best-practices
- ```
- </details>
- ## Skills
- ### `app-ui-ux-best-practices`
- The core methodology. Picks a track based on the product's value proposition, then produces complete design specifications.
- - **Convention Track** — adopt one proven design language (Notion, Linear, Stripe, Things 3, …) for SaaS and utility products.
- - **Innovation Track** — build a brand-driven identity via Material Metaphor, archetype, narrative, or cultural-semiotic methods.
- - Ships with **9 reference files**: anti-patterns, visual tokens, component recipes, motion system, material metaphor, design audit, and more.
- ### `pixel-paper-editorial`
- Create responsive websites with a white dotted background, original pixel art stickers, and retro pixel UI. Optional cutout collage heroes add oversized type, torn-paper seams, selection highlights, and pill calls to action while keeping the layout simple.
- - Preserves the pixel style while adapting sticker subjects, accent colors, and layout to the current theme.
- - Includes web implementation rules, general-purpose collage guidance, and visual reference analysis.
- - Supports runnable websites and explicitly requested concept-image previews.
- Example: `Use $pixel-paper-editorial to create a photography portfolio with a white dotted background and original pixel stickers. Keep the layout simple.`
- ## How it works
- ```
- Product brief
- │
- ├─ Convention Track ──► pick proven system ──► tokens ──► components ──► specs
- │ (SaaS / utility) (Notion, Linear…)
- │
- └─ Innovation Track ──► insight + feeling ──► methodology ──► tokens ──► specs
- (brand-driven) (Material Metaphor / archetype / narrative)
- ```
- Both tracks require a mandatory style-direction confirmation gate before producing tokens — the agent presents 2–3 genuinely distinct directions and waits for selection. Once installed, skills are activated automatically when the agent detects design-related intent (e.g. "design system", "视觉设计", "design tokens").
- ## Contributing
- Skills are plain Markdown files under `skills/<name>/SKILL.md` plus optional `references/` files. To add or refine a skill, read the [contributing guide](./CONTRIBUTING.md), edit the relevant files, and run the installer locally to verify:
- ```bash
- ./scripts/install.sh --dry-run
- ```
- Use [GitHub Discussions](https://github.com/touchine-ojo/OJO-Design-Skills/discussions) for questions and early ideas, and [Issues](https://github.com/touchine-ojo/OJO-Design-Skills/issues) for reproducible bugs or focused feature requests. Security concerns should follow the private process in [SECURITY.md](./SECURITY.md).
- ## License
- [MIT](./LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.