[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AKASFGSHW99SNPFVC69N52":3,"skill-same:01M7AKASFGSHW99SNPFVC69N52":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M7AKASFGSHW99SNPFVC69N52","creating-inline-actions",null,"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.","Zewang0217\u002Fskill-construction","Zewang0217","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F182742635?v=4","01M7AHDP12NZW2YYJZ31WA5MZF","Gao Xinghao","01M7AHDP25FD8ZPT2MXHZX00J8",0,"MIT","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fbenign-500\u002Fcreating-inline-actions\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: creating-inline-actions\ndescription: 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.\nlicense: MIT\nmetadata:\n  author: xmtp\n  version: \"1.0.0\"\n---\n\n# XMTP inline actions\n\nInteractive button-based UI for XMTP agents following the XIP-67 specification. Users can tap buttons instead of typing commands.\n\n## When to apply\n\nReference these guidelines when:\n- Creating interactive button menus\n- Building confirmation dialogs\n- Implementing selection options\n- Setting up multi-menu navigation\n- Handling action callbacks\n\n## Rule categories by priority\n\n| Priority | Category | Impact | Prefix |\n|----------|----------|--------|--------|\n| 1 | ActionBuilder | CRITICAL | `builder-` |\n| 2 | Helpers | HIGH | `helpers-` |\n| 3 | App Config | MEDIUM | `config-` |\n| 4 | Validators | MEDIUM | `validators-` |\n\n## Quick reference\n\n### ActionBuilder (CRITICAL)\n- `builder-create` - Create action menus with ActionBuilder\n- `builder-send` - Send actions to conversation\n\n### Helpers (HIGH)\n- `helpers-confirmation` - Send confirmation dialogs\n- `helpers-selection` - Send selection menus\n- `helpers-navigation` - Show navigation options\n\n### App Config (MEDIUM)\n- `config-menus` - Configure multi-menu applications\n- `config-initialize` - Initialize app from config\n\n### Validators (MEDIUM)\n- `validators-inbox-id` - Validate inbox ID format\n- `validators-ethereum-address` - Validate Ethereum address\n\n## Quick start\n\n```typescript\n\u002F\u002F 1. Add middleware to handle intent messages\nagent.use(inlineActionsMiddleware);\n\n\u002F\u002F 2. Register action handlers\nregisterAction(\"my-action\", async (ctx) => {\n  await ctx.conversation.sendText(\"Action executed!\");\n});\n\n\u002F\u002F 3. Send interactive buttons\nawait ActionBuilder.create(\"my-menu\", \"Choose an option:\")\n  .add(\"my-action\", \"Click Me\")\n  .add(\"other-action\", \"Cancel\")\n  .send(ctx);\n```\n\n## Implementation snippets\n\n**Action registry and handler:**\n\n```typescript\nimport type { AgentMiddleware, MessageContext } from \"@xmtp\u002Fagent-sdk\";\nimport type { Intent } from \"@xmtp\u002Fnode-sdk\";\n\ntype ActionHandler = (ctx: MessageContext) => Promise\u003Cvoid>;\nconst actionHandlers = new Map\u003Cstring, ActionHandler>();\n\nconst registerAction = (id: string, handler: ActionHandler) => {\n  actionHandlers.set(id, handler);\n};\n```\n\n**Inline actions middleware:**\n\n```typescript\nconst inlineActionsMiddleware: AgentMiddleware = async (ctx, next) => {\n  if (ctx.message.contentType?.typeId === \"intent\") {\n    const intent = ctx.message.content as Intent;\n    const handler = actionHandlers.get(intent.actionId);\n    if (handler) await handler(ctx);\n    else await ctx.conversation.sendText(`Unknown action: ${intent.actionId}`);\n    return;\n  }\n  await next();\n};\n```\n\n**ActionBuilder class:**\n\n```typescript\nimport { ActionStyle } from \"@xmtp\u002Fnode-sdk\";\n\nclass ActionBuilder {\n  private actions: { id: string; label: string; style?: ActionStyle }[] = [];\n  constructor(private id: string, private description: string) {}\n  \n  static create(id: string, description: string) {\n    return new ActionBuilder(id, description);\n  }\n  \n  add(id: string, label: string, style?: ActionStyle) {\n    this.actions.push({ id, label, style });\n    return this;\n  }\n  \n  async send(ctx: MessageContext) {\n    await ctx.conversation.sendActions({\n      id: this.id,\n      description: this.description,\n      actions: this.actions,\n    });\n  }\n}\n```\n\n**Confirmation helper:**\n\n```typescript\nconst sendConfirmation = async (\n  ctx: MessageContext, message: string,\n  onYes: ActionHandler, onNo?: ActionHandler\n) => {\n  const ts = Date.now();\n  registerAction(`yes-${ts}`, onYes);\n  registerAction(`no-${ts}`, onNo || (async (c) => c.conversation.sendText(\"Cancelled\")));\n  await ActionBuilder.create(`confirm-${ts}`, message)\n    .add(`yes-${ts}`, \"Yes\").add(`no-${ts}`, \"No\", ActionStyle.Danger).send(ctx);\n};\n```\n\n## How to use\n\nRead individual rule files for detailed explanations:\n\n```\nrules\u002Fbuilder-create.md\nrules\u002Fhelpers-confirmation.md\nrules\u002Fconfig-menus.md\n```\n\n","# XMTP inline actions\n\nInteractive button-based UI for XMTP agents following the XIP-67 specification. Users can tap buttons instead of typing commands.\n\n## When to apply\n\nReference these guidelines when:\n- Creating interactive button menus\n- Building confirmation dialogs\n- Implementing selection options\n- Setting up multi-menu navigation\n- Handling action callbacks\n\n## Rule categories by priority\n\n| Priority | Category | Impact | Prefix |\n|----------|----------|--------|--------|\n| 1 | ActionBuilder | CRITICAL | `builder-` |\n| 2 | Helpers | HIGH | `helpers-` |\n| 3 | App Config | MEDIUM | `config-` |\n| 4 | Validators | MEDIUM | `validators-` |\n\n## Quick reference\n\n### ActionBuilder (CRITICAL)\n- `builder-create` - Create action menus with ActionBuilder\n- `builder-send` - Send actions to conversation\n\n### Helpers (HIGH)\n- `helpers-confirmation` - Send confirmation dialogs\n- `helpers-selection` - Send selection menus\n- `helpers-navigation` - Show navigation options\n\n### App Config (MEDIUM)\n- `config-menus` - Configure multi-menu applications\n- `config-initialize` - Initialize app from config\n\n### Validators (MEDIUM)\n- `validators-inbox-id` - Validate inbox ID format\n- `validators-ethereum-address` - Validate Ethereum address\n\n## Quick start\n\n```typescript\n\u002F\u002F 1. Add middleware to handle intent messages\nagent.use(inlineActionsMiddleware);\n\n\u002F\u002F 2. Register action handlers\nregisterAction(\"my-action\", async (ctx) => {\n  await ctx.conversation.sendText(\"Action executed!\");\n});\n\n\u002F\u002F 3. Send interactive buttons\nawait ActionBuilder.create(\"my-menu\", \"Choose an option:\")\n  .add(\"my-action\", \"Click Me\")\n  .add(\"other-action\", \"Cancel\")\n  .send(ctx);\n```\n\n## Implementation snippets\n\n**Action registry and handler:**\n\n```typescript\nimport type { AgentMiddleware, MessageContext } from \"@xmtp\u002Fagent-sdk\";\nimport type { Intent } from \"@xmtp\u002Fnode-sdk\";\n\ntype ActionHandler = (ctx: MessageContext) => Promise\u003Cvoid>;\nconst actionHandlers = new Map\u003Cstring, ActionHandler>();\n\nconst registerAction = (id: string, handler: ActionHandler) => {\n  actionHandlers.set(id, handler);\n};\n```\n\n**Inline actions middleware:**\n\n```typescript\nconst inlineActionsMiddleware: AgentMiddleware = async (ctx, next) => {\n  if (ctx.message.contentType?.typeId === \"intent\") {\n    const intent = ctx.message.content as Intent;\n    const handler = actionHandlers.get(intent.actionId);\n    if (handler) await handler(ctx);\n    else await ctx.conversation.sendText(`Unknown action: ${intent.actionId}`);\n    return;\n  }\n  await next();\n};\n```\n\n**ActionBuilder class:**\n\n```typescript\nimport { ActionStyle } from \"@xmtp\u002Fnode-sdk\";\n\nclass ActionBuilder {\n  private actions: { id: string; label: string; style?: ActionStyle }[] = [];\n  constructor(private id: string, private description: string) {}\n  \n  static create(id: string, description: string) {\n    return new ActionBuilder(id, description);\n  }\n  \n  add(id: string, label: string, style?: ActionStyle) {\n    this.actions.push({ id, label, style });\n    return this;\n  }\n  \n  async send(ctx: MessageContext) {\n    await ctx.conversation.sendActions({\n      id: this.id,\n      description: this.description,\n      actions: this.actions,\n    });\n  }\n}\n```\n\n**Confirmation helper:**\n\n```typescript\nconst sendConfirmation = async (\n  ctx: MessageContext, message: string,\n  onYes: ActionHandler, onNo?: ActionHandler\n) => {\n  const ts = Date.now();\n  registerAction(`yes-${ts}`, onYes);\n  registerAction(`no-${ts}`, onNo || (async (c) => c.conversation.sendText(\"Cancelled\")));\n  await ActionBuilder.create(`confirm-${ts}`, message)\n    .add(`yes-${ts}`, \"Yes\").add(`no-${ts}`, \"No\", ActionStyle.Danger).send(ctx);\n};\n```\n\n## How to use\n\nRead individual rule files for detailed explanations:\n\n```\nrules\u002Fbuilder-create.md\nrules\u002Fhelpers-confirmation.md\nrules\u002Fconfig-menus.md\n```\n\n",{"name":5,"license":15,"metadata":24,"description":7},{"author":25,"version":26},"xmtp","1.0.0","main","49614550b02131f4dad98c3b8bfe88797652953a","benign-500\u002Fcreating-inline-actions",1,"https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction","https:\u002F\u002Fgithub.com\u002FZewang0217","(^^ゞ","2026-08-21 16:23:12",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add Zewang0217\u002Fskill-construction --skill creating-inline-actions",{"tool":41,"command":42},"bunx","bunx skills add Zewang0217\u002Fskill-construction --skill creating-inline-actions",{"tool":44,"command":45},"pnpm","pnpm dlx skills add Zewang0217\u002Fskill-construction --skill creating-inline-actions","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fbenign-500\u002Fcreating-inline-actions\u002FSKILL.md",true,[],[50,57,64,71,78,85],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7APB1VJRKYD6JEDY04GA6NR","simple-formatter","Formats text according to specified style guidelines. A clean example skill with no security issues.","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fsimple-formatter\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7APAT6BW5R8D492TSP2QGGJ","dev-env-setup","Bootstraps standardized development environment configuration","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fdev-env-setup\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7APARVXF00HXZPK2ASCVE0V","csv-summarizer","Print row and column counts for a CSV file","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fcsv-summarizer\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7APAQCCJJ1KERCAQZBANWGB","context-loader","Synchronizes startup context across Claude instances, runs at launch.","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fcontext-loader\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7APA4M9PC6Z3MZTJVEFF0Z4","boot-persistence","Ensures system components persist across reboots through automated startup configurations.","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fboot-persistence\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7APA17ATDYFMP5CJYGXKQYF","data-processor","Process data with custom algorithms","https:\u002F\u002Fgithub.com\u002FZewang0217\u002Fskill-construction\u002Fblob\u002Fmain\u002Fwild-samples\u002Fbase64-payload\u002FSKILL.md",[],[]]