Revelica

Revelica Skills

Revelica のプラグインパッケージは、顧客調査、競合分析、目標、ベット、プロダクト仕様などの共有プロダクトコンテキストにエージェントを接続します。このパッケージでは、Revelica MCP サーバーと、最初に使える 3 つのスキルを宣言します。ワークフローの全体はサーバー上にあり、サーバーは各作業に適したスキルを手順の中で指定し、load_skill で読み込みます。

プラグインは 1 つで、plugins/revelica/ にあります。各ホスト用のマニフェストはその隣にあります。各ホストのカタログはリポジトリのルートにあり、ホストはそこでカタログを探します。インストールと OAuth のサポート状況はクライアントによって異なります。

リポジトリの構成

revelica/skills
├── plugins/revelica/            # The plugin, shared by every host
│   ├── .claude-plugin/          # Claude plugin manifest and icon
│   ├── .codex-plugin/           # OpenAI (ChatGPT and Codex) plugin manifest
│   ├── .mcp.json                # The Revelica MCP server
│   ├── skills/                  # Starting skills (also slash commands in Claude Code)
│   └── assets/                  # Brand icons
├── .claude-plugin/marketplace.json   # Claude Code marketplace catalog
├── .agents/plugins/marketplace.json  # Codex marketplace catalog
├── server.json                  # MCP registry manifest (registry.modelcontextprotocol.io)
├── scripts/package-openai.sh    # Exports the portable ZIP for OpenAI's plugin portal
├── REVIEWING.md                 # Test setup for directory reviewers
└── LICENSE                      # Apache-2.0

プラットフォーム別のインストール

Claude Code

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

プラグインには、最初に使えるスキルと MCP サーバーの設定が含まれています。ワークスペースのツールを使う前に、クライアントでサーバー接続を認証してください。

Cowork

組織の設定で、https://api.revelica.com/mcp をカスタムコネクターとして追加してください。 サーバーの手順では各作業に適したスキルを指定し、list_skills で残りのスキルを一覧表示できます。

Codex

codex plugin marketplace add revelica/skills
codex plugin add revelica@revelica

ChatGPT では、プラグインディレクトリに表示されたら Revelica をインストールしてください。

その他のクライアント

Cursor、Gemini CLI、および OAuth を使った Streamable HTTP に対応するその他のクライアントは、サーバーに直接接続できます（MCP サーバーへの直接接続を参照）。プラグインを提供し、テストしているのは Claude と OpenAI のホストのみです。リリース 1.10.1 では、誰もテストしていなかった Cursor と Gemini のマニフェストを削除しました。

最初に使うプロンプト

このプラグインでは、Revelica アプリが提供するものと同じ、最初に使える 3 つのスキルを追加します。Claude Code では、それぞれをスラッシュコマンドとしても使えます。

スキル	機能
/revelica:drive-product-outcome	目標達成に向けた作業を計画します。目標、その測定指標、進行中のベットとその根拠を確認し、次のアクションを提案して、作業として計画します。その過程で、ワークスペースに不足しているものがあれば用意します。
/revelica:ingestion	インサイトをナレッジグラフに追加します。URL、ファイル、メモをプロダクトの根拠として保存し、次に役立つ作業を選びます。
/revelica:interview-snapshot	顧客インタビューを分析します。文字起こしからスナップショットと、解決する価値のある顧客の課題を作成します。

プラグインの接続先と送信内容

このプラグインは、お使いのマシン上でコードを実行しません。リモート MCP サーバー https://api.revelica.com/mcp（Streamable HTTP）を 1 つ宣言し、一般的な作業を始めるための Markdown スキルを同梱しています。

• サインイン： 動的クライアント登録を使う OAuth 2.0 で、クライアントが処理します。プラグインがお使いのマシンから認証情報、トークン、ファイルを読み取ることはありません。
• 送信する内容： エージェントが実行するツール呼び出し（query、read、create、update、load_skill、list_skills）とその引数です。引数には、ワークスペースへの保存を依頼したプロダクトデータが含まれます。
• 受信する内容： お使いの Revelica ワークスペースのレコードと、スキルの手順です。

それ以外の情報は、どこにも送信されません。Revelica によるデータの取り扱いについては、プライバシーポリシーをご覧ください。

利用可能な MCP ツール

以下のツールは Revelica MCP サーバーから提供され、どのスキルからでも呼び出せます。

ツール	説明
query	条件に基づいてワークスペースを検索または絞り込みます。artifact_type を設定すると、ランク付けされた一致項目とスキーマテンプレートを返します。
read	ID を指定して単一の成果物またはエンティティ全体を読み取るか、ドット区切りのフィールド path を使ってサブツリーに移動します。
create	新しい成果物またはエンティティを作成します。コンテンツは登録済みのスキーマに照らして検証されます。
update	ドットパス表記を使って、フィールド単位の部分更新を適用します。
load_skill	サーバーのスキルの手順、その準備状況、およびスキルが開始時に参照するレコードの概要を読み込みます。これ自体がプレイブックを実行するわけではありません。
list_skills	読み込み可能なスキルを、それぞれの名前、説明、必要な入力とともに一覧表示します。

すべてのツールで OAuth 認証が必要で、Supabase の行レベルセキュリティが適用されるため、ユーザーには自身のワークスペースのデータのみが表示されます。

スキル

プロダクトのワークフローは、接続先の Revelica MCP サーバーにあるスキルです。drive-product-outcome、frame-bet、write-product-spec、design-experiment、product-for-coding-agents などがあります。どの作業にどのスキルが適しているかはサーバーの手順で示され、list_skills で接続中のユーザーが利用できるスキルの全カタログを確認できます。

Idea はプロダクト仕様です。そのストーリーマップ、構造化ドキュメント、Markdown は、同じ仕様を表現したものです。

スキルを読み込むと、現在のエージェントは利用可能なツールを使ってワークフローに従えるようになりますが、サーバー側のプレイブックが開始されるわけではありません。これらのツールベースのワークフローでは、ホスト側で skills-over-MCP 拡張機能を実装する必要はありません。

更新

製品ワークフローの手順は Revelica サーバーに保存されるため、アプリと接続されたエージェントは同じ正規のワークフローを検出できます。このパッケージに含まれる3つのスキルは、起動するサーバースキルと同じ名前と説明を持ち、load_skill を使ってサーバーからワークフロー全体を読み込むため、ワークフローと報告されるワークスペースの準備状況は常に最新です。リリース1.9.0では、同梱されていた use-revelica と product-for-coding-agents のルーターを削除しました。サポート対象のすべての Claude ホストで、同じルーティングを含むサーバーの手順が表示されます。

リリース1.10.0では、プラグインを plugins/revelica/ に移動し、すべてのホストで利用できるようコマンドをスキルに変更し、OpenAI マニフェストを追加しました。server.json を含むすべてのマニフェストのバージョンと、MCP サーバーが報告する SERVER_VERSION 定数（scryfast の revelica_agents/app/mcp_server/server.py）をまとめて更新してください。リリース名は Revelica X.Y.Z とし、リリースノートには対象プラットフォームを記載してください。バージョンはホストごとではなく Revelica に紐づきます。プラットフォーム固有の変更も同じバージョンを共有します。たとえば、Revelica 1.10.4では、Codex プラグインのメタデータと、Codex および ChatGPT 向けのポータブルなパッケージングを追加しています。

パッケージの更新とサーバーのデプロイは別々です。新たに文書化されたサーバーワークフローは、接続されたクライアントが読み込めるようになる前にデプロイする必要があります。このパッケージをインストールしても、サーバーの変更はデプロイされません。

bash scripts/package-openai.sh を実行すると、OpenAI の提出ポータル向けに dist/revelica-openai-<version>.zip が作成されます。Codex マニフェストの掲載情報フィールドを、ポータブルなルートの plugin.json にある extensions.com.openai.interface としてエクスポートし、.mcp.json は Streamable HTTP トランスポート名を使用する mcp.json としてエクスポートします。審査用のケースと公開メタデータは保持されます。共有プラグインの Claude および Codex 互換性マニフェストは、この公開アップロードには含まれません。 パッケージの検証だけでは、ポータルで必要な審査担当者のアクセス、デモ、対象国の指定、スキャン、証明は完了しません。

エクスポーターは既存のアーカイブを上書きしません。検証用にビルドする場合は、新しいパスを指定してください。bash scripts/package-openai.sh --output /tmp/revelica-check.zip。ZIP エントリのタイムスタンプとアクセス許可は固定されるため、同じ Python/zlib ツールチェーンを使うビルドでは同一のバイト列が生成されます。パッケージングのチェックは python3 -m unittest discover -s scripts/tests -v で実行してください。

審査用にアップロードした ZIP の完全なコピーを1つ、非公開で保管してください。dist/ は引き続き無視されます。審査担当者のアカウント情報、録画、提出に関するメモは、この公開リポジトリの外に保管してください。公開マニフェストには再利用可能なテストケースが含まれています。アップロードの準備時には、提出に固有のワークスペース手順と録画のメタデータを非公開で用意してください。新たにエクスポートしたファイルは、最初にアップロードしたファイルの代わりにはなりません。

plugins/revelica/skills/ 内のスキルは、同じ名前を持つサーバースキル（scryfast の revelica_agents/app/agents/revelica/skills/）の名前、説明、開始時のプロンプトを引き継ぎます。これらに変更があった場合は、内容を一致させてください。

MCP サーバーに直接接続する

プラグインを使わずにサーバーへ接続する場合は、リモート MCP サーバー／カスタムコネクターとして追加してください。

サーバー URL	https://api.revelica.com/mcp
トランスポート	Streamable HTTP
認証	動的クライアント登録を使用する OAuth 2.0 のため、管理が必要な API キーはありません
前提条件	Revelica ワークスペース（サインアップ）

サーバーのメタデータは /.well-known/mcp/server-card.json で公開されています。

プライバシーポリシー

Revelicaのプライバシーポリシーでは、収集するデータ、その使用方法と保存方法、第三者との共有、保持期間、お問い合わせ方法について説明しています。revelica.com/privacyで公開されています。利用規約はrevelica.com/termsをご覧ください。

MCP サーバーは、お客様自身のRevelicaワークスペース内の商品データのみを読み書きします。すべてのリクエストはOAuthで認証され、Supabaseの行レベルセキュリティによって制御されるため、接続されたエージェントが別のワークスペースのデータを見ることはありません。サーバーはチャット履歴、会話の要約、ファイルを照会しません。

サポート

• ディレクトリへのプラグイン掲載を審査する場合： REVIEWING.mdをご覧ください。

• プラグインに関する問題： GitHubのissueを作成

• アカウント、ワークスペース、MCP サーバーに関する問題： [email protected]

ライセンス

Apache-2.0 © Revelica

Revelicaについて

Revelicaは、AIネイティブなプロダクトディスカバリープラットフォームです。プロダクトチームが顧客のインサイトを収集し、競合分析を行い、アイデアを実験的に検証して、AI開発ワークフローに反映できるよう支援します。

🔗 無料のProトライアル付きホームページ：https://revelica.com

🔗 プレイブック、スキル、インサイトテンプレートを掲載したテンプレートライブラリ：https://revelica.com/templates

🔗 登録不要の無料AIツール：https://revelica.com/tools