refero-design

refero-design is a skill for Claude Code, Codex from referodesign/refero_skill. It costs 191 tokens per session (4,454 once invoked), scanned A, original, MIT.

Design guidance for creating user interfaces, websites, dashboards, and other digital product screens.

In plain words
What is it for?
Use it before designing or redesigning a product interface, landing page, dashboard, component, or responsive web experience.
Why use it?
It gives the agent reference-based direction for visual style, layout, user flows, typography, color, spacing, motion, accessibility, and copy.

Skill for Claude CodeCodex

Written for Claude Code and Codex: shipped in a Claude Code plugin, but also agents/openai.yaml present. Also seen: mentions Claude Code.

Part of the refero plugin — 1 skill, 1 MCP server shipped together

not rated 254repo +12 5d ago A scan Socket: passSnyk: warnSkillSpector: warn 191 tokens original MIT

Good fit Use it before designing or redesigning a product interface, landing page, dashboard, component, or responsive web experience.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/referodesign/refero_skill/refero-design
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.

Any agent
npx skills add referodesign/refero_skill --skill refero-design
Clone the repo
git clone --depth 1 https://github.com/referodesign/refero_skill

Made for: Claude Code, Codex.

Or install refero, the plugin that ships this one along with the rest of its 1 skill, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for refero-design

README.md
[![agentmods](https://agentmods.dev/badge/skills/referodesign/refero_skill/refero-design/github.svg)](https://agentmods.dev/skills/referodesign/refero_skill/refero-design)
Your own site
<a href="https://agentmods.dev/skills/referodesign/refero_skill/refero-design"><img src="https://agentmods.dev/badge/skills/referodesign/refero_skill/refero-design/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for refero-design

Your own site · 80×15
<a href="https://agentmods.dev/skills/referodesign/refero_skill/refero-design"><img src="https://agentmods.dev/badge/skills/referodesign/refero_skill/refero-design.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 191 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,454 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Socket pass 10 Jun 2026
  • Snyk warn 10 Jun 2026
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Data Exfiltration · line 66
    Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.
    Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
How audits are shown
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.1 $0.00191 $0.04454
Opus 5 $0.00096 $0.02227
Sonnet 5 $0.00038 $0.00891
Haiku 4.5 $0.00019 $0.00445

Measured 10d ago against content hash 4a4a7a0b72a2, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

refero-design 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 10d ago.

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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

skills/refero-design/SKILL.md · 535 lines

How it starts

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

Refero Design

Refero gives agents taste and product evidence. Use it before design work instead of relying on generic model knowledge.

Refero has three research layers:

  1. Styles - visual direction and taste.
  2. Screens - concrete UI patterns and product-screen decisions.
  3. Flows - multi-step journey logic.

Best results come from combining layers: visual direction from styles, concrete UI patterns from screens, and sequencing from flows when the task has multiple steps.

Non-Negotiables

  • Research before design work. Every design must be grounded in references before implementation. Do not rely on the model's generic design taste.
  • Use styles first for visual work when Refero MCP tools are available. If tools are unavailable, use bundled craft references and keep the same reference-lock workflow.
  • Do not copy one reference. Study several strong references and synthesize a new direction for the user's product.
  • Do not average references into a safe middle. When references conflict, choose one dominant direction and preserve its sharp traits. Secondary references may add narrow details only.
  • Do not change token meanings. If a reference says a color, font, radius, shadow, gradient, or component is for a specific role, use it only for that role or omit it.
  • Respect imagery guidance. If a style depends on photography, illustration, product shots, or graphics, preserve the media role. Use real/generated/stock assets when available; otherwise create an intentional placeholder with art direction. Do not fake complex imagery with weak CSS, text, or decorative boxes.
  • Do not use generic frontend/product design skills as a parallel design authority when this skill is available. Refero is the design methodology; generic design skills tend to pull work back toward generic AI design.
  • Research output must be specific. Name the references, describe concrete choices, and explain what will be adapted.
  • No design from vibe memory. Every major visual, layout, content, or interaction decision must trace to Refero research, the user's brief, or a craft reference.
  • Synthesize before implementation. Turn research into a concept, token direction, and concrete decision ledger before drawing or coding.
  • A brief is not a build target. Before implementation, lock either a user-provided visual source, an existing product/design-system target, a selected generated mockup, or an explicit reference-locked direction approved for direct build.
  • Use image generation only when it changes the outcome. Image generation can be slow and may not exist in every coding environment. Use it for visual exploration, mockups, imagery, illustrations, textures, and difficult assets; skip it for small fixes, obvious production edits, or code-native UI work.
  • Validate after building visual work. Compare the rendered implementation against the locked target/reference before handoff. Fix actionable design drift instead of treating research as sufficient.

Read the full file on GitHub · 535 lines

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. 10d ago First seen · 535 lines · 191 tokens per session scan A 4a4a7a0b72a2

Subscribe to this mod's changes

refero-design is a skill published in the GitHub repository referodesign/refero_skill (254 stars, last pushed 5d ago), licensed MIT. It adds 191 tokens to every session and 4,454 once invoked, about $0.0010 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

tailwind-design-system

Build scalable design systems with Tailwind CSS v4, design tokens, component libraries, and responsive patterns. Use when creating component libraries, implementing design systems, or standardizing UI patterns.

calesthio/OpenMontage · 42 tokens

ui-ux-design-best-practices

UI/UX polish, component design, animation decisions, and Tailwind v4 patterns for making interfaces feel right. Use when reviewing, writing, or refactoring UI code involving animations, transitions, CSS transforms, gestures, Tailwind utility classes, or interactive component behavior. Triggers on tasks involving…

louisbrulenaudet/monorepo-template · 96 tokens

fmcp-token-sync-orchestrator

Figma design token'larını kod dosyalarıyla (CSS/Tailwind/Swift/Compose) platform-agnostic senkronize eder. Diff preview + onay + write akışı zorunlu. Her platformda çalışır. Condensed-first: Essentials bölümü %80 case'i kapsar, Advanced sadece edge case'lerde.

atezer/FMCP · 79 tokens

frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI).…

Alenryuichi/openmemory-plus · 77 tokens

design-taste-frontend

Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right design direction, and ships interfaces that do not look templated. Real design systems when applicable, audit-first on redesigns, strict pre-flight check.

Leonxlnx/taste-skill · 61 tokens

image-to-code

Elite website image-to-code skill for Codex. For visually important web tasks, it must first generate the design image(s) itself, deeply analyze them, then implement the website to match them as closely as possible. In Codex, it must prefer large, readable, section-specific images instead of tiny compressed boards…

Leonxlnx/taste-skill · 116 tokens