Skip to content
Back to search

refero

MarketplaceWorks with Claude CodeGitHub

Refero design research skill and read-only MCP tools.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/referodesign-refero-skill/badge.svg)](/listings/referodesign-refero-skill)

HTML

<a href="/listings/referodesign-refero-skill"><img src="/api/listings/referodesign-refero-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

ChatGPT / Codex

[Install Refero from the OpenAI Plugins Directory](https://chatgpt.com/plugins/plugin_asdk_app_6a72258e6f18819183e5c4d8a56b78d9).

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

Codex app and CLI — install from GitHub

codex plugin marketplace add referodesign/refero_skill
codex plugin add refero@refero

Restart the app after installation. The first connection opens Refero in the browser for OAuth sign-in.

Claude Code

/plugin marketplace add referodesign/refero_skill
/plugin install refero@refero

Gemini CLI

gemini extensions install https://github.com/referodesign/refero_skill

Cursor

After the marketplace listing is approved, open Cursor's plugin marketplace or run `/add-plugin` and search for **Refero**.

Standalone skill

Use this when the client already has Refero MCP configured or only the design methodology is needed:

npx skills add https://github.com/referodesign/refero_skill --skill refero-design

No account is required for the bundled craft references. Live Refero research uses OAuth when the MCP client first connects to `https://api.refero.design/mcp`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  3. "name": "refero",
  4. "description": "Refero design research skill and read-only MCP tools.",
  5. "owner": {
  6. "name": "Refero",
  7. "email": "support@refero.design"
  8. },
  9. "plugins": [
  10. {
  11. "name": "refero",
  12. "source": "./",
  13. "description": "Research real product interfaces and design with evidence from Refero.",
  14. "version": "1.0.3",
  15. "author": {
  16. "name": "Refero",
  17. "email": "support@refero.design"
  18. },
  19. "homepage": "https://refero.design/mcp",
  20. "repository": "https://github.com/referodesign/refero_skill",
  21. "license": "MIT",
  22. "category": "design"
  23. }
  24. ]
  25. }
README.md · README · 103 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ![Refero Design Skill](assets/banner.png)
  2. # Refero
  3. Refero packages one design skill and one read-only MCP connection for AI design work.
  4. The skill makes research mandatory before implementation. With live Refero research, agents
  5. can use curated visual styles, 150,000+ real app screens, and 6,000+ user flows from
  6. well-designed products.
  7. ## Install
  8. ### ChatGPT / Codex
  9. [Install Refero from the OpenAI Plugins Directory](https://chatgpt.com/plugins/plugin_asdk_app_6a72258e6f18819183e5c4d8a56b78d9).
  10. The 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).
  11. ### Codex app and CLI — install from GitHub
  12. ```bash
  13. codex plugin marketplace add referodesign/refero_skill
  14. codex plugin add refero@refero
  15. ```
  16. Restart the app after installation. The first connection opens Refero in the browser for
  17. OAuth sign-in.
  18. ### Claude Code
  19. ```text
  20. /plugin marketplace add referodesign/refero_skill
  21. /plugin install refero@refero
  22. ```
  23. ### Gemini CLI
  24. ```bash
  25. gemini extensions install https://github.com/referodesign/refero_skill
  26. ```
  27. ### Cursor
  28. After the marketplace listing is approved, open Cursor's plugin marketplace or run
  29. `/add-plugin` and search for **Refero**.
  30. ### Standalone skill
  31. Use this when the client already has Refero MCP configured or only the design methodology
  32. is needed:
  33. ```bash
  34. npx skills add https://github.com/referodesign/refero_skill --skill refero-design
  35. ```
  36. No account is required for the bundled craft references. Live Refero research uses OAuth
  37. when the MCP client first connects to `https://api.refero.design/mcp`.
  38. ## What it does
  39. 1. Researches visual styles first, then real screens and user flows when the task needs them.
  40. 2. Extracts concrete patterns and locks references before implementation.
  41. 3. Applies bundled guidance for typography, color, spacing, motion, icons, and copywriting.
  42. 4. Keeps design decisions tied to evidence instead of generic AI defaults.
  43. 5. Checks substantial visual work against the selected direction before handoff.
  44. ## What is included
  45. - `skills/refero-design/` — the single canonical skill and its references.
  46. - `.mcp.json` — Refero MCP for Codex and Claude Code plugin installs.
  47. - `mcp.json` — Refero MCP for Cursor plugin installs.
  48. - `gemini-extension.json` — Gemini CLI extension manifest.
  49. - `.codex-plugin/`, `.claude-plugin/`, and `.cursor-plugin/` — platform metadata.
  50. - `server.json` — official MCP Registry metadata.
  51. All connection manifests use the same production endpoint and contain no access tokens.
  52. ## Existing standalone installations
  53. Older clones placed `SKILL.md` at the repository root. Remove that old installation and
  54. run the standalone install command again. The current skill lives at
  55. `skills/refero-design/SKILL.md`; keeping both layouts creates duplicate skills.
  56. For manual installation, copy the entire `skills/refero-design/` directory into the
  57. client's skills directory so its `references/` files remain beside `SKILL.md`.
  58. ## Validate a release
  59. ```bash
  60. scripts/check-release
  61. ```
  62. The check validates manifests, versions, local links, the canonical MCP URL, package
  63. boundaries, and common secret leaks. Platform-native validation and clean-profile install
  64. tests are still run before tagging a release.
  65. ## Security
  66. Report vulnerabilities privately to [support@refero.design](mailto:support@refero.design).
  67. See [SECURITY.md](SECURITY.md) for details.
  68. ## License
  69. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.