Tuskway

Tuskway プラグイン

Claude Code、Cursor、Codex、Copilot CLI、Grok Build、OpenCode、Pi 向けのプラグインフォルダー plugins/tuskway です。Grok Bot では Cursor のインストール方法を使用します。

このプラグインは、ホスト型 MCP サーバー https://tuskway.com/mcp に接続します。サインインはクライアントで OAuth を使用します。このパッケージには、アクセストークン、フック、ルールファイル、サブエージェントは含まれていません。

9 つのワークフロースキルが plugins/tuskway/skills/ にあります。

インストール

このリポジトリからインストールします。Claude、Cursor、Codex のプラグインディレクトリには登録されていません。ホスト型サーバーは、公式 MCP Registry に com.tuskway/tuskway として登録されています。

エージェント	インストール	サインイン
Claude Code	/plugin marketplace add tuskway/plugin を実行し、次に /plugin install tuskway@tuskway を実行します	/mcp を実行し、plugin:tuskway:tuskway を選択します
Cursor（チーム）	Dashboard → Plugins & MCPs → Team Marketplaces → Import from Repo で https://github.com/Tuskway/plugin をインポートします。メンバーは Customize からインストールします。	Cursor のサインインプロンプト
Cursor（個人）	Customize → Add Marketplace → User スコープで Import from GitHub を選択し、Personal タブで Add を選択します。	Cursor のサインインプロンプト
Grok Bot	Cursor のインストール方法を使用します。Cursor からプラグインを同期するよう求められた場合は、GitHub 認証を完了します。	Cursor 経由
Codex	codex plugin marketplace add tuskway/plugin を実行し、次に codex plugin add tuskway@tuskway を実行します	codex mcp login tuskway
Copilot CLI	copilot plugin marketplace add tuskway/plugin を実行し、次に copilot plugin install tuskway@tuskway を実行します	/mcp auth tuskway
Grok Build	grok plugin install tuskway/plugin	/mcps を実行し、tuskway を選択して i を押します
OpenCode	npx skills add tuskway/plugin --agent opencode と opencode mcp add tuskway --url https://tuskway.com/mcp を実行します	opencode mcp auth tuskway
Pi	pi install git:github.com/tuskway/plugin と pi mcp add tuskway --url https://tuskway.com/mcp を実行します	pi mcp login tuskway
Gemini CLI	gemini extensions install https://github.com/Tuskway/plugin	Gemini のサインインプロンプト

クライアントのマーケットプレイス更新コマンドを使って更新します。Pi と OpenCode は、それぞれのインストールコマンドを再実行して更新します。

MCP

2 つのファイルで、サーバー名を tuskway、URL を https://tuskway.com/mcp と指定しています。

plugins/tuskway/mcp.json は Agent Plugins ドキュメントです。サーバーは streamable-http で、type と url のみを含みます。このスキーマは、auth や extensions を含むその他すべてのフィールドを拒否します。extensions を含むサーバーエントリーは Codex によって破棄されるため、このファイルでは OAuth を宣言していません。クライアントの MCP ログインを使ってサインインしてください。

.mcp.json は { "type": "http", "url": "https://tuskway.com/mcp" } です。Claude Code は type のない url を stdio として扱います。Cursor は mcp.json より先に .mcp.json を読み込みます。.cursor-plugin/plugin.json では mcpServers を ./.mcp.json に固定しています。

Codex では、onboardingSkill にパッケージ化された SKILL.md への ./ パスが必要です。両方の Codex マニフェストでは、これを ./skills/setup-tuskway/SKILL.md に設定しています。

ルートの package.json は "private": true であるため、npm publish を実行してもこのパッケージはアップロードされません。Pi は git リポジトリをインストールし、plugins/tuskway/skills を読み込みます。

server.json では、公式 MCP Registry 用に同じサーバーを指定しています。サーバー名は com.tuskway/tuskway で、https://tuskway.com/mcp 上のストリーミング可能な HTTP を使用します。gemini-extension.json と GEMINI.md は、リポジトリのルートにある Gemini CLI 拡張機能です。Gemini CLI ギャラリーに掲載するには、このリポジトリに GitHub トピック gemini-cli-extension を設定する必要もあります。

パッケージを確認する

node --test scripts/test-plugin.mjs
node scripts/sync.mjs --check
node scripts/validate.mjs
node scripts/package-limits.mjs
npm run build:openai-zip
node --test scripts/test-manifests.mjs scripts/test-build-claude.mjs evals/mock-tuskway.test.mjs evals/grade.test.mjs

sync.mjs --check はマニフェストのバージョンを比較します。バージョンを書き換えたり、タグを作成したりすることはありません。validate.mjs はスキルのフロントマター、ローカルのサイズ上限、リソースリンクを確認します。package-limits.mjs は、シンボリックリンク、サブモジュール、512 個を超えるファイル、または plugins/tuskway 内にある 256 KiB を超える画像以外のファイルがある場合に失敗します。sync-design-tuskway を含む 9 つすべてのスキルが必須です。evals/ は https://tuskway.com ではなく、モックサーバーに対してこれらのスキルを実行します。

npm run build:openai-zip は dist/tuskway-openai-<version>.zip を書き出します。アーカイブのルートには plugin.json、mcp.json、skills/、assets/ が含まれます。npm run build:openai-zip -- --folder <name> は同じルートを最上位ディレクトリ 1 つに配置し、同階層に別のエントリーを追加しません。ビルドでは Agent Plugins 1.0.0 のスキーマを検証し、各スキルのフロントマターの name がフォルダー名と一致することを確認し、認証情報のパターンに一致するファイルがある場合は失敗します。パッケージにはテスト用認証情報、レビュー担当者向けの手順、apps、.app.json は含まれません。

リリース

スキルまたは掲載情報を変更した場合は、すべてのマニフェストの version を更新します。node scripts/sync.mjs --check は、いずれかのマニフェストのバージョンが異なる場合に失敗します。

マージ済みコミットにタグを付け、そのタグをプッシュします。マニフェストのバージョンを使用してください。

git checkout main
git pull origin main
git tag vX.Y.Z
git push origin vX.Y.Z

タグのワークフローでは GitHub リリースを公開し、dist/tuskway-openai-X.Y.Z.zip を添付します。そのジョブで ZIP を添付できない場合は、同じファイルをリリースにアップロードしてください。アクセストークンを ZIP、README、CI ログに含めないでください。

リリースで server.json を変更した場合は、タグをプッシュした後、公式 MCP Registry に再公開してください。tuskway.com の DNS で認証した後、リポジトリのルートから mcp-publisher publish を実行し、com.tuskway/tuskway が新しいバージョンと一致するようにしてください。

OpenAI または Claude に申請する前に、Claude CLI がインストールされている場合は claude plugin validate ./plugins/tuskway を実行してください。パッケージのワークフローでは、ランナー上に claude がある場合にこのコマンドが実行されます。

Claude ディレクトリ

Claude のプラグインディレクトリで使用できるのは、Markdown、テキスト、JSON、YAML、および PNG、JPEG、GIF、WebP、ICO 形式の画像のみです。このリポジトリでは、他のプラットフォーム向けに assets/logo.svg と skills/sync-design-tuskway/scripts/drift.mjs を保持しています。

Claude 向けの配布物を公開するには、次を実行します。

npm run build:claude

これにより、不要なファイルを除いたコピーが dist/claude に書き出されます。そのツリーを Tuskway/plugin-claude にプッシュし、マニフェストと同じバージョンのタグを付けてください。

ライセンス

MIT