Val Town

Val Town のエージェントプラグイン

Claude Code、Codex、Cursor 向けに、Val Town MCP サーバーとスキルをインストールします。

スキルは、Val Town 上での開発方法をプラットフォームごとに説明する Markdown ファイルです。 Val Town 独自のツール（Townie、MCP サーバー）や、AI コーディングエージェントで使用されます。 スキルには、HTTP vals、cron、SQLite、メール、OAuth、フロントエンド、API 連携が含まれます。

インストール

プラグインをインストールすると、プラットフォームのスキルがエージェントで利用できるようになり、 ホストされた Val Town MCP サーバー（https://api.val.town/v3/mcp）が登録されます。MCP ツールを 初めて使用するとき、エージェントはブラウザーで OAuth フローを実行します。

1. Claude Code
2. Codex
3. Cursor

Claude Code

次のコマンドを実行して、Val Town プラグインをインストールします。

claude plugin install valtown@claude-plugins-official

Codex

codex CLI

まず、次のコマンドを実行します。

codex plugin marketplace add val-town/plugins

次に codex を起動して、次のコマンドを実行します。

/plugins

Val Town を検索してインストールすると、OAuth の手順が案内されます。

Codex デスクトップアプリ

1. サイドバーの「Plugins」をクリックします
2. 「Built by OpenAI」と表示されたドロップダウンで「Add more +」をクリックします
3. https://github.com/val-town/plugins をコピーして貼り付け、「Add marketplace」を選択します

Cursor

Cursor で、次のコマンドを実行します。

/add-plugin valtown

または、Cursor の設定で検索ボックスに https://github.com/val-town/plugins をコピーして貼り付け、「Add to Cursor」を選択します。

コントリビューション

スキルの作成

スキルは plugin/skills/<name>/SKILL.md にあり、YAML フロントマターを含みます。

---
name: http-endpoints
description: Use when building an HTTP val — a web endpoint, API route, webhook...
triggers: [http, endpoint, webhook, api, request, response]
---

# HTTP Endpoints

...guide body...

• name（必須）— ディレクトリ名と一致する必要があります。小文字、ハイフン使用、64 文字以内です。
• description（必須）— 「Use when…」の形式で記述します。Claude がスキルを読み込むかどうかを判断するために使われます。1024 文字以内です。
• triggers（任意）— searchSkills のランキングを高めるキーワードのヒントです。 Claude Code のネイティブローダーでは無視されます。

内容は 対象ユーザーに依存しないもの にしてください。すべての利用者に当てはまるプラットフォームの知識だけを含めます。製品の操作手順やチャット専用のアドバイスは含めないでください。

次に、ビルドします。

npm install
npm run build   # generate src/generated/skills.ts, then tsc
npm test        # build + smoke tests

npm run generate は、すべてのスキルを当社のスキーマと Claude Code のフロントマター制約の両方に照らして検証します。Claude Code で読み込めないスキルがあると、ビルドは失敗します。

Val Town モノレポとの関係

このパッケージがスキルコンテンツの信頼できる唯一の情報源です。Val Town アプリと MCP サーバーは独自のコピーを保持せず、依存関係としてこのパッケージを使用します。設計の詳細については、メインリポジトリの docs/SKILLS_PLUGIN.md を参照してください。

バージョン管理

このリポジトリでは、公開に Changesets を使用しています。詳しくはドキュメントを参照してください。

• 新しいバージョンを作成する変更ごとに、npx @changesets/cli を実行し、 対話形式のプロンプトに変更内容を入力してください。.changesets ディレクトリに新しい changeset が生成されます。
• このディレクトリ内の各変更によって、GitHub アクション release.yml が新しいリリース PR を作成します。
• リリース PR をマージすると、このモジュールの新しいバージョンが自動的に公開されます。

設定

Claude Code

公式の Claude プラグインマーケットプレイスは .plugins/marketplace.json から取得します。

Codex

Codex はネイティブのマーケットプレイス .agents/plugins/marketplace.json を読み込みます（互換性のため、Claude の .claude-plugin/marketplace.json にフォールバックします）。

Cursor

Cursor は .cursor-plugin/marketplace.json と、各プラグインの plugin/.cursor-plugin/plugin.json を読み込みます。