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.
npx skills add S3YED/appie-kit --skill refero-designgit clone --depth 1 https://github.com/S3YED/appie-kitWrote 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.
[](https://agentmods.dev/skills/s3yed/appie-kit/refero-design)<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.
<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>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.
| Model | Per session | Once 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 |
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.
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.
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:
- Styles - visual direction and taste.
- Screens - concrete UI patterns and product-screen decisions.
- 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.
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.
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.
- 6d ago First seen · 560 lines · 191 tokens per session scan A a94986f1b1a5
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.
Other skills, from other repositories
animation-patterns
Framer Motion patterns, page transitions, skeleton loading, scroll-linked animations, and gesture-based interactions for React.
component-library-patterns
Design system token management, component API design, Storybook, and visual regression testing patterns.
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…
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…
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…
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.…