Agent skill

Convex Dev Workflow

by vvedantb in vvedantb/eva

Execute long-running code flows durably with built-in retries, delays, and state persistence across function interruptions.

MITAuto-check passedAgent Workflows

Install Convex Dev Workflow

skills CLI
$ npx skills add vvedantb/eva --skill convex-dev-workflow -a claude-code

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

GitHub CLI
$ gh skill install vvedantb/eva convex-dev-workflow --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/vvedantb/eva.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/convex-dev-workflow .claude/skills/convex-dev-workflow && 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
convex-dev-workflow
GitHub stars
101
Token cost
~1k tokens
SKILL.md length
497 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Execute long-running code flows durably with built-in retries, delays, and state persistence across function interruptions.

  • Working with durable-functions features
  • SKILL.md covers Instructions, Examples, Troubleshooting and Resources
  • Calls npm
  • Tasks that involve Agent memory

What it does

Convex Dev Workflow is an agent skill from vvedantb/eva. Execute long-running code flows durably with built-in retries, delays, and state persistence across function interruptions. Use when working with durable-functions features, Workflow.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Agent memory and Error handling. It works with Convex. The repository describes itself as: Orchestrate sandboxed agents that run in the cloud while you work. The licence is MIT.

When your agent uses it

  • Working with durable-functions features
  • Tasks that involve Agent memory
  • Tasks that involve Error handling

Example prompts

  • “/convex-dev-workflow”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit a5a4df2. 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

    Shell commands in SKILL.md call:

    • npm

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

  • Network

    Links to these hosts (documentation or services it may open):

    • npmjs.com
    • github.com
    • convex.dev
    • docs.convex.dev

    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.

Context cost

Convex Dev Workflow loads about 1k tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 497 words of instructions outside code blocks.

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

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 vvedantb/eva at commit a5a4df2, republished under its MIT licence (© vvedantb). 497 words, ~1,046 tokens.

Download SKILL.mdSave it as .claude/skills/convex-dev-workflow/SKILL.md (or your agent's skills folder).
name
convex-dev-workflow
description
Execute long-running code flows durably with built-in retries, delays, and state persistence across function interruptions. Use when working with durable-functions features, Workflow.

Workflow

Instructions

Workflow is a Convex component that provides execute long-running code flows durably with built-in retries, delays, and state persistence across function interruptions.

Installation
bash
npm install @convex-dev/workflow
Capabilities
  • Eliminate manual retry logic with configurable backoff strategies and error handling
  • Persist workflow state automatically across function timeouts and database interruptions
  • Build complex multi-step processes without managing intermediate state storage
  • Resume workflows from exact failure points without losing progress or duplicating work

Examples

how to handle long running processes in Convex functions

The Workflow component enables you to break long-running processes into durable steps that persist across function timeouts. Each workflow step executes with automatic retries and state preservation, allowing complex operations to complete reliably even if individual function calls fail or timeout.

Convex function retry logic with delays

Workflow provides built-in retry mechanisms with configurable delays between attempts. You can define custom backoff strategies and specify which errors should trigger retries, eliminating the need to implement retry logic manually in your Convex functions.

durable function execution Convex

Workflows execute durably by persisting their state to the Convex database between steps. If a function is interrupted or fails, the workflow resumes from the last completed step rather than restarting from the beginning, ensuring reliable execution of multi-step processes.

multi-step process state management Convex

The Workflow component automatically manages intermediate state for multi-step processes. You define workflow steps as regular functions, and the component handles state persistence, progress tracking, and coordination between steps without requiring manual state management code.

Show full SKILL.md (253 more words)Show less

Troubleshooting

How does Workflow handle function timeouts in Convex?

The Workflow component automatically persists workflow state to the database before each step executes. When a function times out, the workflow can resume from the last completed step rather than restarting entirely, ensuring progress is never lost during long-running operations.

Can I customize retry behavior for different types of errors?

Yes, Workflow allows you to configure retry strategies including which error types should trigger retries, maximum retry attempts, and delay patterns between retries. You can define different retry policies for different workflow steps based on your specific error handling needs.

What happens to workflow state if my Convex function crashes?

Workflow state is persisted to the Convex database after each step completes successfully. If a function crashes or is interrupted, the workflow will resume from the last successfully completed step when it runs again, preserving all intermediate results and progress.

How do I pass data between workflow steps?

The Workflow component automatically manages data flow between steps through its state persistence mechanism. Return values from completed steps are stored and made available to subsequent steps, eliminating the need to manually manage intermediate data storage or retrieval.

Can workflows call other Convex functions like mutations and queries?

Yes, workflow steps can call other Convex functions including mutations, queries, and actions. The Workflow component ensures these calls are made durably, with proper error handling and retry logic applied to maintain consistency across your application's data operations.

Resources

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

Files

Just SKILL.md in .claude/skills/convex-dev-workflow of vvedantb/eva.

Open the folder on GitHubat commit a5a4df2

Compare with similar skills

Convex Dev Workflow 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.

Convex Dev Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Convex Dev Workflow this skillvvedantb/eva101—~1kAutomated safety check: PassMIT
AWS Lambda Durable Functionsawslabs/agent-plugins915—~2.3kAutomated safety check: PassApache-2.0
AWS Lambda Durable Functionsaws/agent-toolkit-for-aws2.8k—~2.3kAutomated safety check: PassApache-2.0
Coding Agent Session Findercode-yeongyu/oh-my-openagent70k1 repos~2.8kAutomated safety check: PassCustom licence
Claude-Mem Cloud Syncthedotmack/claude-mem98k1 repos~1kAutomated safety check: NotesApache-2.0
Cognee CLI Memory Commandstopoteretes/cognee32k1 repos~2.2kAutomated safety check: NotesApache-2.0

Similar skills

  • AWS Lambda Durable Functions

    awslabs/agent-plugins

    Official

    Build resilient, long-running, multi-step applications with AWS Lambda durable functions with automatic state persistence, retry logic, and orchestration for long-running executions.

    915 GitHub stars~2.3k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • AWS Lambda Durable Functions

    aws/agent-toolkit-for-aws

    Official

    Builds resilient, long-running, multi-step applications with AWS Lambda durable functions with automatic state persistence, retry logic, and orchestration for long-running executions.

    2.8k GitHub stars~2.3k tokensUpdated today
    Backend & APIsAuto-check passed
  • Coding Agent Session Finder

    code-yeongyu/oh-my-openagent

    Finds, reads and reconstructs past coding-agent sessions across Codex, Claude, OpenCode, Senpi and many other local agent logs.

    70k GitHub starsUsed in 1 repo~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude-Mem Cloud Sync

    thedotmack/claude-mem

    Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat.

    98k GitHub starsUsed in 1 repo~1k tokens
    Agent WorkflowsAuto-check: notes
  • Cognee CLI Memory Commands

    topoteretes/cognee

    Drives cognee from the terminal with remember, recall, forget and improve memory commands, dataset and config management and database migrations.

    32k GitHub starsUsed in 1 repo~2.2k tokens
    Agent WorkflowsAuto-check: notes
  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check passed

More from vvedantb/eva

All 23 skills in this repo
  • Eva Feature Demo

    vvedantb/eva

    Record a real agent-browser screencast of one eva feature being used end to end, convert it to an X-ready mp4, and write a tweet for it.

    101 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Animate

    vvedantb/eva

    Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and…

    101 GitHub starsUsed in 6 repos~2.9k tokens
    Auto-check passed
  • Design and build Convex components with clear boundaries, isolated state, and app-facing wrappers.

    101 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Grab a single clean HD screenshot of a new eva feature from the real running app (Playwright at deviceScaleFactor 2, 1280 layout captured crisp at 2560×1440, dev overlays hidden) and write a tweet…

    101 GitHub stars~3.2k tokensUpdated today
    Auto-check: notes
  • Code Structure

    vvedantb/eva

    A skill your agent uses when multiple workflows duplicate the same operational logic, when deciding what belongs in actions vs shared services, or when refactoring repeated operational blocks across…

    101 GitHub starsUsed in 2 repos~1.1k tokens
    Auto-check passed
  • Eva Launch Video

    vvedantb/eva

    Produce polished, mobile-friendly product demo videos of the eva app with Remotion — 1280×720, snappy beat-synced hard cuts, lo-fi music that swells on every cut, and footage captured from the REAL…

    101 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Convex Dev Workflow

What does Convex Dev Workflow do?

Execute long-running code flows durably with built-in retries, delays, and state persistence across function interruptions. Convex Dev Workflow is an agent skill from vvedantb/eva. Execute long-running code flows durably with built-in retries, delays, and state persistence across function interruptions.

When should I use Convex Dev Workflow?

Convex Dev Workflow fits situations like: working with durable-functions features; tasks that involve Agent memory; tasks that involve Error handling.

How do I install Convex Dev Workflow in Claude Code?

Run `npx skills add vvedantb/eva --skill convex-dev-workflow -a claude-code`. Or copy the skill folder (.claude/skills/convex-dev-workflow in vvedantb/eva) into .claude/skills/convex-dev-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Convex Dev Workflow in Codex?

Run `npx skills add vvedantb/eva --skill convex-dev-workflow -a codex`. Or copy the skill folder (.claude/skills/convex-dev-workflow in vvedantb/eva) into .agents/skills/convex-dev-workflow in your project. Codex loads it when a task matches its description.

Can I use Convex Dev Workflow 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 vvedantb/eva --skill convex-dev-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/convex-dev-workflow, .gemini/skills/convex-dev-workflow, .github/skills/convex-dev-workflow and .opencode/skills/convex-dev-workflow in your project.

What does Convex Dev Workflow need to run?

Going by SKILL.md and its folder, Convex Dev Workflow needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Convex Dev Workflow access the network?

SKILL.md names 4 domains. As links in the text: npmjs.com, github.com, convex.dev and docs.convex.dev. This is read from the text; nothing was executed.

Is Convex Dev Workflow 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 Convex Dev Workflow use?

Convex Dev Workflow 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 Convex Dev Workflow use?

About 1k tokens (SKILL.md is roughly 4.2k 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 Convex Dev Workflow?

Skills that share tags, products or a category with Convex Dev Workflow: AWS Lambda Durable Functions (awslabs/agent-plugins, 915 stars), AWS Lambda Durable Functions (aws/agent-toolkit-for-aws, 2.8k stars), Coding Agent Session Finder (code-yeongyu/oh-my-openagent, 70k stars) and Claude-Mem Cloud Sync (thedotmack/claude-mem, 98k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Convex Dev Workflow?

vvedantb (a GitHub user) maintains it in vvedantb/eva, which has 101 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 8, 2026.

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