スキルOfficialproductivity

🔗show-airtable-link

プラグイン: airtable
ライセンス: MIT
ソース: GitHub で見る ↗

説明

エージェントがユーザーに見えるAirtableのコンテンツに触れた際に、クリック可能なAirtableリンクを提供します。次のような場合に使用: レコード・スキーマ・インターフェースページ（ベース、テーブル、フィールド、レコード、ページ）の作成・更新・一覧取得・検索・返却を行うすべてのMCPコール実行後。エージェントのツールコールでアクセスが確認できた中で、最も詳細なURLを渡してください。優先順位は以下の通りです: - テーブルURLよりシングルレコードURL - ベースURLよりテーブルURL - ユーザーのアクセスがページに限定されている場合はインターフェースページURL 説明的なラベルを付けたMarkdownリンクとしてフォーマットしてください。URLの構築には、ツールが実際に返したIDのみを使用し、URLを補完するためにIDを推測・合成しないでください。このSkillは、Airtableのコンテンツに影響を与えるあらゆるワークフローSkillに組み込んでください。

原文を表示

Provides a clickable Airtable link whenever the agent has touched user-visible Airtable content. Use after every MCP call that creates, updates, lists, searches, or returns records, schema, or interface pages — bases, tables, fields, records, or pages. Hand off the most-specific URL the agent's tool calls have proven access to — prefer single-record URLs over table URLs, table URLs over base URLs, and interface page URLs when the user's access is restricted to pages. Format as a markdown link with a descriptive label. Construct URLs only from IDs the tools actually returned — never synthesize IDs to round out a URL. Compose this skill from any workflow skill that affects Airtable content.

ユースケース

✓レコード作成・更新後にリンク提供する
✓テーブル・ベース検索結果の詳細URLを返す
✓ページアクセス確認時にインターフェースページURL共有
✓スキーマ・フィールド操作後にコンテンツ確認

本文（日本語訳）

Airtableリンクを表示する

ユーザーが目視できるAirtableのコンテンツに影響するMCP呼び出しの後、その呼び出し結果がユーザーにアクセス権を与える最も詳細な画面へのクリッカブルリンクを返してください。このリンクは、ユーザーがagentの作業内容を確認するための手段です。リンクがなければ、ユーザーが自分で探しに行くまで作業結果は見えないままになります。

URLテンプレート

すべてのURLは、tool呼び出しが実際に返したIDから構築します。 viw*・tbl*・rec*・pag* などのIDスロットは、toolレスポンスに含まれていなかったものは使用しないでください。

画面	URLパターン
ワークスペース	`https://airtable.com/workspaces/<wspId>`
ベース	`https://airtable.com/<appId>`
ベースのインターフェースハブ	`https://airtable.com/<appId>/interfaces`
テーブル	`https://airtable.com/<appId>/<tblId>`
レコード（テーブルコンテキスト）	`https://airtable.com/<appId>/<tblId>/<recId>`
インターフェースページ	`https://airtable.com/<appId>/<pagId>`
レコード（ページコンテキスト）	`https://airtable.com/<appId>/<pagId>/<recId>`

IDのプレフィックス: wsp（ワークスペース）、app（ベース）、tbl（テーブル）、pag（インターフェースページ）、rec（レコード）、fld（フィールド）。 URLはMCPレスポンスに含まれるIDをそのまま使用して構築してください。小文字化・変換・推測は行わないこと。

優先順位

作業内容が許す限り、最も詳細な URLを渡してください。

単一レコード — 作業が1件のレコードを対象としていた場合。get_record_for_page がそのレコードを返していればページコンテキストのURLを、そうでなければテーブルコンテキストのURLを使用します。
インターフェースページ — 作業がページにスコープされていた場合（ページの読み取り・一覧取得）。
テーブル — 複数レコードへの操作やスキーマ変更（テーブル・フィールドの作成・更新）の場合。レコードを一件ずつ列挙せず、テーブルへのリンクを一度だけ示してください。
ベース — 最終手段: 作成直後のベース、ベース全体のスキーマ操作、またはこれ以上詳細に指定できる対象がない場合。

複数レコードの結果で「最適な一件」が明確でない場合は、テーブルまたはページへのリンクを一度だけ示してください。レコードごとにリンクを生成するのはスパムになるため、行ってはいけません。

権限を考慮したリンク渡し

MCPユーザーの認証情報によって、どのtoolが成功するかが決まります。呼び出しの一連の流れで実際にアクセスが確認できた画面に対してのみ、URLを渡してください。

ページ制限ユーザー: list_pages_for_base・list_records_for_page・get_record_for_page のみ成功している場合。ページURLのみを渡してください。ユーザーが開けない tbl* URLを合成すると、そのユーザーにとってはデッドリンクになります。
テーブルレベルのアクセス: list_tables_for_base・get_table_schema・list_records_for_table・update_records_for_table が成功している場合。テーブルURLは安全に使用できます。
ワークスペースレベルのアクセス: list_workspaces がIDを返している場合。ワークスペースURLは安全に使用できます。

基本ルール: tool呼び出しでアクセス可能と証明されていない画面へのリンクは作成しないでください。迷った場合は、詳細度を一段階下げて、アクセスが確認できている画面にリンクしてください。

表示形式

説明的なラベルを付けたMarkdownリンク。 Claude Code・Cowork・Codex・Claude.aiはいずれもこの形式をレンダリングします。ベアURLもレンダリングされますが、可読性が落ちます。
- 良い例: [Sales Pipeline base](https://airtable.com/appEXAMPLEbase001)
- 許容例: View in Airtable: [Sales Pipeline](https://airtable.com/appEXAMPLEbase001) — Airtable既存の内部リンク渡しラベルに合わせた形式
- 悪い例: https://airtable.com/appEXAMPLEbase001 — コンテキストのないベアURL
レスポンスにつきリンクは1つ。 複数ステップの操作では、各tool呼び出しの後ではなく、最後にまとめて1つのリンクを示してください。
リッチな埋め込みは使用しない。 インラインチャット画面は現時点でAirtable URLのOpenGraphカードをレンダリングしません。ホスト側が表示しない機能を前提にレスポンスを構成しないでください。

アンチパターン

IDを合成しないこと。 URLに含まれるすべてのIDは、toolレスポンスからそのまま取得したものでなければなりません。viw*・tbl*・rec*・pag* やその他の識別子をURLを完成させるために捏造しないでください。tool呼び出しがそのIDを返していなければ、そのURLスロットには実在するターゲットがありません。
?home=<pagId> などのクエリパラメータを含めないこと。 ページ管理モード（/build・/edit・/preview）はページ作成者向けのものであり、チャットからのリンク渡しには使用しません。

他のskillとの組み合わせ

Airtableのコンテンツを作成・変更・返却するワークフロー系・方法論系のskillは、リンク渡し時にこの規約を組み合わせて使用してください。 URL構築をインラインで再実装しないでください。

他のskillの本文から参照する場合:

「作業完了後、show-airtable-link skillを通じてクリッカブルリンクを返してください。agentのtool呼び出しでアクセスが証明されている最も詳細なURLを渡してください。」

使用例

プロダクトロードマップ用の新しいベースを作成した場合:

ロードマップ・フィードバック・リリースの3つのテーブルを含むロードマップベースを作成しました。

View Roadmap base in Airtable

12件のレコードのStatusフィールドを更新した場合:

12件のレコードのStatusを「In Review」に更新しました。

View Roadmap table in Airtable

インターフェースページから1件のレコードを取得した場合（ページ制限ユーザー）:

一致する案件が見つかりました: Acme Corp、$50k、ステージ = Negotiation。

View record in Sales pipeline

原文（English）を表示

Show Airtable link

After any MCP call that affects user-visible Airtable content, return a clickable link to the most-specific surface the call's results give the user access to. The link is how the user reviews the agent's work — without it, the work is invisible until they go hunting for it.

URL templates

All URLs are built from IDs the tool calls actually returned. Don't include any ID slot — viw*, tbl*, rec*, pag*, etc. — that wasn't in a tool response.

Surface	URL pattern
Workspace	`https://airtable.com/workspaces/<wspId>`
Base	`https://airtable.com/<appId>`
Base interfaces hub	`https://airtable.com/<appId>/interfaces`
Table	`https://airtable.com/<appId>/<tblId>`
Record (table context)	`https://airtable.com/<appId>/<tblId>/<recId>`
Interface page	`https://airtable.com/<appId>/<pagId>`
Record (page context)	`https://airtable.com/<appId>/<pagId>/<recId>`

ID prefixes: wsp (workspace), app (base), tbl (table), pag (interface page), rec (record), fld (field). Construct URLs using IDs verbatim from MCP responses — do not lowercase, transform, or guess them.

Priority order

Hand off the most-specific URL the work allows:

Single record — when the work targeted one record. Use the page-context URL if get_record_for_page returned the record; otherwise the table-context URL.
Interface page — when the work was scoped to a page (page reads / listings).
Table — for multi-record work or schema changes (created / updated tables, fields). Don't list every record back; link the table once.
Base — last resort: just-created base, base-wide schema operation, or when nothing more specific applies.

For multi-record results without one obvious "best" record, link the table or page once. Do not produce a link per record — that's spam.

Permission-aware handoff

The MCP user's auth determines which tools succeed. Hand off URLs only at access surfaces the call sequence has proven:

Page-restricted users: only list_pages_for_base, list_records_for_page, get_record_for_page succeeded. Hand off page URLs only — synthesizing a tbl* URL the user can't open produces a dead link from their perspective.
Table-level access: list_tables_for_base, get_table_schema, list_records_for_table, update_records_for_table succeeded. Table URLs are safe.
Workspace-level access: list_workspaces returned IDs. Workspace URLs are safe.

Standing rule: if a tool call didn't prove the access surface, don't link to it. When in doubt, drop one specificity level and link the surface you do have.

Presentation

Markdown link with a descriptive label. Every host (Claude Code, Cowork, Codex, Claude.ai) renders these. Bare URLs render too but read worse.
- Good: [Sales Pipeline base](https://airtable.com/appEXAMPLEbase001)
- Acceptable: View in Airtable: [Sales Pipeline](https://airtable.com/appEXAMPLEbase001) — matches Airtable's existing internal handoff label
- Bad: https://airtable.com/appEXAMPLEbase001 — bare URL with no context
One link per response. For multi-step operations, consolidate at the end rather than after each tool call.
No rich embeds. Inline chat surfaces don't render OpenGraph cards for Airtable URLs today. Don't structure responses around something the host won't draw.

Anti-patterns

Don't synthesize IDs. Every ID in the URL must come verbatim from a tool response. Don't fabricate viw*, tbl*, rec*, pag*, or any other identifier to round out a URL — if your tool calls didn't return that ID, the URL slot it'd fill doesn't have a real target.
Don't include ?home=<pagId> or other query params. Page-management modes (/build, /edit, /preview) are for page authors, not handoffs from chat.

Composition

Workflow and methodology skills that create, modify, or return Airtable content should compose this convention at handoff time. Don't re-implement URL construction inline.

In another skill's body:

"After completing the work, return a clickable link via the show-airtable-link skill. Hand off the most-specific URL the agent's tool calls have proven access to."

Examples

Created a new base for product roadmap:

Created your roadmap base with three tables — Roadmap, Feedback, and Releases.

View Roadmap base in Airtable

Updated 12 records' Status field:

Updated Status to "In Review" on 12 records.

View Roadmap table in Airtable

Returned one record from an interface page (page-restricted user):

Found the matching deal: Acme Corp, $50k, Stage = Negotiation.

View record in Sales pipeline

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