refero
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.
Badge for your README
Markdown
[](/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)
- {
- "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
- "name": "refero",
- "description": "Refero design research skill and read-only MCP tools.",
- "owner": {
- "name": "Refero",
- "email": "support@refero.design"
- },
- "plugins": [
- {
- "name": "refero",
- "source": "./",
- "description": "Research real product interfaces and design with evidence from Refero.",
- "version": "1.0.3",
- "author": {
- "name": "Refero",
- "email": "support@refero.design"
- },
- "homepage": "https://refero.design/mcp",
- "repository": "https://github.com/referodesign/refero_skill",
- "license": "MIT",
- "category": "design"
- }
- ]
- }
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)
- 
- # Refero
- Refero packages one design skill and one read-only MCP connection for AI design work.
- The skill makes research mandatory before implementation. With live Refero research, agents
- can use curated visual styles, 150,000+ real app screens, and 6,000+ user flows from
- well-designed products.
- ## Install
- ### 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
- ```bash
- 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
- ```text
- /plugin marketplace add referodesign/refero_skill
- /plugin install refero@refero
- ```
- ### Gemini CLI
- ```bash
- 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:
- ```bash
- 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 it does
- 1. Researches visual styles first, then real screens and user flows when the task needs them.
- 2. Extracts concrete patterns and locks references before implementation.
- 3. Applies bundled guidance for typography, color, spacing, motion, icons, and copywriting.
- 4. Keeps design decisions tied to evidence instead of generic AI defaults.
- 5. Checks substantial visual work against the selected direction before handoff.
- ## What is included
- - `skills/refero-design/` — the single canonical skill and its references.
- - `.mcp.json` — Refero MCP for Codex and Claude Code plugin installs.
- - `mcp.json` — Refero MCP for Cursor plugin installs.
- - `gemini-extension.json` — Gemini CLI extension manifest.
- - `.codex-plugin/`, `.claude-plugin/`, and `.cursor-plugin/` — platform metadata.
- - `server.json` — official MCP Registry metadata.
- All connection manifests use the same production endpoint and contain no access tokens.
- ## Existing standalone installations
- Older clones placed `SKILL.md` at the repository root. Remove that old installation and
- run the standalone install command again. The current skill lives at
- `skills/refero-design/SKILL.md`; keeping both layouts creates duplicate skills.
- For manual installation, copy the entire `skills/refero-design/` directory into the
- client's skills directory so its `references/` files remain beside `SKILL.md`.
- ## Validate a release
- ```bash
- scripts/check-release
- ```
- The check validates manifests, versions, local links, the canonical MCP URL, package
- boundaries, and common secret leaks. Platform-native validation and clean-profile install
- tests are still run before tagging a release.
- ## Security
- Report vulnerabilities privately to [support@refero.design](mailto:support@refero.design).
- See [SECURITY.md](SECURITY.md) for details.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.