refero-design

refero-design is a skill for Claude Code, Codex from S3YED/appie-kit. It costs 191 tokens per session (4,815 once invoked), scanned A, a copy of refero-design, MIT.

A design research guide for creating web and product interfaces, using examples of visual styles, screens, and multi-step user journeys.

In plain words
What is it for?
Designing or redesigning landing pages, dashboards, product screens, responsive layouts, components, and design systems.
Why use it?
It gives design work concrete references and decisions instead of leaving the agent to rely on generic design patterns.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Designing or redesigning landing pages, dashboards, product screens, responsive layouts, components, and design systems.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/s3yed/appie-kit/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 S3YED/appie-kit --skill refero-design
Clone the repo
git clone --depth 1 https://github.com/S3YED/appie-kit

Made for: Claude Code, Codex.

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/s3yed/appie-kit/refero-design/github.svg)](https://agentmods.dev/skills/s3yed/appie-kit/refero-design)
Your own site
<a href="https://agentmods.dev/skills/s3yed/appie-kit/refero-design"><img src="https://agentmods.dev/badge/skills/s3yed/appie-kit/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/s3yed/appie-kit/refero-design"><img src="https://agentmods.dev/badge/skills/s3yed/appie-kit/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,815 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.
Origin 95% copy Near-identical to another mod 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.04815
Opus 5 $0.00096 $0.02407
Sonnet 5 $0.00038 $0.00963
Haiku 4.5 $0.00019 $0.00481

Measured 6d ago against content hash a94986f1b1a5, 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 6d 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

This is a copy

95% identical to refero-design — 33 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

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

How it starts

The opening of the file, as written. The whole thing — 560 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.

  • Mercury Polish Strategy: Specialized premium design direction for high-end professional services. Includes light-weight display types, pill buttons, and shadowless surface depth.

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 · 560 lines

Files

What ships with it

1 file 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. 6d ago First seen · 560 lines · 191 tokens per session scan A a94986f1b1a5

Subscribe to this mod's changes

refero-design is a skill published in the GitHub repository S3YED/appie-kit (9 stars, last pushed 14d ago), licensed MIT. It adds 191 tokens to every session and 4,815 once invoked, about $0.0010 per session on Opus 5. A static security scan graded it A with 0 findings. It is 95% identical to refero-design, differing in 33 lines, and is treated as a copy.

Related

Other skills, from other repositories

animation-patterns

Framer Motion patterns, page transitions, skeleton loading, scroll-linked animations, and gesture-based interactions for React.

vibeeval/vibecosystem · 26 tokens

component-library-patterns

Design system token management, component API design, Storybook, and visual regression testing patterns.

vibeeval/vibecosystem · 22 tokens

design-loop

Autonomous multi-page site builder using a baton-passing loop. Each iteration reads a task from .design/next-prompt.md, generates a page in HTML/Tailwind, integrates it into the site, verifies visually, then writes the next task to keep the loop alive. Use whenever the user asks to build an entire site autonomously…

jezweb/claude-skills · 130 tokens

color-palette

Generate complete, accessible colour palettes from a single brand hex. Produces 11-shade scale (50-950), semantic tokens, dark mode variants, Tailwind v4 CSS output, WCAG contrast checks. Use whenever the user supplies a brand hex and asks for a palette, mentions setting up a design system, wants Tailwind theme…

jezweb/claude-skills · 87 tokens

tailwind-theme-builder

Set up Tailwind v4 + shadcn/ui themed UI with dark mode. Install deps, configure CSS variables via @theme inline, wire dark mode toggle, verify. Use whenever the user mentions Tailwind v4, setting up Tailwind theming, shadcn/ui colours, dark mode, or troubleshooting colours not working, tw-animate-css errors, @theme…

jezweb/claude-skills · 98 tokens

design-review

Review a web app or page for visual design quality — layout, typography, spacing, colour, hierarchy, consistency, interaction patterns, and responsive behaviour. Not a UX audit (that checks usability) — this checks whether it looks professional and polished. Produces a design findings report with screenshots.…

jezweb/claude-skills · 108 tokens