muriel

A collaborative visual-design system for making and checking decisions about how software looks and works for people. It covers interaction patterns, information structure, spatial layout, hierarchy, readability, composition, and rendered visual proof.

In plain words
What is it for?
Use it when designing unfamiliar controls, dense interfaces, complex visual representations, or cross-channel experiences, and when reviewing a rendered design for clarity and hierarchy.
Why use it?
It helps resolve design choices that could change the implementation and checks the finished result against what users need to see and do.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/andyed/muriel/compose
Any agent
npx skills add andyed/muriel --skill compose
Clone the repo
git clone --depth 1 https://github.com/andyed/muriel

Made for: Claude Code, Codex.

Per session 101 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,630 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00101 $0.02630
Opus 5 $0.00051 $0.01315
Sonnet 5 $0.00020 $0.00526
Haiku 4.5 $0.00010 $0.00263

Measured 2d ago against content hash cb1ec900ed72, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

muriel scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (examples/drop-caps/gen_dropcap.py, examples/drop-caps/gen_foveated_dropcap.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/muriel/skills/compose/SKILL.md · 245 lines

How it starts

The opening of the file, as written. The whole thing — 245 lines — stays where its author put it; the contents beside it link to each section on GitHub.

muriel — visual decisions inside the solution

Muriel is a visual collaborator, not a detached critic or late-stage decorator.

The calling agent owns product truth, code architecture, domain behavior, and the overall delivery. Muriel owns design synthesis for the human-visible slice, interaction grammar, hierarchy, legibility, composition, and visual proof. Work through the project's canonical state and components; do not create a parallel control model just to make the surface easier to style.

Invocation gate

Invoke Muriel at a design decision or visual-proof boundary, not merely because the task produces pixels. Proceed when at least one condition is true:

  • an unsettled interaction, representation, or composition choice could materially change implementation;
  • a novel, dense, spatial, or cross-channel surface needs specialist synthesis;
  • an implemented artifact needs rendered visual verification beyond routine correctness checks.

Before proceeding, complete:

Muriel should decide or verify ___; without her, the material user-visible risk is ___; proof will come from ___.

If those blanks do not name a consequential decision, risk, and proof, defer to the calling agent. When a narrower production skill owns the medium, it remains primary; Muriel joins only for an unresolved cross-cutting visual decision.

Entry contract

Before taking task action, state Muriel's role to the calling agent in three short parts, plus the adaptive mode when the direction is unsettled:

  • Purpose — the user-visible problem Muriel will solve.
  • Integration — the existing component, state path, or build system she will join.
  • Proof — the render, artifact, interaction path, or audit that will show the result works.
  • Mode — for a what or why decision, name Direct, Compare, or Probe and the uncertainty, reversibility, blast radius, or evidence gap that set it.

Example:

Muriel's purpose here is to make the mode choice legible. She will work through the existing menu state, and we will prove it with the focused interaction test plus a rendered-state check.

Read the full file on GitHub · 245 lines

Files

What ships with it

60 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 245 lines · 101 tokens per session scan A cb1ec900ed72

Subscribe to this mod's changes

muriel is a skill published in the GitHub repository andyed/muriel (19 stars, last pushed 3d ago), licensed MIT. It adds 101 tokens to every session and 2,630 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

anydesign

Analyze images, websites, and Figma files to extract their design and generate a design.md with token system, component inventory, and reconstruction notes. Use this skill whenever the user wants to understand, document, replicate, or audit the design of something visual: a screenshot, a URL, a Figma link, a Pinterest…

uxKero/anydesign · 214 tokens

claude-design-idea-to-ready

Take a UI from a one-line idea to on-brand, shippable design with Claude, in the correct order — brand foundation first, then components, screens, interactions, accessibility, and only then generation via /design. Use whenever someone wants to design, redesign, or generate a screen, page, component, or onboarding flow…

chohra-med/claude_design_skill · 135 tokens

extract-design

Extract the full design language from any website URL. Produces 8 output files including AI-optimized markdown, visual HTML preview, Tailwind config, React theme, shadcn/ui theme, Figma variables, W3C design tokens, and CSS variables. Also runs WCAG accessibility scoring. Use when user says 'extract design', 'get…

Manavarya09/design-extract · 98 tokens

ss-score

Score a visual artifact's implementation quality 0-100 against its composed StyleSeed rule set — category breakdown, evidence, and prioritized fixes.

bitjaru/styleseed · 31 tokens

ss-update

Check and update an existing StyleSeed installation by exact rule/skill revision, preserve project-owned design decisions, then recompile and verify the effective bundle.

bitjaru/styleseed · 33 tokens

designlang-tokens

Use when styling UI for cal.com — references the extracted design system tokens instead of inventing colors, spacing, or typography.

Manavarya09/design-extract · 30 tokens