Skip to content
Back to search

pinkrooster-terminal-ux

MarketplaceWorks with Claude CodeGitHub

PinkRooster's terminal UI/UX design skill for coding agents.

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/pinkroosterai--pinkroosterterminalux/badge.svg)](/listings/pinkroosterai--pinkroosterterminalux)

HTML

<a href="/listings/pinkroosterai--pinkroosterterminalux"><img src="/api/listings/pinkroosterai--pinkroosterterminalux/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.

Choose your coding harness. Run shell commands in a terminal; start a fresh agent session once installation finishes.

| Harness | Recommended installation | |---|---| | Claude Code | `claude plugin marketplace add pinkroosterai/PinkRoosterTerminalUx`, then `claude plugin install pinkrooster-terminal-ux@pinkrooster-terminal-ux` | | Codex CLI | `codex plugin marketplace add pinkroosterai/PinkRoosterTerminalUx`, then `codex plugin add pinkrooster-terminal-ux@pinkrooster-terminal-ux` | | Antigravity CLI | `agy plugin install https://github.com/pinkroosterai/PinkRoosterTerminalUx` | | Pi | `pi install git:github.com/pinkroosterai/PinkRoosterTerminalUx` | | Cursor, Gemini CLI, GitHub Copilot, OpenCode | `npx skills add pinkroosterai/PinkRoosterTerminalUx`, then select your harness |

The skills CLI needs Node.js 22.20 or later; add `-g` for a user-wide install and `--copy` where symlinks are unavailable. Keep the whole `skills/terminal-ux/` directory, including `references/`. Install using one method per harness to avoid a duplicate skill.

**Verify before starting:** ask your agent, "Is the terminal-ux skill installed? Read it and summarise its two modes. Do not change any files." Expect a summary of build and audit mode. This checks discovery and loading, not behaviour; `docs/testing.md` has four fresh-session prompts that test behaviour.

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.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "pinkrooster-terminal-ux",
  3. "description": "PinkRooster's terminal UI/UX design skill for coding agents.",
  4. "owner": {
  5. "name": "pinkroosterai"
  6. },
  7. "plugins": [
  8. {
  9. "name": "pinkrooster-terminal-ux",
  10. "source": "./",
  11. "description": "Terminal UI/UX design skill: designs, builds and audits command-line output, interactive prompts and full-screen TUIs to a high UX standard, in any language or framework.",
  12. "version": "0.1.0"
  13. }
  14. ]
  15. }
README.md · README · 141 lines
  1. <div align="center">
  2. <img src="assets/logo.svg" alt="PinkRooster logo" width="160" />
  3. # PinkRooster Terminal UX
  4. **One portable agent skill that designs, builds and audits terminal interfaces (command-line output, interactive prompts and full-screen TUIs) to a high UX standard, in whatever language and framework your project already uses.**
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  6. [![Agent Skills](https://img.shields.io/badge/Agent-Skills-ec4899)](https://agentskills.io/specification)
  7. [![Markdown and Bash](https://img.shields.io/badge/Markdown_and-Bash-4eaa25)](#development)
  8. [The idea](#the-idea) · [Install](#install) · [Usage](#usage) · [What's inside](#whats-inside) · [Compatibility](#compatibility) · [Development](#development)
  9. </div>
  10. ---
  11. ## The idea
  12. Coding agents write terminal UI that looks fine in a screenshot and breaks everywhere else:
  13. spinners leak into piped output, colour ignores `NO_COLOR`, shortcuts are hidden, layouts
  14. fall apart in an 80-column pane, Ctrl-C leaves the terminal broken, and errors say
  15. "Something went wrong". `terminal-ux` makes the agent apply the rules that prevent this
  16. while it writes the code, and audit existing interfaces against the same standard.
  17. The skill is **opinionated about behaviour and restrained about looks**. Stream discipline,
  18. graceful degradation (pipes, CI, no colour, narrow panes, no Unicode, screen readers), terminal
  19. restoration, discoverable keys and actionable microcopy are firm rules. Aesthetics are not
  20. imposed: the project's own look wins, and a project without one gets quiet, semantic defaults.
  21. It is stack-agnostic: it states what the user must see and be able to do, never how to use a
  22. particular UI library.
  23. These are instructions an agent follows, not a library or a linter. Your harness supplies file
  24. access, questions and shell commands. User instructions and project rules take precedence.
  25. ### When to Reach for It
  26. | If your immediate situation is... | Mode | What you get |
  27. |---|---|---|
  28. | A new command, script output or prompt flow to build | Build | Working code in your stack, plus the UX choices and the checks to run by hand |
  29. | A new full-screen screen, dashboard or picker | Build | A committed layout, keys with a legend, restoration on exit, a minimum-size message |
  30. | A small fix: table alignment, an error message, a flag's help text | Build | The edit, made directly from your code's context, without questions |
  31. | An existing tool whose terminal UX you want reviewed | Audit | Findings ordered by user harm, each with evidence and a fix; no code changed |
  32. It stays out of headless work (cron jobs, pure argument parsing, libraries with no
  33. human-facing output) and of web, desktop and mobile UI.
  34. ## Install
  35. Choose your coding harness. Run shell commands in a terminal; start a fresh agent session
  36. once installation finishes.
  37. | Harness | Recommended installation |
  38. |---|---|
  39. | Claude Code | `claude plugin marketplace add pinkroosterai/PinkRoosterTerminalUx`, then `claude plugin install pinkrooster-terminal-ux@pinkrooster-terminal-ux` |
  40. | Codex CLI | `codex plugin marketplace add pinkroosterai/PinkRoosterTerminalUx`, then `codex plugin add pinkrooster-terminal-ux@pinkrooster-terminal-ux` |
  41. | Antigravity CLI | `agy plugin install https://github.com/pinkroosterai/PinkRoosterTerminalUx` |
  42. | Pi | `pi install git:github.com/pinkroosterai/PinkRoosterTerminalUx` |
  43. | Cursor, Gemini CLI, GitHub Copilot, OpenCode | `npx skills add pinkroosterai/PinkRoosterTerminalUx`, then select your harness |
  44. The skills CLI needs Node.js 22.20 or later; add `-g` for a user-wide install and `--copy`
  45. where symlinks are unavailable. Keep the whole `skills/terminal-ux/` directory, including
  46. `references/`. Install using one method per harness to avoid a duplicate skill.
  47. **Verify before starting:** ask your agent, "Is the terminal-ux skill installed? Read it and
  48. summarise its two modes. Do not change any files." Expect a summary of build and audit mode.
  49. This checks discovery and loading, not behaviour; `docs/testing.md` has four fresh-session
  50. prompts that test behaviour.
  51. ## Usage
  52. | Harness | Explicit invocation example |
  53. |---|---|
  54. | Claude Code, plugin | `/pinkrooster-terminal-ux:terminal-ux audit the output of src/cli.py` |
  55. | Claude Code, standalone | `/terminal-ux audit the output of src/cli.py` |
  56. | Codex CLI / IDE | `$terminal-ux audit the output of src/cli.py` |
  57. | Pi | `/skill:terminal-ux audit the output of src/cli.py` |
  58. | Antigravity | Use its skill selector or ask "Use the terminal-ux skill to audit src/cli.py" |
  59. | Other skill-capable hosts | Ask for the skill by name; command syntax depends on the host |
  60. Natural requests such as "add a progress bar to the import command" or "review this TUI's
  61. keybindings" select the skill through its description. Selection is model-dependent;
  62. explicit invocation helps when routing is ambiguous.
  63. ## What's Inside
  64. A short [SKILL.md](skills/terminal-ux/SKILL.md) holds the workflow (classify the task, respect
  65. existing conventions, commit to a direction, build, audit), ten principles, the terminal-slop
  66. list and a routing table. The agent then reads only the references a task needs:
  67. | Reference | Covers |
  68. |---|---|
  69. | [output-and-resilience](skills/terminal-ux/references/output-and-resilience.md) | stdout vs stderr, TTY and CI detection, colour switches, Ctrl-C, terminal restoration, exit codes, progress and redraw |
  70. | [visual-style](skills/terminal-ux/references/visual-style.md) | colour roles, colour depth, light and dark backgrounds, attributes, glyph width, fallbacks, borders |
  71. | [layout-and-interaction](skills/terminal-ux/references/layout-and-interaction.md) | inline vs full-screen, TUI layout, size and resize, keys, legends, mouse, paging, tables, diffs |
  72. | [prompts-and-microcopy](skills/terminal-ux/references/prompts-and-microcopy.md) | prompts, validation, errors, success output, empty states, confirmations, help text |
  73. | [accessibility](skills/terminal-ux/references/accessibility.md) | screen readers, colour and contrast, motion, linear output, the accessible mode |
  74. | [audit-checklist](skills/terminal-ux/references/audit-checklist.md) | the pass/fail pre-delivery audit, terminal slop, the audit report format |
  75. Rules come from published guidance (clig.dev, `NO_COLOR`, terminal specifications, CLI
  76. writing guides and accessibility research); where the field is silent, a rule is labelled as
  77. the skill's opinion.
  78. ---
  79. ## Compatibility
  80. The common [Agent Skills format](https://agentskills.io/specification) makes the skill
  81. portable; it does not standardise tool APIs, permissions or command syntax.
  82. `argument-hint` is a deliberate Claude Code frontmatter extension. Strict `skills-ref`
  83. validation reports it as unsupported; this is documented rather than counted as a pass.
  84. Official references: [Claude Code](https://code.claude.com/docs/en/skills),
  85. [Codex](https://learn.chatgpt.com/docs/build-skills),
  86. [Antigravity](https://antigravity.google/docs/skills),
  87. [Pi](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/skills.md),
  88. and [OpenCode](https://opencode.ai/docs/skills/).
  89. ## Development
  90. Contributor checks require Bash, standard Unix utilities and `jq`. Native package validation
  91. also requires the corresponding harness CLI; the skill itself has no runtime dependencies.
  92. ```bash
  93. bash scripts/check-skills.sh # skill, references, links, labels, packages
  94. bash scripts/test-check-skills.sh # plants faults in a scratch copy, expects rejection
  95. bash scripts/check-packages.sh # requires jq
  96. claude plugin validate .
  97. # Optional strict format validation (argument-hint is a known extension):
  98. npx -y skills-ref validate skills/terminal-ux
  99. ```
  100. Behaviour is tested by hand in fresh sessions with `docs/testing.md`. See
  101. [AGENTS.md](AGENTS.md) for maintenance rules: no UI library is ever named in the skill, the
  102. references stay between three and six files, and every one is reached from the routing table.
  103. Update the [changelog](CHANGELOG.md) and all package version records when preparing a release.
  104. The project is [MIT licensed](LICENSE). The header logo is shared with
  105. [PinkRooster](https://github.com/pinkroosterai/PinkRooster).

Ratings and comments

Sign in to rate this skill.

Sign in

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