Skip to content
Back to search

flawless-ui-ux

A UI/UX skill for coding agents to build distinctive, usable interfaces.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/smokeeaasd/flawless-ui-ux with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/smokeeaasd/flawless-ui-ux'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/smokeeaasd--flawless-ui-ux/badge.svg)](/listings/smokeeaasd--flawless-ui-ux)

HTML

<a href="/listings/smokeeaasd--flawless-ui-ux"><img src="/api/listings/smokeeaasd--flawless-ui-ux/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.

From your project directory, choose your package manager to install the skill for **all supported agents in that project**. The CLI requires **Node 22.12+**; no checkout or Bash is needed.

npx flawless-ui-ux@latest install
pnpm dlx flawless-ui-ux@latest install
bunx flawless-ui-ux@latest install

Run one of these commands. The examples below use `npx`; replace it with `pnpm dlx` or `bunx` to use the same operations.

Choose an agent and scope

For a specific agent, or an installation across projects:

npx flawless-ui-ux install --codex
npx flawless-ui-ux install --claude-code
npx flawless-ui-ux install --pi --global

The default is all supported agents in the current project, also selected with `--all-agents`. Choose one agent with its flag:

| Agent | Flag | |---|---| | Codex | `--codex` | | OpenCode | `--opencode` | | Antigravity | `--antigravity` | | Kiro | `--kiro` | | [Cursor](https://cursor.com/help/customization/skills) | `--cursor` | | [Kilo Code](https://kilo.ai/docs/customize/skills) | `--kilo` | | [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills) | `--copilot` | | [Claude Code](https://code.claude.com/docs/en/skills) | `--claude-code` | | [Pi](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/skills.md) | `--pi` | | [Grok Build](https://docs.x.ai/build/features/skills-plugins-marketplaces) | `--grok-build` | | [Devin CLI](https://docs.devin.ai/cli/extensibility/skills/overview) | `--devin` | | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/subsystems/skills.md) | `--deepseek-harness` |

`--global` explicitly installs in your user profile; `--project <directory>` selects another project. Start a new agent session if needed for discovery.

Codex, Antigravity, Cursor, Kilo, Copilot, Pi, Devin, and DeepSeek Harness share `.agents/skills/flawless-ui-ux` in a project; the installer copies it once. An existing copy there is already available to those agents. OpenCode uses `.opencode/skills`, Kiro uses `.kiro/skills`, Claude Code uses `.claude/skills`, and Grok Build uses `.grok/skills`, each containing the same `flawless-ui-ux` bundle.

Existing installations are never overwritten, including links and local changes. All selected destinations are checked before copying. Review or remove an existing installation yourself before reinstalling. Global paths honor the host's configuration directory, including `GROK_HOME`, `DSH_HOME`, and Devin's `%APPDATA%` on Windows or `XDG_CONFIG_HOME` elsewhere. The [CLI contract](docs/cli-contract.md#install) lists all destinations and overrides.

Grok Build requires project-folder trust before it exposes project skills. DeepSeek Harness resolves project skills from the nearest Git root; install from that root, or from the working directory for a project without Git. Installation does not change host trust, permissions, or custom discovery settings.

<details> <summary>Alternative: install from a checkout with Bash</summary>

bash ./install.sh --codex --project
bash ./install.sh --claude-code --project
bash ./install.sh --pi --project

Run these from the target project's directory, using the script's absolute path when the checkout is elsewhere. Use `--all-agents` for all supported agents. The legacy Bash script requires `--project` for local installation and otherwise installs globally. On Windows, this alternative requires Git Bash or WSL.

</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 · 308 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. <p align="center">
  2. <img src="docs/assets/banner.svg" alt="flawless-ui-ux — UI/UX design guidance for coding agents." width="100%">
  3. </p>
  4. <p align="center">
  5. Build and refine interfaces around your product's audience, content, and identity.
  6. </p>
  7. <p align="center">
  8. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/codex.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/codex.png" width="28" height="28" alt="Codex" title="Codex"></picture>
  9. &nbsp;
  10. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/opencode.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/opencode.png" width="28" height="28" alt="OpenCode" title="OpenCode"></picture>
  11. &nbsp;
  12. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/antigravity-color.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/antigravity-color.png" width="28" height="28" alt="Antigravity" title="Antigravity"></picture>
  13. &nbsp;
  14. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/kiro-color.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/kiro-color.png" width="28" height="28" alt="Kiro" title="Kiro"></picture>
  15. &nbsp;
  16. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/cursor.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/cursor.png" width="28" height="28" alt="Cursor" title="Cursor"></picture>
  17. &nbsp;
  18. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/kilocode.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/kilocode.png" width="28" height="28" alt="Kilo Code" title="Kilo Code"></picture>
  19. &nbsp;
  20. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/githubcopilot.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/githubcopilot.png" width="28" height="28" alt="GitHub Copilot CLI" title="GitHub Copilot CLI"></picture>
  21. &nbsp;
  22. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/claudecode-color.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/claudecode-color.png" width="28" height="28" alt="Claude Code" title="Claude Code"></picture>
  23. &nbsp;
  24. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/pi.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/pi.png" width="28" height="28" alt="Pi" title="Pi"></picture>
  25. &nbsp;
  26. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/grok.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/grok.png" width="28" height="28" alt="Grok Build" title="Grok Build"></picture>
  27. &nbsp;
  28. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/devin-color.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/devin-color.png" width="28" height="28" alt="Devin CLI" title="Devin CLI"></picture>
  29. &nbsp;
  30. <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/dark/deepseek-color.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/ea434b96e75813517b377825e01c0df61dee8836/packages/static-png/light/deepseek-color.png" width="28" height="28" alt="DeepSeek Harness" title="DeepSeek Harness"></picture>
  31. </p>
  32. <p align="center">
  33. <a href="https://skills.sh/smokeeaasd/flawless-ui-ux/flawless-ui-ux"><img src="https://img.shields.io/badge/skills.sh-install-0ce491?style=flat&amp;labelColor=171717" alt="Find flawless-ui-ux on skills.sh"></a>
  34. <a href="https://www.npmjs.com/package/flawless-ui-ux"><img src="https://img.shields.io/npm/v/flawless-ui-ux?style=flat&amp;color=0ce491&amp;labelColor=171717" alt="Latest published npm version"></a>
  35. <a href="https://www.npmjs.com/package/flawless-ui-ux"><img src="https://img.shields.io/npm/dm/flawless-ui-ux?style=flat&amp;label=CLI%20downloads%2Fmonth&amp;color=0ce491&amp;labelColor=171717" alt="CLI downloads per month on npm"></a>
  36. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-0ce491?style=flat&amp;labelColor=171717" alt="MIT license"></a>
  37. </p>
  38. <p align="center">
  39. <a href="#what-is-flawless-ui-ux">About</a> ·
  40. <a href="#without-skill-vs-with-skill">Comparison</a> ·
  41. <a href="#install">Install</a> ·
  42. <a href="#update-and-diagnose-installations">Update</a> ·
  43. <a href="#use-the-skill">Use the skill</a> ·
  44. <a href="#how-it-works">How it works</a> ·
  45. <a href="#inspect-and-verify">Inspect and verify</a> ·
  46. <a href="#documentation">Docs</a>
  47. </p>
  48. ## What is flawless-ui-ux?
  49. flawless-ui-ux is a UI/UX design skill and a local inspection CLI for coding agents. It helps agents create, redesign, refine, and review interfaces around a product's audience, content, and identity.
  50. The skill guides layout, typography, color, and interaction decisions for web, native mobile, and desktop interfaces. The CLI inspects selected source files and browser interfaces, providing observations the agent can use to find issues and verify corrections. You describe the task; your coding agent applies the guidance in your existing project.
  51. ## Without skill vs. with skill
  52. <table>
  53. <tr>
  54. <th width="50%">Without skill</th>
  55. <th width="50%">With skill</th>
  56. </tr>
  57. <tr>
  58. <td><img src="docs/assets/fintech-without-skill.png" alt="Initial fintech dashboard created without the skill"></td>
  59. <td><img src="docs/assets/fintech-with-skill.png" alt="The same fintech dashboard refined with flawless-ui-ux"></td>
  60. </tr>
  61. </table>
  62. Created in Codex with GPT 6.1 Sol (low), then refined with flawless-ui-ux using the same model and reasoning setting.
  63. ## Install
  64. From your project directory, run one command with your preferred package manager:
  65. ```bash
  66. # npm
  67. npx flawless-ui-ux@latest install
  68. # pnpm
  69. pnpm dlx flawless-ui-ux@latest install
  70. # Bun
  71. bunx flawless-ui-ux@latest install
  72. ```
  73. Requires **Node 22.12+**. In a terminal, choose **project or global scope**, select **one or more agents**, and **confirm the destinations** before copying. Use Space to select and Enter to continue. Ctrl+C cancels before installation files are written.
  74. Explicit flags run directly:
  75. ```bash
  76. npx flawless-ui-ux install --codex
  77. npx flawless-ui-ux install --codex --devin
  78. npx flawless-ui-ux install --claude-code --global
  79. npx flawless-ui-ux install --project ./app
  80. npx flawless-ui-ux install --yes
  81. ```
  82. `--yes` skips the menu and uses the defaults when no other flags are supplied: all supported agents in the current project. JSON output, CI, and non-terminal execution remain noninteractive. Use `--format json` for machine-readable output.
  83. <details>
  84. <summary>Install the skill through skills.sh</summary>
  85. ```bash
  86. npx skills add smokeeaasd/flawless-ui-ux --skill flawless-ui-ux
  87. ```
  88. This installs the skill through the [Skills CLI](https://github.com/vercel-labs/skills). Its runtime requirements and agent selection follow that installer. The inspection CLI is available separately through the npm commands in this guide.
  89. </details>
  90. <details>
  91. <summary>Install from a checkout with Bash</summary>
  92. ```bash
  93. bash /absolute/path/flawless-ui-ux/install.sh --codex --project
  94. ```
  95. The alternative supports Bash 3.2 and newer. It requires `--project` for local installation; its default is global. Windows users need Git Bash or WSL. It copies the skill only; the npm package supplies the CLI commands.
  96. </details>
  97. ## Update and diagnose installations
  98. Updating the npm package does not replace skill copies already installed for your agents. Preview changes, then update those copies from the running package:
  99. ```
  100. npx flawless-ui-ux@latest update --codex --dry-run
  101. npx flawless-ui-ux@latest update --codex
  102. npx flawless-ui-ux@latest update --global --claude-code
  103. ```
  104. Without agent flags, `update` checks all supported destinations in the selected scope. Missing copies are skipped. Modified, unrecognized, linked, or newer copies stop the entire selected update before any installation changes. Keep local edits and reconcile them manually; there is no force overwrite. Clean 2.0.0 and published 2.2.0 copies are recognized by their file hashes. CLI installs and updates record the package version and file hashes in `.flawless-install.json` inside the skill directory, separate from your product/design Markdown. Bash and third-party installs may lack this record; exact recognized contents can still be adopted.
  105. Check local and global copies and browser availability:
  106. ```
  107. npx flawless-ui-ux@latest doctor --codex
  108. npx flawless-ui-ux@latest doctor --global --format json
  109. ```
  110. `doctor` reports paths, recorded versions, modifications, divergent copies, runtime dependencies, and a browser launch probe. A missing browser is advisory for source-only work. It does not download a browser, change agent settings, or establish that a skill is loaded in an active session. Both commands support the install agent flags and `--project`; only `--global` selects global updates. See the [maintenance contract](docs/cli-contract.md#update-and-doctor).
  111. ## Use the skill
  112. Start product onboarding inside your coding agent:
  113. ```text
  114. $flawless-ui-ux init
  115. ```
  116. This is a message to the agent, not a terminal command. The agent inspects the project, asks about material gaps or confirms a compact reading, then writes useful product context after your answer. Init ends with the product record; it does not build a screen or choose a visual direction.
  117. Codex uses `$flawless-ui-ux init`; hosts with slash commands use `/flawless-ui-ux init`; Pi uses `/skill:flawless-ui-ux init`. You can also ask the skill by name to initialize product context. Start a new session after installation if discovery needs to refresh.
  118. Continue in the same conversation as the interface develops:
  119. | Task | Example request |
  120. |---|---|
  121. | Initialize | Initialize this project's product context. Inspect what exists and confirm the missing facts with me. |
  122. | Create | Build a landing page for an app that coordinates deployments and incident handoffs. |
  123. | Redesign | Redesign this account screen for mobile using the supplied brand palette. Preserve its content and behavior. |
  124. | Refine | Give the main action more presence while preserving the page's visual character. |
  125. | Focus | Improve typography and spacing. Preserve wording, colors, and functionality. |
  126. | Review | Review this dashboard for readability, navigation, accessibility, and repeated generic patterns. Report findings without editing files. |
  127. ## How it works
  128. **The skill guides design and implementation.** It connects product context to composition, typography, color, density, imagery, and interaction. Focused references support creation, redesign, refinement, and review in your existing stack.
  129. For new interfaces and broad redesigns, the agent considers at least three meaningfully different compositions internally before implementation, then chooses an approach for the product and task. Focused refinements preserve the authorized scope and established decisions.
  130. The bundled library includes 27 selectively loaded references: decision procedures for typography, layout, color, tables, charts, forms, state transitions, copy, motion, performance and platform conventions. Ten original worked cases connect diagnosis to implementation. [Eight web studies](skills/flawless-ui-ux/assets/examples/index.html) run without a build or dependencies; two native code studies require an existing SwiftUI or Compose project and are explicitly uncompiled here. These are examples to inspect and adapt, not a framework to install in your application. See the [coverage and validation record](docs/skill-expansion.md).
  131. The design guidance applies to web, native mobile, and desktop interfaces. The CLI's rendered checks cover browser interfaces; native verification uses appropriate platform and project tools.
  132. **Refinement develops the intended character.** An interface may need more presence, less competing emphasis, or a more consistent finish. The right intervention depends on the content and task. Generic copy, repetitive decoration, and familiar patterns are reviewed in context, alongside usability and accessibility.
  133. **The CLI checks the implementation.** Collect project context, inspect selected source files or a running interface, and compare the result after corrections. Your agent makes the changes; the CLI provides observations and records what was actually checked.
  134. ## Product context and workflows
  135. Keep product facts and design decisions in your existing Markdown documents. Init reuses authoritative product records; new records use `.flawless-ui-ux/product.md`. Design documents remain separate and are preserved during onboarding. Existing 2.x files do not need to move. Use `context --source docs/brief.md` to select a document outside the conventional locations.
  136. For a new interface or broad redesign without a useful product record, the agent runs onboarding first and resumes your original request after recording the answers. A focused refinement or review can use the existing implementation directly. To read saved context from the terminal:
  137. ```
  138. npx flawless-ui-ux context --format json
  139. ```
  140. The former terminal `init` command is removed in 3.0.0; it returns migration guidance without creating files. See [migration to 3.0](docs/migration-3.md) for agent invocation, preserved records and installation updates.
  141. Inspect related screens with repeated `--url` inputs and `--consistency` for a contextual style inventory. Add `--flow flows/edit-member.json` to exercise explicitly defined UI actions, expectations, and named states in a permitted test environment. Verification requires the unchanged flow file to be selected again. See [workflow examples and limits](docs/product-aware-workflows.md).
  142. ## Inspect and verify
  143. Use the CLI directly, or ask your agent to include these checks in its work. Replace `npx` with `pnpm dlx` or `bunx` throughout.
  144. ### Optional visual report
  145. Add `--html` with a new output directory to inspect or verify:
  146. ```
  147. npx flawless-ui-ux inspect --url http://localhost:5173 --output ./inspection-before --html
  148. npx flawless-ui-ux verify ./inspection-before/run.json --output ./inspection-after --html
  149. ```
  150. Open `report.html` from the output directory. It shows findings, evidence, coverage, captured screens, and verification differences without a server or external services. Screenshots remain adjacent files; keep the output directory together when sharing it. Reports can contain your interface content and project paths. The HTML is an additional view of the same observations, not a design score or full accessibility certification. Omit `--html` to retain the existing JSON artifact behavior.
  151. ### Start with context and source
  152. ```bash
  153. npx flawless-ui-ux context --project . --format json
  154. npx flawless-ui-ux inspect --project . --source src/App.tsx --format json
  155. ```
  156. ### Check the running interface
  157. Start your app and prepare the browser once:
  158. ```bash
  159. npx playwright@1.64.1 install chromium
  160. # or: pnpm dlx playwright@1.64.1 install chromium
  161. # or: bunx playwright@1.64.1 install chromium
  162. ```
  163. Inspect the actual development-server URL and save a baseline:
  164. ```bash
  165. npx flawless-ui-ux inspect --project . --source src/App.tsx --url http://localhost:5173 --output ../app-before --format json
  166. ```
  167. After corrections, repeat the saved scope:
  168. ```bash
  169. npx flawless-ui-ux verify ../app-before/run.json --output ../app-after --format json
  170. ```
  171. The comparison separates **persistent**, **new**, and **no-longer-observed** findings. Missing confirmed targets and changed conditions remain unverified.
  172. | Area | Evidence collected |
  173. |---|---|
  174. | Accessibility | Selected axe contrast and accessible-name rules, including incomplete results for review |
  175. | Text and layout | Computed font sizes and horizontal overflow at the sampled widths |
  176. | Assets and runtime | Visible broken images and uncaught JavaScript errors |
  177. | Copy and icons | Exact repeated phrases and arrow cues for contextual review |
  178. | Source | Literal pixel font sizes and arrow/icon cues in selected files |
  179. <details>
  180. <summary>Scope, artifacts, and verification limits</summary>
  181. - Default viewport samples are **1440 × 900** and **390 × 844**. Repeat `--viewport WIDTHxHEIGHT` to choose others.
  182. - Repeat `--source` for additional files, or use `--selector` to inspect a region.
  183. - Use `--browser-executable` or `FLAWLESS_BROWSER_EXECUTABLE` to select an installed compatible Chromium. Keep browser conditions consistent between runs.
  184. - With `--output`, a new directory receives `run.json` and available screenshots; its parent must exist. Existing output directories are preserved. Without it, results go to stdout.
  185. - Add `--html` to include an offline `report.html` in that directory, with the same findings and coverage.
  186. These samples do not establish full WCAG conformance, complete keyboard journeys, business-flow correctness, or visual quality. Explicit flows cover only their selected actions and expectations. Small text and repetition require context. Ordinary inspection does not perform UI actions or submit forms. Explicit flows run selected actions with network-write and popup blocking. Inspection does not edit files, start servers, or download browsers.
  187. CLI exit codes: `0` for completed coverage without confirmed errors, `1` for completed coverage with confirmed errors, and `2` for invalid input or incomplete requested coverage. The installer also returns `0` when confirmation is declined and `130` when a prompt is interrupted.
  188. </details>
  189. ## Installation notes
  190. `install` preserves existing destinations. Use `update` for recognized unmodified copies; keep and reconcile custom changes before explicitly reinstalling. Host rules, plugins, permissions, and trust settings stay under your control.
  191. The twelve supported agents use **five project copies** of the same skill. Hosts that discover `.agents/skills` share one copy; others use their native directories.
  192. <details>
  193. <summary>Host-specific details</summary>
  194. - **Grok Build:** project skills become available after folder trust.
  195. - **DeepSeek Harness:** install from the nearest Git root, or the working directory without Git. Custom provider roots may change discovery.
  196. - **Kiro:** custom agents can reference skills through `skill://` resources.
  197. - **Global paths:** honor each host's configuration directory and overrides. Devin uses `APPDATA` on Windows and `XDG_CONFIG_HOME` elsewhere.
  198. See the [installation contract](docs/cli-contract.md#install) for exact paths and the [testing guide](docs/testing.md) for recorded compatibility evidence and pending checks.
  199. </details>
  200. ## Development
  201. ```bash
  202. bun install --frozen-lockfile
  203. bun test
  204. ```
  205. Bun is the development toolchain; the published CLI runs on Node. See [testing](docs/testing.md) for browser fixtures, packaging checks, and Windows/Ubuntu CI.
  206. ## Documentation
  207. - [2.0 migration](docs/migration-2.md) — report schema changes and compatibility
  208. - [Product-aware workflows](docs/product-aware-workflows.md) — Markdown context, selected flows, and cross-screen evidence
  209. - [Workflow guide](docs/workflow-procedures.md) — creation, redesign, refinement, and review
  210. - [CLI contract](docs/cli-contract.md) — installation paths, options, context, and comparison limits
  211. - [Product contract](docs/product-contract.md) — philosophy and scope
  212. - [Architecture](docs/skill-architecture.md) — skill, project context, and inspection core
  213. - [Manual evaluations](evals/README.md) — reproducible tasks and evidence criteria
  214. - [Changelog](CHANGELOG.md)
  215. ## License
  216. [MIT](LICENSE).
  217. Agent icons are provided by [Lobe Icons](https://github.com/lobehub/lobe-icons), using theme-aware images pinned to a specific revision. Product names and marks belong to their respective owners. Badges use [Shields.io](https://shields.io). Monthly downloads refer to the npm CLI package.

Ratings and comments

Sign in to rate this skill.

Sign in

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