claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialdeployment

🔗third-party-integrations

プラグイン
valtown
ソース
GitHub で見る ↗

説明

次のような場合に使用: valが外部サービスと通信する場合 — Slack、Discord、Telegram、Stripe、GitHub、Gmail、Google Sheets、Postgres / Supabase / Upstash / Neon、ブラウザ自動化（Playwright、Browserbase、Kernel、Steel）、Webスクレイピング、PDF生成、プッシュ通知、RSS、またはその他のサードパーティAPI。 必要なワークフロー（Val Townガイドの取得、認証情報の入手、テスト、シークレットの保存）および利用可能なガイドのカタログをカバーします。

原文を表示

Use when a val talks to an external service — Slack, Discord, Telegram, Stripe, GitHub, Gmail, Google Sheets, Postgres/Supabase/Upstash/Neon, browser automation (Playwright, Browserbase, Kernel, Steel), web scraping, PDF generation, push notifications, RSS, or any other third-party API. Covers the required workflow (fetch the Val Town guide, get credentials, test, store secrets) and the catalog of available guides.

ユースケース

  • ✓外部サービスと通信するとき
  • ✓認証情報を設定するとき
  • ✓APIの動作をテストするとき
  • ✓シークレットを保存するとき

本文（日本語訳）

サードパーティ連携

valが外部サービスを使用する場合は、以下の手順に従ってください。 手順を省略したり、学習データの記憶だけを頼りに連携コードを書いたりしないでください。 Val Townのガイドには、プラットフォーム固有のパターンや必要な回避策が記載されており、学習データには含まれていない情報が含まれています。

ワークフロー

  1. 最初にVal Townのガイドを取得する。 ガイドは https://docs.val.town/guides/ 以下に配置されていますが、スラッグは必ずしもサービス名だけとは限りません。カテゴリ配下にグループ化されているもの（例: databases/neon-postgres/、browser-automation/kernel/）や、サブページに存在するもの（例: slack/agent/）もあります。 URLを推測せず、https://docs.val.town/sitemap-0.xml にあるdocsのサイトマップを取得してください（すべてのdocs URLが一覧されています）。対象サービスに対応する guides/… のエントリを見つけ、連携コードを書く前にそのページを取得してください。

  2. ユーザーが認証情報を取得できるよう支援する。 APIキーの作成ページへの直リンクや、OAuthセットアップの手順をステップごとに提供してください。ユーザーに自力で探させないでください。

  3. 最小限のスクリプトで接続をテストする。 機能を構築する前に、1件のレコードを返すだけのシンプルなfetch / SDK呼び出しで動作確認を行ってください。これにより、認証・セットアップの問題と機能上のバグを切り分けられます。

  4. シークレットはenv varに保存する。 値の読み出しには Deno.env.get("KEY_NAME") を使用し、必要なenv varをREADMEに記載してください。そうすることで、ユーザーや（valをリミックスした）他の人が何を設定すべきかを把握できます。 ユーザーが設定する必要のあるenv varを参照する際は、Val TownのenvVar編集画面への直リンク（プリフィル済み）を、以下の形式で独立した行に記載してください（リンクテキストで隠さず、URLをそのまま表示してください。これが行動を促す手がかりとなります）: 👉 KEY_NAME をここで追加: https://www.val.town/x/HANDLE/VAL_NAME/environment-variables?key=KEY_NAME

利用可能なガイド

現時点で専用ガイドが存在するサービス（網羅的ではないため、最新情報は手順1のサイトマップを参照してください）:

  • メッセージング / チャット: Slack、Discord、Telegram
  • 決済: Stripe
  • メール: Gmail（ユーザーアカウント経由での送信用。組み込みのメール送信には代わりに std/email を使用してください — email スキルを参照）
  • Google: Google Sheets
  • 外部データベース: Neon Postgres、Supabase、Upstash（SQLiteには組み込みの std/sqlite を使用してください — sqlite-storage スキルを参照）
  • ブラウザ自動化: Kernel（Playwrightに推奨）、Browserbase、Steel、Browserless
  • ソース管理 / Webhook: GitHub（webhookを含む）
  • コンテンツ / 出力: RSSフィード、PDF生成、Webスクレイピング
  • 通知: プッシュ通知
  • 認証: OAuthプロバイダー（Val Townアカウントでのログインには代わりに std/oauth を使用してください）

なぜこれが重要か

連携コードは、モデルがハルシネーションを起こしやすい場所の筆頭です。 APIは変化し、認証フローは見直され、プラットフォームの制約（ファイルシステムなし、サブプロセスなし）により、単純なアプローチは破綻します。 Val Townのガイドが、プラットフォーム上で現在動作するものに関する信頼できる情報源です。

原文（English）を表示

Third-Party Integrations

When a val uses any external service, follow this order — do not skip steps and do not write integration code from training-data memory alone. Val Town's guides have platform-specific patterns and required workarounds that won't be in your training data.

Workflow

  1. Fetch the Val Town guide first. Guides live under https://docs.val.town/guides/, but the slug isn't always just the service name — some are grouped under a category (e.g. databases/neon-postgres/, browser-automation/kernel/) or live on a sub-page (slack/agent/). Don't guess the URL: fetch the docs sitemap at https://docs.val.town/sitemap-0.xml (it lists every docs URL), find the guides/… entry that matches the service, and fetch that page before writing any integration code.
  2. Help the user get credentials. Provide direct links to create API keys or step-by-step OAuth setup instructions. Don't make the user hunt.
  3. Test the connection with a minimal script (a single fetch / SDK call that returns one record) before building features on top. This isolates auth/setup problems from feature bugs.
  4. Store secrets in env vars. Use Deno.env.get("KEY_NAME") to read them, and document the required env vars in the README so the user (or anyone remixing the val) knows what to set. Whenever you reference an env var the user needs to set, show the raw, full URL to the prefilled Val Town env var editor on its own line, in this exact format: 👉 Add KEY_NAME here: https://www.val.town/x/HANDLE/VAL_NAME/environment-variables?key=KEY_NAME. Keep the URL visible (not hidden behind link text) — it's the call-to-action.

Available guides

Services with dedicated guides today — not exhaustive, so use the sitemap from step 1 as the current source of truth:

  • Messaging / chat: Slack, Discord, Telegram
  • Payments: Stripe
  • Email: Gmail (for sending via a user's account; for built-in mail use std/email instead — see the email skill)
  • Google: Google Sheets
  • External databases: Neon Postgres, Supabase, Upstash (for SQLite use built-in std/sqlite instead — see the sqlite-storage skill)
  • Browser automation: Kernel (recommended for Playwright), Browserbase, Steel, Browserless
  • Source control / webhooks: GitHub (including webhooks)
  • Content / output: RSS feeds, PDF generation, web scraping
  • Notifications: push notifications
  • Auth: OAuth providers (for logging in with a Val Town account use std/oauth instead)

Why this matters

Integration code is the most common place models hallucinate. APIs change, auth flows get reworked, and platform constraints (no filesystem, no subprocess) break naive approaches. The Val Town guide is the source of truth for what currently works on the platform.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。