# action-creator

The action-creator skill builds personal action templates for email workflows. Use it when recurring tasks need a user-triggered action in the chat interface.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 19 installs · ★ 2818 repo stars
- Author: anthropics · official Anthropic repository
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/anthropics/claude-agent-sdk-demos/tree/HEAD/email-agent/agent/.claude/skills/action-creator/SKILL.md
- Updated: 2026-08-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/action-creator

## What it does

\`action-creator` generates TypeScript files under `agent/custom_scripts/actions/` for recurring, user-specific email workflows. Each file exports a `config` object with metadata and parameter rules, plus a `handler` that runs the operation through `ActionContext`.

The available context covers email lookup, message retrieval, archiving, labels, sending mail, notifications, logging, and agent calls. A handler returns an `ActionResult` with a success flag and a human-readable message. Templates can target cases such as payment reminders, bug forwarding, or newsletter cleanup.

The template code imports types from `../types` and depends on `ActionContext`; without that context, its email and notification operations cannot run.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-agent-sdk-demos --skill action-creator -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/action-creator/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/action-creator/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-agent-sdk-demos --skill action-creator -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/action-creator/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-agent-sdk-demos --skill action-creator -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/action-creator/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install anthropics/claude-agent-sdk-demos email-agent/agent/.claude/skills/action-creator
```

2. **Manually: put the files in place**
- File: `.github/skills/action-creator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-agent-sdk-demos --skill action-creator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/anthropics/claude-agent-sdk-demos --path email-agent/agent/.claude/skills/action-creator
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/action-creator/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-agent-sdk-demos --skill action-creator -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/anthropics/claude-agent-sdk-demos/tree/HEAD/email-agent/agent/.claude/skills/action-creator/SKILL.md

## When to use it
- create a payment reminder action for a specific customer
- forward bug reports to an engineering team
- archive newsletters from selected senders
- define parameters for a repeatable email workflow

## Example prompts
- Create an action that sends payment reminders to a specific customer.
- Build a template that forwards bug reports to the engineering team.
- Add an action for archiving older newsletters from selected senders.

## Similar
- [email-action-extractor](https://affpapa.org/en/nevibecode/skills/email-action-extractor.md) — skill · 1 install
- [safe-action-middleware](https://affpapa.org/en/nevibecode/skills/safe-action-middleware.md) — skill · 1200 installs
- [safe-action-client](https://affpapa.org/en/nevibecode/skills/safe-action-client.md) — skill · 1300 installs
- [newsletter-creator](https://affpapa.org/en/nevibecode/skills/newsletter-creator.md) — skill · 140 installs
- [Gmail](https://affpapa.org/en/nevibecode/mcp/gmail-gmail.md) — MCP server · 57738 installs
- [meeting-action-items](https://affpapa.org/en/nevibecode/skills/meeting-action-items.md) — skill · 162 installs

From the same set: [anthropics/claude-agent-sdk-demos](https://affpapa.org/en/nevibecode/by/anthropics/claude-agent-sdk-demos.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
