{
  "markdown": "![Refero Design Skill](assets/banner.png)\n\n# Refero\n\nRefero packages one design skill and one read-only MCP connection for AI design work.\nThe skill makes research mandatory before implementation. With live Refero research, agents\ncan use curated visual styles, 150,000+ real app screens, and 6,000+ user flows from\nwell-designed products.\n\n## Install\n\n### ChatGPT / Codex\n\n[Install Refero from the OpenAI Plugins Directory](https://chatgpt.com/plugins/plugin_asdk_app_6a72258e6f18819183e5c4d8a56b78d9).\n\nThe plugin includes Refero MCP and Refero Skill. Sign in with your Refero account when prompted; no manual MCP config or separate skill installation is needed. Live research requires a paid Refero plan. See the [setup guide](https://doc.refero.design/mcp/getting-started).\n\n### Codex app and CLI — install from GitHub\n\n```bash\ncodex plugin marketplace add referodesign/refero_skill\ncodex plugin add refero@refero\n```\n\nRestart the app after installation. The first connection opens Refero in the browser for\nOAuth sign-in.\n\n### Claude Code\n\n```text\n/plugin marketplace add referodesign/refero_skill\n/plugin install refero@refero\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/referodesign/refero_skill\n```\n\n### Cursor\n\nAfter the marketplace listing is approved, open Cursor's plugin marketplace or run\n`/add-plugin` and search for **Refero**.\n\n### Standalone skill\n\nUse this when the client already has Refero MCP configured or only the design methodology\nis needed:\n\n```bash\nnpx skills add https://github.com/referodesign/refero_skill --skill refero-design\n```\n\nNo account is required for the bundled craft references. Live Refero research uses OAuth\nwhen the MCP client first connects to `https://api.refero.design/mcp`.\n\n## What it does\n\n1. Researches visual styles first, then real screens and user flows when the task needs them.\n2. Extracts concrete patterns and locks references before implementation.\n3. Applies bundled guidance for typography, color, spacing, motion, icons, and copywriting.\n4. Keeps design decisions tied to evidence instead of generic AI defaults.\n5. Checks substantial visual work against the selected direction before handoff.\n\n## What is included\n\n- `skills/refero-design/` — the single canonical skill and its references.\n- `.mcp.json` — Refero MCP for Codex and Claude Code plugin installs.\n- `mcp.json` — Refero MCP for Cursor plugin installs.\n- `gemini-extension.json` — Gemini CLI extension manifest.\n- `.codex-plugin/`, `.claude-plugin/`, and `.cursor-plugin/` — platform metadata.\n- `server.json` — official MCP Registry metadata.\n\nAll connection manifests use the same production endpoint and contain no access tokens.\n\n## Existing standalone installations\n\nOlder clones placed `SKILL.md` at the repository root. Remove that old installation and\nrun the standalone install command again. The current skill lives at\n`skills/refero-design/SKILL.md`; keeping both layouts creates duplicate skills.\n\nFor manual installation, copy the entire `skills/refero-design/` directory into the\nclient's skills directory so its `references/` files remain beside `SKILL.md`.\n\n## Validate a release\n\n```bash\nscripts/check-release\n```\n\nThe check validates manifests, versions, local links, the canonical MCP URL, package\nboundaries, and common secret leaks. Platform-native validation and clean-profile install\ntests are still run before tagging a release.\n\n## Security\n\nReport vulnerabilities privately to [support@refero.design](mailto:support@refero.design).\nSee [SECURITY.md](SECURITY.md) for details.\n\n## License\n\nMIT\n",
  "bytes": 3575,
  "sha": "fc5c1c8492059a7ab02c1308bce7de2fde1b13193b00a34fda2cd2252666882b",
  "repo_slug": "referodesign/refero_skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_referodesign_refero_skill_15a9c8bf/readme"
}