Agent skill

Playbooks

by vellum-ai in vellum-ai/vellum-assistant

Trigger-action automation rules for handling incoming messages

MITAuto-check passed

Install Playbooks

skills CLI
$ npx skills add vellum-ai/vellum-assistant --skill playbooks -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vellum-ai/vellum-assistant playbooks --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/assistant/src/config/bundled-skills/playbooks .claude/skills/playbooks && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
playbooks
GitHub stars
1.4k
Token cost
~363 tokens
SKILL.md length
150 words
Files
7
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Trigger-action automation rules for handling incoming messages

  • Works in 3 steps: Create a playbook with playbook_create… → List existing playbooks with… → Update rules with playbook_update or…
  • SKILL.md covers Structure, Lifecycle and Storage
  • Runs TypeScript scripts from its folder

What it does

Playbooks is an agent skill from vellum-ai/vellum-assistant. Trigger-action automation rules for handling incoming messages

Its SKILL.md is about 360 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files (for example `TOOLS.json`, `tools/playbook-create.ts` and `tools/playbook-delete.ts`). Compatibility notes: Designed for Vellum personal assistants

The repository describes itself as: An AI Assistant that’s easy to setup, does your work 24/7, knows your preferences and gets better over time. The licence is MIT.

Example prompts

  • “/playbooks”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): Designed for Vellum personal assistants

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Create a playbook with playbook_create specifying trigger and action.
  2. List existing playbooks with playbook_list, optionally filtering by channel or category.
  3. Update rules with playbook_update or remove them with playbook_delete.

What it can do on your machine

Read from SKILL.md and the folder at commit 33cc983. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (TypeScript), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Vellum personal assistants

    From compatibility in the SKILL.md frontmatter.

Context cost

Playbooks loads about 363 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 150 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~18
When it runs · the whole SKILL.md, loaded when a task matches
~363

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vellum-ai/vellum-assistant at commit 33cc983, republished under its MIT licence (© vellum-ai). 150 words, ~363 tokens.

Download SKILL.mdSave it as .claude/skills/playbooks/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
playbooks
description
Trigger-action automation rules for handling incoming messages
compatibility
Designed for Vellum personal assistants
metadata.emoji
📖

Playbooks are trigger-action automation rules that tell the assistant how to handle incoming messages matching a pattern.

Structure

Each playbook has:

  • Trigger: Pattern or description that activates the rule (e.g. "meeting request", "from:ceo@*")
  • Action: What to do when triggered (natural language description)
  • Channel: Which channel the rule applies to ("*" = all channels, or specific like "email", "slack")
  • Category: Free-form grouping label (e.g. "scheduling", "triage")
  • Autonomy level: How much autonomy the assistant has
    • auto -- execute immediately without asking
    • draft -- prepare a response for user review (default)
    • notify -- alert the user only
  • Priority: Numeric priority for overlapping rules (higher = takes precedence)

Lifecycle

  1. Create a playbook with playbook_create specifying trigger and action.
  2. List existing playbooks with playbook_list, optionally filtering by channel or category.
  3. Update rules with playbook_update or remove them with playbook_delete.

Storage

Playbooks are stored as memory items with semantic retrieval, enabling fuzzy matching of incoming messages against trigger patterns.

© vellum-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files in assistant/src/config/bundled-skills/playbooks of vellum-ai/vellum-assistant.

  • SKILL.md
  • TOOLS.json
  • icon.svg
  • tools/playbook-create.ts
  • tools/playbook-delete.ts
  • tools/playbook-list.ts
  • tools/playbook-update.ts

Open the folder on GitHubat commit 33cc983

Compare with similar skills

Playbooks next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Playbooks compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Playbooks this skillvellum-ai/vellum-assistant1.4k—~363Automated safety check: PassMIT
Messages Opsaffaan-m/ECC277k1 repos~724Automated safety check: PassMIT
ActionsJetBrains/intellij-community21k—~341Automated safety check: PassCustom licence
Laravel Actionscoollabsio/coolify63k—~2.4kAutomated safety check: PassApache-2.0
Channel Message Flowsopenclaw/openclaw392k—~306Automated safety check: PassMIT
Commit Message Storytellergithub/awesome-copilot40k1 repos~1.3kAutomated safety check: PassMIT

Similar skills

  • Messages Ops

    affaan-m/ECC

    Evidence-first live messaging workflow for ECC. An agent skill from affaan-m/ECC.

    277k GitHub starsUsed in 1 repo~724 tokens
    Productivity & AutomationAuto-check passed
  • Actions

    JetBrains/intellij-community

    Official

    Implement or change IntelliJ AnAction actions and registrations.

    21k GitHub stars~341 tokensUpdated today
    MobileAuto-check passed
  • Laravel Actions

    coollabsio/coolify

    Build, refactor, and troubleshoot Laravel Actions using lorisleiva/laravel-actions.

    63k GitHub stars~2.4k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Channel Message Flows

    openclaw/openclaw

    A skill your agent uses when running QA Lab channel message flow evidence.

    392k GitHub stars~306 tokensUpdated today
    Auto-check passed
  • Commit Message Storyteller

    github/awesome-copilot

    Official

    Analyzes git diffs or staged changes and generates narrative commit messages that explain WHY a change was made, not just what changed — following Conventional Commits format.

    40k GitHub starsUsed in 1 repo~1.3k tokens
    DevelopmentAuto-check passed
  • Actions

    BuilderIO/agent-native

    How to create and run agent actions. An agent skill from BuilderIO/agent-native.

    7.1k GitHub stars~4.5k tokensUpdated today
    Backend & APIsAuto-check passed

More from vellum-ai/vellum-assistant

All 108 skills in this repo
  • Vellum GitHub App Setup

    vellum-ai/vellum-assistant

    Create and configure a GitHub App so the assistant can push commits, open PRs, and comment under its own bot identity.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Discord App Setup

    vellum-ai/vellum-assistant

    Connect a Discord bot to the assistant via the Discord Gateway with guided application creation and intent configuration

    1.4k GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • Sentry App Setup

    vellum-ai/vellum-assistant

    Create and configure a Sentry internal integration so the assistant can manage issues, alerts, and releases under its own identity

    1.4k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Memory Corpus Ingest

    vellum-ai/vellum-assistant

    Ingest a large dataset into memory as a skimmed map. An agent skill from vellum-ai/vellum-assistant.

    1.4k GitHub stars~3k tokensUpdated yesterday
    Auto-check: notes
  • Plugin Builder

    vellum-ai/vellum-assistant

    A skill your agent uses when the user wants to build, scaffold, ship, or edit a Vellum plugin that bundles multiple surfaces (hooks, tools, skills, and more) into one installable package.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Slack App Setup

    vellum-ai/vellum-assistant

    Connect a Slack app to the Vellum Assistant via Socket Mode.

    1.4k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check: warnings

Questions about Playbooks

What does Playbooks do?

Trigger-action automation rules for handling incoming messages. Playbooks is an agent skill from vellum-ai/vellum-assistant.

How do I install Playbooks in Claude Code?

Run `npx skills add vellum-ai/vellum-assistant --skill playbooks -a claude-code`. Or copy the skill folder (assistant/src/config/bundled-skills/playbooks in vellum-ai/vellum-assistant) into .claude/skills/playbooks in your project. Claude Code loads it when a task matches its description.

How do I install Playbooks in Codex?

Run `npx skills add vellum-ai/vellum-assistant --skill playbooks -a codex`. Or copy the skill folder (assistant/src/config/bundled-skills/playbooks in vellum-ai/vellum-assistant) into .agents/skills/playbooks in your project. Codex loads it when a task matches its description.

Can I use Playbooks in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vellum-ai/vellum-assistant --skill playbooks -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/playbooks, .gemini/skills/playbooks, .github/skills/playbooks and .opencode/skills/playbooks in your project.

What does Playbooks need to run?

Going by SKILL.md and its folder, Playbooks needs TypeScript for the scripts in its folder. Our summary lists: Node.js. Compatibility (from SKILL.md): Designed for Vellum personal assistants.

Does Playbooks access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Playbooks safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Playbooks use?

Playbooks is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Playbooks use?

About 363 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Playbooks?

Skills that share tags, products or a category with Playbooks: Messages Ops (affaan-m/ECC, 277k stars), Actions (JetBrains/intellij-community, 21k stars), Laravel Actions (coollabsio/coolify, 63k stars) and Channel Message Flows (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Playbooks?

vellum-ai (a GitHub organization) maintains it in vellum-ai/vellum-assistant, which has 1,408 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 9, 2026.

Source: vellum-ai/vellum-assistant on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.