Skip to content
Back to search

argus-skill

MarketplaceWorks with Claude CodeGitHub

Argus, a design skill for AI 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/hamza-masuadi--argus-skill/badge.svg)](/listings/hamza-masuadi--argus-skill)

HTML

<a href="/listings/hamza-masuadi--argus-skill"><img src="/api/listings/hamza-masuadi--argus-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

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 · 17 lines
  1. {
  2. "name": "argus-skill",
  3. "description": "Argus, a design skill for AI coding agents",
  4. "owner": {
  5. "name": "Hamza Masuadi",
  6. "url": "https://github.com/Hamza-Masuadi"
  7. },
  8. "plugins": [
  9. {
  10. "name": "argus",
  11. "source": "./",
  12. "description": "A design skill built around looking at the rendered result. Websites, dashboards and mobile app screens, in any framework.",
  13. "version": "0.3.2",
  14. "category": "design"
  15. }
  16. ]
  17. }
README.md · README · 160 lines
  1. # Argus
  2. The design skill that looks at its own work. Argus makes your coding agent design websites, dashboards and app screens the way a designer does: ask first, show you directions to choose from, build, then look at the real page and fix what it sees.
  3. ```bash
  4. npx argus-skill install
  5. ```
  6. Then ask for design work as usual: "build a landing page for my bakery", "add a settings screen", "make this look better". Or name a command, such as `/argus polish the pricing section`.
  7. Works with Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, Kiro, OpenCode, Grok, Devin and Windsurf.
  8. ## Why
  9. Agents already know the rules of design. Their pages still come out generic, for four reasons. Argus is built around fixing each one.
  10. - **The agent cannot see what it makes.** It writes code and imagines the result. Argus renders the page at phone and desktop width, looks at it, fixes it and looks again.
  11. - **Its first idea is everyone's first idea.** Argus asks you one short round of questions, throws away the obvious ideas and draws the design from your subject.
  12. - **It judges better than it generates.** Argus builds several first screens and puts them side by side, so you pick by looking instead of describing.
  13. - **It plays safe.** Every new page gets one idea carried all the way down, and one big move on the first screen.
  14. ## How it works
  15. For a new page:
  16. 1. **It asks.** One round, every question skippable, with a recommended answer already chosen. Who it is for, how it should feel, what you have to show. It also proposes three first-screen approaches suited to your subject and asks how many directions you want to see: 1, 3 or 5.
  17. 2. **It shows you directions.** Each one is a different idea for the whole design, shown as a real first screen, side by side on one page. Pick one or mix them.
  18. 3. **It builds the page** from the direction you chose, with real content and working controls.
  19. 4. **It looks.** Screenshots at three widths, a measured check, and a list of mistakes found in real generated pages. It fixes what it finds and looks again.
  20. 5. **It reports** what it made, what it checked and what it assumed.
  21. In a project that already has a look, Argus does the opposite of inventing: it measures the fonts, sizes, colours and spacing your product really uses, builds the new screen from those, and lists anything it could not match. A one-line tweak gets no ceremony at all.
  22. ## Commands
  23. | Command | What it does |
  24. |---|---|
  25. | `variants` | Builds three to five distinct directions and shows them side by side for you to pick |
  26. | `polish` | Final pass on a working screen: alignment, spacing, states, copy |
  27. | `audit` | Measured check with a score and ranked findings; changes nothing |
  28. | `typeset` | Fixes typography |
  29. | `colorize` | Fixes or introduces colour |
  30. | `animate` | Adds motion with a purpose, or removes motion without one |
  31. | `simplify` | Removes what is not earning its place |
  32. ## What makes it different
  33. - **It looks at its own work.** Verified means rendered and looked at, not "the code reads right".
  34. - **You choose by looking.** Directions arrive as real screens, not as a paragraph of adjectives.
  35. - **It matches before it invents.** Inside an existing product, it measures the system and stays in it.
  36. - **Plain text.** The skill is Markdown. No background process, no hooks, no network calls, no settings changed.
  37. - **Small core.** About 1,300 words load when the skill triggers. Everything else loads only for the task in hand.
  38. - **More than landing pages.** Separate guides for product UI, photo-led pages, web and native mobile.
  39. - **Honest about design lore.** Its reference on the laws of UX says which are well supported and which popular "rules" are myths.
  40. ## Tools
  41. The agent uses these by itself. You can also run them:
  42. ```bash
  43. npx argus-skill check http://localhost:3000
  44. ```
  45. | Command | What it does |
  46. |---|---|
  47. | `check <url>` | Loads the page in a real browser and measures contrast, overflow, collapsed columns, target sizes, labels, page length and more |
  48. | `shot <url>` | Screenshots at phone and desktop widths; `--full` captures the whole page |
  49. | `inventory <url>` | Measures the design system a page really uses; `--against <url>` lists what a new screen adds to an existing one |
  50. | `compare` | Builds a before-and-after page from two screenshots, with a slider and the pixels that changed |
  51. | `lint` | Scans source files when nothing can be rendered |
  52. | `contrast` | Checks colour pairs |
  53. Written in TypeScript, shipped compiled, no dependencies. They need Node 22 or later and, for the browser tools, an installed Chrome-family browser.
  54. ## Other ways to install
  55. **Claude Code, as a plugin**
  56. ```
  57. /plugin marketplace add Hamza-Masuadi/argus-skill
  58. /plugin install argus@argus-skill
  59. ```
  60. **Installer options**
  61. | Option | Effect |
  62. |---|---|
  63. | `--global` | Install for your user account instead of this project |
  64. | `--tools=claude,cursor` | Choose the tools yourself |
  65. | `--all` | Every supported tool |
  66. | `--dry-run` | Show what would happen and change nothing |
  67. `update` replaces an existing copy, `uninstall` removes it, `list` shows every supported tool and its folder. The installer only copies files.
  68. **With the skills CLI**
  69. ```bash
  70. npx skills add Hamza-Masuadi/argus-skill
  71. ```
  72. **By hand**
  73. Copy the `skills/argus` folder into your tool's skills folder, keeping the name `argus`.
  74. <details>
  75. <summary>Where each tool reads skills</summary>
  76. | Tool | In a project | For your user account |
  77. |---|---|---|
  78. | Claude Code | `.claude/skills/` | `~/.claude/skills/` |
  79. | Codex, Amp and other tools that read the shared convention | `.agents/skills/` | `~/.agents/skills/` |
  80. | Cursor | `.cursor/skills/` | `~/.cursor/skills/` |
  81. | Gemini CLI | `.gemini/skills/` | `~/.gemini/skills/` |
  82. | GitHub Copilot / VS Code | `.github/skills/` | `~/.copilot/skills/` |
  83. | Kiro | `.kiro/skills/` | `~/.kiro/skills/` |
  84. | OpenCode | `.opencode/skills/` | `~/.config/opencode/skills/` |
  85. | Grok | `.grok/skills/` | `~/.grok/skills/` |
  86. | Devin / Windsurf | `.devin/skills/` | `~/.config/devin/skills/` |
  87. </details>
  88. <details>
  89. <summary>What is inside</summary>
  90. Everything is in `skills/argus/`.
  91. | File | Purpose |
  92. |---|---|
  93. | `SKILL.md` | The core: routing, the loop, and the rules that always hold |
  94. | `references/ask.md` | The question round for new work |
  95. | `references/create.md` | New pages: the idea, the big move, directions, the first-screen pass |
  96. | `references/structures.md` | Twelve page structures, so directions differ in shape and not only in colour |
  97. | `references/ingredients.md` | The token roles every design fills in, and options for colour, type, shape and space |
  98. | `references/extend.md` | Adding to a product that already has a look |
  99. | `references/product.md` | Dashboards, tools and app screens |
  100. | `references/photos.md` | Pages where pictures do the selling |
  101. | `references/web.md`, `references/mobile.md` | What goes where on a page or app screen |
  102. | `references/slips.md` | Mistakes found in real generated pages, checked on every look |
  103. | `references/verify.md` | How to capture, check and review |
  104. | `references/craft.md` | Every number: type, colour, space, motion, targets |
  105. | `references/laws.md` | What the established laws of UX do and do not justify, plus myths |
  106. | `references/tells.md` | Common generated-design defaults and what to do instead |
  107. | `references/review.md`, `references/design-md.md` | Critique format; recording decisions |
  108. | `references/commands/` | One file per command |
  109. </details>
  110. ## Status
  111. Argus is developed and tested in Claude Code, with the browser tools tested on macOS. If you use it in another tool or on another system, [open an issue](https://github.com/Hamza-Masuadi/argus-skill/issues) and say how it went. See the [changelog](CHANGELOG.md) for what is new.
  112. ## Credits
  113. Named after Argus Panoptes, the hundred-eyed watchman of Greek myth. Written from scratch, drawing on established design research (Laws of UX, Nielsen Norman Group, WCAG 2.2, the Apple and Material guidelines) and on lessons from studying other design skills, including impeccable, taste-skill, UI UX Pro Max and Anthropic's frontend-design.
  114. Created by Hamza Masuadi (Hamzawee), co-authored with Claude (Anthropic).
  115. ## Licence
  116. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

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