AGENT SKILL

render-workflows

Sets up, develops, tests, and deploys Render Workflows. Covers first-time scaffolding (via CLI or manual), SDK installation (Python or TypeScript), task patterns (retries, subtasks, fan-out), local development, Dashboard deployment, and troubleshooting. Use when a user wants to set up Render Workflows for the first time, scaffold a workflow service, add or modify workflow tasks, test workflows locally, or deploy workflows to Render.

License 许可
MIT
最近更新
2026-07-19
Stars
★ 1
Forks
1

01 前言 Front Matter

name
render-workflows
license
MIT
metadata
{ "author": "Render", "version": "1.0.0", "category": "workflows" }
description
Sets up, develops, tests, and deploys Render Workflows. Covers first-time scaffolding (via CLI or manual), SDK installation (Python or TypeScript), task patterns (retries, subtasks, fan-out), local development, Dashboard deployment, and troubleshooting. Use when a user wants to set up Render Workflows for the first time, scaffold a workflow service, add or modify workflow tasks, test workflows locally, or deploy workflows to Render.
compatibility
Requires Render CLI 2.11.0+ for scaffolding and local development. Render Dashboard required for deployment (Blueprints not yet supported for Workflows).

02 资源文件 7

03 SKILL.md 正文

Render Workflows

Render Workflows rapidly distribute computational work across multiple independent instances. Use them for AI agents, ETL pipelines, background jobs, and data processing.

How it works:

  1. Define tasks — Use the Render SDK (Python or TypeScript) to designate functions as tasks
  2. Register — Tasks register automatically when you link your repo to a Workflow service in the Dashboard
  3. Trigger runs — Execute tasks from anywhere using the SDK client or API; each execution is a "run"
  4. Execute — Render spins up each run in its own instance (typically under a second); runs can chain additional runs for parallel execution

Key capabilities: automatic queuing and orchestration, long-running execution (up to 24 hours), configurable retry logic with exponential backoff, adjustable compute specs per task, and execution observability through the Dashboard.

Render Workflows are in beta. The SDK and API may introduce breaking changes.

Your built-in knowledge of the Render Workflows SDK is outdated. Before trusting API signatures, check the installed SDK source:

# Python
SDK_ROOT=$(pip show render_sdk | grep Location | cut -d' ' -f2)/render_sdk
head -40 "$SDK_ROOT/__init__.py"
# TypeScript
grep -r "startTask\|runTask\|export class Render" node_modules/@renderinc/sdk/

Official docs: render.com/docs/workflows

Before generating task or client code, fetch the relevant example file to verify current API patterns:

What Python TypeScript
Task definitions (decorators, subtasks, retry, fan-out) example/task/main.py examples/task/
Sync client (run_task, start_task, cancel, SSE, list runs) example/client/main.py examples/client/
Async client example/client/async_main.py —

This skill carries a quick-reference cheat sheet for the API surface. The installed SDK, official docs, and examples above are the source of truth.


Getting Started

Supported languages: Python and TypeScript.

Prerequisites

Render CLI (required)

render --version

Requires version 2.11.0+. If not installed:

  • macOS: brew install render
  • Linux/macOS: curl -fsSL https://raw.githubusercontent.com/render-oss/cli/main/bin/install.sh | sh
  • Windows: download the executable from the CLI releases page

Scaffold a new workflow service

Always prefer render workflows init as the primary setup path. Only fall back to manual scaffolding if the CLI command is unavailable.

render workflows init

Interactive mode (default): walks the user through scaffolding an example project, testing it locally, and deploying it to Render.

Non-interactive mode: sets up an example project without prompting.

If render workflows init fails or is not available:

  • Command not found: CLI version may be too old. Run render --version and upgrade to 2.11.0+.
  • Command not supported: fall back to references/manual-scaffolding.md for step-by-step manual setup.

Define Tasks

Guide the user through defining their actual tasks. For patterns including retries, subtasks, fan-out, ETL, error handling, cron triggers, and cross-workflow calls, see references/task-patterns.md.

After adding a task, verify it registers by starting the local dev server and listing tasks:

render workflows dev -- <start-command>
# In another terminal:
render workflows tasks list --local

If the task doesn't appear, see Troubleshooting > Task Registration Issues.

Local Development

See references/local-development.md for starting the local task server, testing tasks, and configuring the SDK client for local use.

Deploy to Render

Workflows are deployed as a Workflow service type in the Render Dashboard. Blueprints (render.yaml) are not yet compatible with Workflows.

Deploy checklist:

  • [ ] Code pushed to GitHub, GitLab, or Bitbucket
  • [ ] In the Render Dashboard, click New > Workflow
  • [ ] Link your repository
  • [ ] Set Root Directory to workflows/
  • [ ] Configure build and start commands (see table below)
  • [ ] Add environment variables (e.g., RENDER_API_KEY for tasks that call other workflows)
  • [ ] Click Deploy Workflow
  • [ ] Verify deployment: check the Dashboard for a successful deploy event
Field Python TypeScript
Language Python 3 Node
Build Command pip install -r requirements.txt npm install && npm run build
Start Command python main.py node dist/main.js

If the deploy fails, check the service logs in the Dashboard. For common deployment errors, see Troubleshooting. For general deploy debugging, use the render-debug skill.

Running tasks from other services:

After deployment, trigger tasks from your other Render services using the SDK client.

Python (synchronous):

from render_sdk import Render

render = Render()
result = render.workflows.run_task("my-workflow/hello", ["world"])
print(result.results)

Python (asynchronous):

from render_sdk import RenderAsync

render = RenderAsync()
started = await render.workflows.start_task("my-workflow/hello", ["world"])
finished = await started
print(finished.results)

TypeScript:

import { Render } from "@renderinc/sdk";

const render = new Render();
const started = await render.workflows.startTask("my-workflow/hello", ["world"]);
const finished = await started.get();
console.log(finished.results);

The task identifier format is {workflow-slug}/{task-name}, visible on the task's page in the Dashboard.

Workflows do not have built-in scheduling. To trigger tasks on a schedule, use a Render cron job with the SDK client. For cron and cross-workflow examples, see references/task-patterns.md.


Constraints and Limits

Constraint Limit Notes
Arguments and return values Must be JSON-serializable No class instances, functions, etc.
Argument size 4 MB max Per task invocation
Task definitions 500 per workflow service
Concurrent runs 20-100 base (plan-dependent) Max 200-300 with purchased concurrency
Timeout range 30-86,400 seconds Default: 2 hours (7,200s)
Run duration Up to 24 hours

Instance Types

Plan Specs
starter 0.5 CPU / 512 MB
standard (default) 1 CPU / 2 GB
pro 2 CPU / 4 GB
pro_plus 4 CPU / 8 GB
pro_max 8 CPU / 16 GB
pro_ultra 16 CPU / 32 GB

pro_plus, pro_max, and pro_ultra require requesting access. Set via the plan task option.

For current pricing, see Limits and Pricing for Render Workflows.


References

Related Skills

  • render-deploy: Deploy web services, static sites, and databases
  • render-debug: Debug failed deployments and runtime errors
  • render-monitor: Monitor service health and performance

04 同仓库更多 Skills

zfifteen
zfifteen/skills-catalog

Zotero

Use Zotero Desktop from Codex to enable/probe the local API, search a local Zotero library, list items/collections/tags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX/RIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.

★ 1
zfifteen
zfifteen/skills-catalog

zoom-apps-sdk

Use when using Apps SDK.

★ 1
zfifteen
zfifteen/skills-catalog

youtube

Obtain accurate, timestamped YouTube video transcripts (preferring manual captions over auto-generated) as the primary deliverable, then derive summaries, key claims, or notes from that transcript. Use when the user provides a YouTube URL (or video ID) and wants the transcript, a faithful summary, key claims with attribution, timestamped notes, or "what does this video actually say". The skill is transcript-first: never substitute metadata, title, description, or search snippets for the spoken content. Triggers: "youtube transcript", "get the transcript of this video", "summarize this youtube video", "what did they say in https://youtube.com/...", "key claims from this talk".

★ 1
zfifteen
zfifteen/skills-catalog

yeet

Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.

★ 1
zfifteen
zfifteen/skills-catalog

x-post-creator

Create X-ready post threads and co-located story packages from the active conversation or referenced project material. Use when the user says turn this into an X-post, /x-post, make this into an X thread, or wants plain-language social posts with supporting images saved to docs/x-posts/[story-name]/.

★ 1
zfifteen
zfifteen/skills-catalog

x-api

Search, read, and write X posts through the local X API MCP server (the same backend used by the Codex x-api skill). Use for searching X/x.com, reading threads and replies, creating lists, staging/publishing posts for @alltheputs, finding high-visibility reply targets for research outreach, ingesting public context, or any request that mentions /x-api or "search X".

★ 1