Skip to content

xmtplabs/xmtp-agent-examples / skills/creating-inline-actions

creating-inline-actions

Verified

Interactive button-based UI for XMTP agents following XIP-67. Use when creating menus, confirmation dialogs, selection options, or any button-based interaction. Triggers on inline actions, buttons, menus, or ActionBuilder.

FileKindSize
SKILL.mdskill md4.0 KB
rules/builder-create.mdmarkdown1.2 KB
rules/config-menus.mdmarkdown1.5 KB
rules/helpers-confirmation.mdmarkdown947 B
rules/helpers-selection.mdmarkdown1.1 KB

rules/builder-create.md

View on GitHub
---
title: Create action menus with ActionBuilder
impact: CRITICAL
tags: inline-actions, buttons, menus
---

## Create action menus with ActionBuilder

Use `ActionBuilder` to create interactive button menus.

**Basic menu:**

```typescript
import { ActionBuilder } from "../../utils/inline-actions";

await ActionBuilder.create("menu-id", "Choose an option:")
  .add("action-1", "Option 1")
  .add("action-2", "Option 2")
  .add("action-3", "Cancel")
  .send(ctx);
```

**With button styles:**

```typescript
import { ActionBuilder, ActionStyle } from "../../utils/inline-actions";

await ActionBuilder.create("confirm-delete", "Delete this item?")
  .add("confirm-yes", "Yes, Delete", ActionStyle.Danger)
  .add("confirm-no", "Cancel")
  .send(ctx);
```

**Register handlers:**

```typescript
import { registerAction } from "../../utils/inline-actions";

registerAction("action-1", async (ctx) => {
  await ctx.conversation.sendText("You selected Option 1!");
});

registerAction("action-2", async (ctx) => {
  await ctx.conversation.sendText("You selected Option 2!");
});
```

**Important:** Always register action handlers before sending menus, or handle unknown actions gracefully.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 321kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall