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.5 $0.00076 $0.01926
Sonnet 5.5 $0.00038 $0.00963
Haiku 4.5 $0.00019 $0.00481

Measured 1mo ago against content hash a94986f1b1a5, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, 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 1mo 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. 1mo 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 (12 stars, last pushed 2mo ago), licensed MIT. It adds 191 tokens to every session and 4,815 once invoked, about $0.0008 per session on Opus 5.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

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).…

ViryaZheng/recomby-geo · 77 tokens

scroll-craft

Build premium scroll-driven landing pages for service, product, food, and drink brands. Plan the visitor journey, page grammar, emotional peak, and bespoke signature move. Create dimensional heroes with independent visual planes, restrained motion, and separate mobile composition. Use supplied photos and footage or…

nateherkai/scroll-craft · 177 tokens

interaction-skill

Layer A interaction-mechanics reference anchored to the beui.dev catalog. Stacks on any style skill whenever work adds or changes motion or interaction — micro-interactions, animated components, transitions, gestures, hover/press/state feedback, loading/success/error morphs, 'make it feel alive'. Mandates reading the…

code-yeongyu/oh-my-openagent · 104 tokens

layout-skill

Layer A layout-mechanics reference. Stacks on any style skill when the screen is an app shell, dashboard, settings, list-detail, mail/inbox, or any layout with fixed regions plus a scrolling body — or when a layout breaks under long, empty, or unbroken content. Owns spatial structure and scroll ownership; owns zero…

code-yeongyu/oh-my-openagent · 88 tokens

vertical-site-conventions

Compose pages and sites that read as their vertical: ecommerce-catalog storefronts that look like storefronts, hospitality-food sites that look like restaurants, b2b-manufacturer sites that look industrial. Use this skill whenever the user wants to build a site that looks like the vertical it serves, fix a build that…

rampstackco/claude-skills · 190 tokens

ui-design

Designs and builds React/Next/Tailwind UI, audits visual and interaction defects, and stress-tests components with worst-case data. Use when asked to "build a landing page", "extract our design system", "add dark mode", "make this responsive", "remove UI slop", "audit this component", "stress-test this component"…

mblode/agent-skills · 86 tokens