{"id":50125511,"url":"https://github.com/referodesign/refero_skill","last_synced_at":"2026-06-09T11:00:54.307Z","repository":{"id":355655957,"uuid":"1150376554","full_name":"referodesign/refero_skill","owner":"referodesign","description":"Research-first design skill for AI agents. 150K+ real app screens and flows via Refero MCP.","archived":false,"fork":false,"pushed_at":"2026-05-14T16:38:44.000Z","size":1780,"stargazers_count":63,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-05-14T18:40:18.904Z","etag":null,"topics":["agent","agent-skills","claude","cursor","design","figma","mcp","refero","skill","ui-design"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/referodesign.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-05T07:51:31.000Z","updated_at":"2026-05-14T16:37:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/referodesign/refero_skill","commit_stats":null,"previous_names":["referodesign/refero_skill"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/referodesign/refero_skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/referodesign%2Frefero_skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/referodesign%2Frefero_skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/referodesign%2Frefero_skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/referodesign%2Frefero_skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/referodesign","download_url":"https://codeload.github.com/referodesign/refero_skill/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/referodesign%2Frefero_skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34103357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agent-skills","claude","cursor","design","figma","mcp","refero","skill","ui-design"],"created_at":"2026-05-23T20:00:20.643Z","updated_at":"2026-06-09T11:00:54.301Z","avatar_url":"https://github.com/referodesign.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"![Refero Design Skill](assets/banner.png)\n\n# Refero Skill\n\nAn agent skill that makes design research mandatory before implementation: styles-first visual research, real-screen pattern research, flow reasoning, reference locks, decision ledgers, anti-AI-slop checks, and craft knowledge on typography, color, spacing, motion, icons, and copywriting. When Refero MCP is available, it can use curated visual styles, 150,000+ real app screens, and 6,000+ user flows from Stripe, Linear, Notion, Figma, and the best-designed products ever built.\n\n## Install\n\nWorks with Claude Code, Cursor, Gemini CLI, Lovable, and any MCP-compatible agent.\n\n```bash\nnpx skills add https://github.com/referodesign/refero_skill --skill refero-design\n```\n\nCraft knowledge loads immediately. No account required.\n\n\u003cdetails\u003e\n\u003csummary\u003eManual installation\u003c/summary\u003e\n\n```bash\ngit clone https://github.com/referodesign/refero_skill.git ~/.claude/skills/refero-design\n```\n\nOn Claude.ai, add the contents of `SKILL.md` to your project knowledge.\n\n\u003c/details\u003e\n\n---\n\n## What it does\n\n1. **Researches styles, screens, and flows** — starts with visual styles for taste and direction, then uses real screens and user flows for product patterns and journey logic when live Refero MCP tools are available.\n2. **Extracts patterns** — identifies specific design decisions and builds a reference list before touching code.\n3. **Applies craft knowledge** — uses built-in guides on typography, color, spacing, motion, icons, and copywriting. Flags anti-slop patterns before they appear.\n4. **Designs with evidence** — every decision traces back to a real product or a craft rule, not a training data average.\n\n\u003cdetails\u003e\n\u003csummary\u003eFiles\u003c/summary\u003e\n\n`SKILL.md` — Research-first methodology: styles-first visual research, screen/flow routing, synthesis, craft guidance, quality gates.\n\nReference guides: `typography.md`, `color.md`, `motion.md`, `icons.md`, `craft-details.md`, `anti-ai-slop.md`, `copywriting.md`, `mcp-tools.md`, `example-workflow.md`\n\n\u003c/details\u003e\n\n---\n\n## Connect live design research\n\nSet up Refero MCP from [refero.design/mcp](https://refero.design/mcp), then connect your tool:\n\n\u003cdetails\u003e\n\u003csummary\u003eClaude Code\u003c/summary\u003e\n\n```bash\nclaude mcp add --transport http refero https://api.refero.design/mcp --header \"Authorization: Bearer \u003ctoken\u003e\"\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eCursor\u003c/summary\u003e\n\nAdd to `.cursor/mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"refero\": {\n      \"url\": \"https://api.refero.design/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer \u003ctoken\u003e\" }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eGemini CLI\u003c/summary\u003e\n\n```bash\ngemini mcp add --transport http refero https://api.refero.design/mcp --header \"Authorization: Bearer \u003ctoken\u003e\"\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eLovable\u003c/summary\u003e\n\nSettings → Connectors → New MCP server → `https://api.refero.design/mcp` → Bearer token\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eOther tools\u003c/summary\u003e\n\n```\nURL: https://api.refero.design/mcp\nAuth: Bearer \u003ctoken\u003e\n```\n\n\u003c/details\u003e\n\nThe first time you call Refero, a browser window opens to sign in. After that it's automatic.\n\n## Contributing\n\nTo add a new skill, create a directory under `skills/` with a `SKILL.md` file following the [Agent Skills](https://agentskills.io/) format.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freferodesign%2Frefero_skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freferodesign%2Frefero_skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freferodesign%2Frefero_skill/lists"}