Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/touchine-ojo--ojo-design-skills/badge.svg)](/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

i

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.

  1. <div align="center">
  2. # OJO Design Skills
  3. **Reusable UI/UX design skills for AI coding agents — Codex, Claude Code, ZCode, and more.**
  4. [![License: MIT](https://img.shields.io/github/license/touchine-ojo/OJO-Design-Skills?color=blue)](./LICENSE)
  5. [![GitHub stars](https://img.shields.io/github/stars/touchine-ojo/OJO-Design-Skills?style=flat&color=yellow)](https://github.com/touchine-ojo/OJO-Design-Skills/stargazers)
  6. [![Last commit](https://img.shields.io/github/last-commit/touchine-ojo/OJO-Design-Skills?color=brightgreen)](https://github.com/touchine-ojo/OJO-Design-Skills/commits/main)
  7. [![Clients](https://img.shields.io/badge/clients-7-success)](#quick-start)
  8. [![Skills](https://img.shields.io/badge/skills-2-orange)](#skills)
  9. **English** · [简体中文](./docs/README.zh-CN.md) · [日本語](./docs/README.ja-JP.md) · [한국어](./docs/README.ko-KR.md) · [Español](./docs/README.es-ES.md)
  10. </div>
  11. ---
  12. 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.
  13. It is agent-agnostic and ships with a single installer that targets every major client.
  14. ---
  15. ## Features
  16. - **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.
  17. - **Anti-AI-slop guardrails.** Hard-banned combinations (purple-blue gradients, gray-box placeholders, single-hue palettes) are enforced as rules, not suggestions.
  18. - **Real-imagery requirement.** Any screen that shows imagery must use real, subject-specific assets — no decorative placeholders, fake stock smiles, or gradient blobs.
  19. - **Code-grade output.** Components resolve to atomic Tailwind class strings with an 8-state interaction model; motion uses spring physics, not fixed curves.
  20. ## Showcase
  21. The same brief, with and without these skills installed.
  22. <table>
  23. <tr>
  24. <th>With OJO Skills</th>
  25. <th>Without OJO Skills</th>
  26. </tr>
  27. <tr>
  28. <td align="center"><img src="./docs/images/showcase-1-with.gif" alt="Coffee app home with OJO Skills" width="360"></td>
  29. <td align="center"><img src="./docs/images/showcase-1-without.gif" alt="Coffee app home without OJO Skills" width="360"></td>
  30. </tr>
  31. <tr>
  32. <td colspan="2" align="center"><img src="./docs/images/showcase-2-riot.gif" alt="Rock festival landing page with OJO Skills" width="720"></td>
  33. </tr>
  34. </table>
  35. ## Design samples
  36. Additional output produced with these skills installed — one product, multiple surfaces.
  37. <p align="center"><img src="./docs/images/showcase-design.png" alt="Landing page full section"></p>
  38. <p align="center"><img src="./docs/images/showcase-design-3.png" alt="Feature section"></p>
  39. <p align="center"><img src="./docs/images/showcase-design-4.png" alt="Feature section"></p>
  40. <p align="center"><img src="./docs/images/showcase-design-2.png" alt="Analytics dashboard"></p>
  41. ## Quick start
  42. Install all skills with one command — replace `<client>` with your agent:
  43. ```bash
  44. curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target <client>
  45. ```
  46. The remote installer requires Bash, `curl`, and `tar`.
  47. | Client | `--target` | Default install directory |
  48. | --- | --- | --- |
  49. | Codex | `codex` | `${CODEX_HOME:-~/.codex}/skills` |
  50. | Claude Code | `claude-code` | `${CLAUDE_HOME:-~/.claude}/skills` |
  51. | ZCode | `zcode` | `${AGENTS_HOME:-~/.agents}/skills` |
  52. | DeepCode | `deepcode` | `${AGENTS_HOME:-~/.agents}/skills` |
  53. | WorkBuddy | `workbuddy` | `${WORKBUDDY_HOME:-~/.workbuddy}/skills` |
  54. | OpenCode | `opencode` | `${OPENCODE_CONFIG_DIR:-~/.config/opencode}/skills` |
  55. | Generic agent | `generic` | `${AGENTS_HOME:-~/.agents}/skills` |
  56. Restart or reload the client if it does not pick up the new skills.
  57. <details>
  58. <summary>Advanced install options</summary>
  59. Replace existing copies without backups:
  60. ```bash
  61. curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target codex --force
  62. ```
  63. Install to a custom client home:
  64. ```bash
  65. 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
  66. ```
  67. Install to an explicit directory:
  68. ```bash
  69. curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target opencode --dest /path/to/skills
  70. ```
  71. Install from a local checkout (useful for development):
  72. ```bash
  73. ./scripts/install.sh
  74. ```
  75. Install from a different local checkout:
  76. ```bash
  77. ./scripts/install.sh --source /path/to/OJO-Design-Skills --target codex
  78. ```
  79. Install a pinned tag or commit for a reproducible remote install:
  80. ```bash
  81. curl -fsSL https://raw.githubusercontent.com/touchine-ojo/OJO-Design-Skills/main/scripts/install.sh | bash -s -- --target codex --ref <tag-or-commit>
  82. ```
  83. Preview what would be written without changing files:
  84. ```bash
  85. ./scripts/install.sh --target opencode --dry-run
  86. ```
  87. Install a single skill (`--skill` can be repeated):
  88. ```bash
  89. ./scripts/install.sh --target zcode --skill app-ui-ux-best-practices
  90. ```
  91. </details>
  92. ## Skills
  93. ### `app-ui-ux-best-practices`
  94. The core methodology. Picks a track based on the product's value proposition, then produces complete design specifications.
  95. - **Convention Track** — adopt one proven design language (Notion, Linear, Stripe, Things 3, …) for SaaS and utility products.
  96. - **Innovation Track** — build a brand-driven identity via Material Metaphor, archetype, narrative, or cultural-semiotic methods.
  97. - Ships with **9 reference files**: anti-patterns, visual tokens, component recipes, motion system, material metaphor, design audit, and more.
  98. ### `pixel-paper-editorial`
  99. 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.
  100. - Preserves the pixel style while adapting sticker subjects, accent colors, and layout to the current theme.
  101. - Includes web implementation rules, general-purpose collage guidance, and visual reference analysis.
  102. - Supports runnable websites and explicitly requested concept-image previews.
  103. Example: `Use $pixel-paper-editorial to create a photography portfolio with a white dotted background and original pixel stickers. Keep the layout simple.`
  104. ## How it works
  105. ```
  106. Product brief
  107. │
  108. ├─ Convention Track ──► pick proven system ──► tokens ──► components ──► specs
  109. │ (SaaS / utility) (Notion, Linear…)
  110. │
  111. └─ Innovation Track ──► insight + feeling ──► methodology ──► tokens ──► specs
  112. (brand-driven) (Material Metaphor / archetype / narrative)
  113. ```
  114. 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").
  115. ## Contributing
  116. 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:
  117. ```bash
  118. ./scripts/install.sh --dry-run
  119. ```
  120. 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).
  121. ## License
  122. [MIT](./LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.