Revelica Skills

Revelica's plugin package connects an agent to shared product context: customer research, competitive analysis, goals, bets and product specs. It bundles use-revelica as a general starting point and product-for-coding-agents as an implementation specialization. Product workflows are discovered and loaded from the connected Revelica MCP server with list_skills and load_skill.

The repository includes client-specific manifests and an Agent Skills directory. Installation, skill discovery and OAuth support depend on the client; these files do not establish support for the emerging skills-over-MCP extension in every host.

Repository Structure

revelica/skills
├── .claude-plugin/
│   ├── marketplace.json         # Claude Code marketplace catalog
│   ├── plugin.json              # Claude Code plugin manifest
│   └── mcp.json                 # MCP config for Claude Code plugin
├── .cursor-plugin/
│   └── plugin.json              # Cursor plugin manifest
├── skills/                      # Skill definitions (Agent Skills open standard)
│   ├── use-revelica/            # General starting point; loads server orientation
│   └── product-for-coding-agents/  # Coding-specific orientation
├── assets/                      # Brand icons (README, directory submissions)
├── server.json                  # MCP registry manifest (registry.modelcontextprotocol.io)
├── .mcp.json                    # MCP config for Cursor/Gemini
├── gemini-extension.json        # Gemini CLI extension manifest
└── LICENSE                      # Apache-2.0

Installation by Platform

Claude Code

/plugin marketplace add revelica/skills
/plugin install revelica@revelica

The plugin manifest points to the bundled orientation and MCP configuration. Authorize the server connection in your client before using workspace tools.

Cowork

Add https://api.revelica.com/mcp as a custom connector in your organization's settings. A connector connection is separate from installing this bundled orientation. Discover server workflows through list_skills and load_skill when the client exposes those tools.

Cursor

The .cursor-plugin/plugin.json manifest declares the skills/ directory and .mcp.json server configuration. Use the installation and authorization flow supported by your Cursor version.

Gemini CLI

gemini extensions install revelica/skills

The gemini-extension.json manifest declares the skills directory and MCP server configuration. Check that the installed client exposes both after authorization.

Available MCP Tools

These tools are provided by the Revelica MCP server and callable from any skill:

All tools require OAuth authentication and enforce Supabase RLS — users only see their own workspace's data.

Bundled orientation and server workflows

The bundled use-revelica is a thin bootstrap: it calls the connected server's load_skill for the server skill with the same name. Product workflow instructions stay on the server. The coding orientation adds implementation-specific guidance and is optional for general product work. Current task entries include frame-bet, write-product-spec and test-idea; use the live catalog to check availability.

An Idea is the product spec. Its story map, structured document and Markdown are representations of the same spec. The package does not bundle a second spec-authoring implementation.

The live list_skills response is authoritative for the connected server and user. Loading instructions lets the current agent follow a workflow using the available tools; it does not start a server-side playbook/DAG. These tool-based workflows do not require a host to implement the skills-over-MCP extension.

Updating skills

Keep client orientation and package configuration here. Maintain product workflow instructions on the Revelica server so the app and connected agents can discover the same canonical workflow. Add a bundled skill only when it serves a client-side purpose that cannot be covered by the orientation and server discovery.

Package updates and server deployments are separate. A newly documented server workflow must be deployed before a connected client can load it. Deploy the backend canonical skills (use-revelica, frame-bet, write-product-spec and test-idea) before releasing this package update. Do not assume installing this package deploys them.

Connecting the MCP Server Directly

If you'd rather connect the server without the plugin, add it as a remote MCP server / custom connector:

Server metadata is published at /.well-known/mcp/server-card.json.

Privacy Policy

Revelica's privacy policy — covering what data is collected, how it is used and stored, third-party sharing, retention, and how to contact us — is published at revelica.com/privacy. Terms of service are at revelica.com/terms.

The MCP server reads and writes only the product data in your own Revelica workspace. Every request is authenticated with OAuth and enforced by Supabase row-level security, so a connected agent can never see another workspace's data. The server does not query your chat history, conversation summaries, or files.

Support

• Issues with the plugin or skills: open a GitHub issue
• Account, workspace, or MCP server issues: ask@revelica.com

License

Apache-2.0 © Revelica

About Revelica

Revelica is an AI-native product discovery platform. It helps product teams gather customer insights, perform competitive analysis, and experimentally validate ideas that feed into their AI development workflow.

🔗 Homepage with free Pro trial: https://revelica.com

🔗 Template library with playbooks, skills, and insight templates: https://revelica.com/templates

🔗 Free AI tools with no signup required: https://revelica.com/tools