Agent skill

Workflow Init

by usenotra in usenotra/notra

Install and configure Vercel Workflow SDK before it exists in nodemodules.

AGPL-3.0Auto-check passedBackend & APIs

Install Workflow Init

skills CLI
$ npx skills add usenotra/notra --skill workflow-init -a claude-code

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

GitHub CLI
$ gh skill install usenotra/notra workflow-init --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/usenotra/notra.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/workflow-init .claude/skills/workflow-init && 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
workflow-init
GitHub stars
255
Token cost
~821 tokens
SKILL.md length
312 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Install and configure Vercel Workflow SDK before it exists in nodemodules.

  • Works in 5 steps: Sanity check → Determine the framework → Fetch and follow the getting-started guide → …
  • The user asks to install workflow
  • SKILL.md covers Decision flow, Concept questions (pre-install) and Handoff
  • Calls npx

What it does

Workflow Init is an agent skill from usenotra/notra. Install and configure Vercel Workflow SDK before it exists in nodemodules. Use when the user asks to "install workflow", "set up workflow", "add durable workflows", "configure workflow sdk", or "init workflow" for Next.js, Express, Hono, Fastify, NestJS, Nitro, Nuxt, Astro, SvelteKit, or Vite.

Its SKILL.md is about 820 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 Backend & APIs, covering Static sites and blogs. It works with Astro, Nuxt, Vite and Fastify. The repository describes itself as: Notra is a modern GEO tool that asks ChatGPT, Claude and Gemini the questions your buyers ask. See if you show up, who shows up instead and how to fix it. The licence is AGPL-3.0.

When your agent uses it

  • The user asks to install workflow
  • Set up workflow
  • Add durable workflows
  • Configure workflow sdk

Example prompts

  • “install workflow”
  • “set up workflow”
  • “add durable workflows”
  • “/workflow-init”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Sanity check
  2. Determine the framework
  3. Fetch and follow the getting-started guide
  4. Verify setup
  5. No framework yet?

What it can do on your machine

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

    • npx

    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):

    • workflow-sdk.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

Workflow Init loads about 821 tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 312 words of instructions outside code blocks.

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

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 usenotra/notra at commit 59bbf7d, republished under its AGPL-3.0 licence (© usenotra). 312 words, ~821 tokens.

Download SKILL.mdSave it as .claude/skills/workflow-init/SKILL.md (or your agent's skills folder).
name
workflow-init
description
Install and configure Vercel Workflow SDK before it exists in node_modules. Use when the user asks to "install workflow", "set up workflow", "add durable workflows", "configure workflow sdk", or "init workflow" for Next.js, Express, Hono, Fastify, NestJS, Nitro, Nuxt, Astro, SvelteKit, or Vite.
metadata.author
Vercel Inc.
metadata.version
1.4

workflow-init

Initial setup of Vercel Workflow SDK before workflow is installed. Fetch the official getting-started guide for the user's framework.

Decision flow

0) Sanity check

Read package.json. If workflow is already a dependency, tell the user to use /workflow instead (it reads versioned docs from node_modules/workflow/docs/). Only continue if workflow is missing.

1) Determine the framework

Non-interactive: If the user named a framework in their prompt, use it directly.

Auto-detect: Inspect package.json deps and config files. Use the first match:

  1. Next.js - next dep or next.config.*
  2. Nuxt - nuxt dep or nuxt.config.*
  3. SvelteKit - @sveltejs/kit dep or svelte.config.*
  4. Astro - astro dep or astro.config.*
  5. NestJS - @nestjs/core dep or nest-cli.json
  6. Nitro - nitro dep or nitro.config.*
  7. Express - express dep
  8. Fastify - fastify dep
  9. Hono - hono dep
  10. Vite - vite dep (and not matched above)

If no match or multiple matches, ask the user to pick.

2) Fetch and follow the getting-started guide

Fetch exactly one of these URLs and follow the guide step-by-step:

Each guide covers: install deps, configure framework, create first workflow, create route handler, run + verify.

3) Verify setup
  • Start the dev server per the guide.
  • Trigger the example endpoint with the provided curl.
  • Confirm logs show the workflow and steps executing.
  • Optional: npx workflow web or npx workflow inspect runs.
4) No framework yet?

If no framework exists, ask what the user wants:

  • Web app: Next.js / Nuxt / SvelteKit / Astro
  • API server: Express / Fastify / Hono
  • Minimal server: Nitro or Vite

Then follow the "Create Your Project" section of the chosen guide.

Concept questions (pre-install)

If the user asks conceptual questions before installing, fetch:

Handoff

When setup is complete, tell the user: Use /workflow for ongoing development - it reads the versioned docs bundled in node_modules/workflow/docs/.

© usenotra, AGPL-3.0. 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 .agents/skills/workflow-init of usenotra/notra.

Open the folder on GitHubat commit 59bbf7d

Compare with similar skills

Workflow Init 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.

Workflow Init compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workflow Init this skillusenotra/notra255—~821Automated safety check: PassAGPL-3.0
Launch With AWSaws/agent-toolkit-for-aws2.8k—~3.2kAutomated safety check: PassApache-2.0
Cloudflare Workers Frameworkssecondsky/claude-skills227—~1.4kAutomated safety check: PassMIT
Feature Sliced Designfeature-sliced/skills109—~5.5kAutomated safety check: PassNone
Sanity Best Practicessanity-io/agent-toolkit187—~1.3kAutomated safety check: PassMIT
Review Logging Patternsevloghq/evlog1.9k—~11kAutomated safety check: PassMIT

Similar skills

  • Launch With AWS

    aws/agent-toolkit-for-aws

    Official

    Migrates vibe-coded web applications to AWS. An agent skill from aws/agent-toolkit-for-aws.

    2.8k GitHub stars~3.2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Cloudflare Workers Frameworks

    secondsky/claude-skills

    Framework integration for Cloudflare Workers. An agent skill from secondsky/claude-skills.

    227 GitHub stars~1.4k tokensUpdated 9 days ago
    Frontend & DesignAuto-check passed
  • Feature Sliced Design

    feature-sliced/skills

    Official Feature-Sliced Design (FSD) v2.1 skill for applying the methodology to frontend projects.

    109 GitHub stars~5.5k tokensUpdated 21 days ago
    Frontend & DesignAuto-check passed
  • Sanity Best Practices

    sanity-io/agent-toolkit

    Official

    Sanity development best practices for schema design, GROQ queries, TypeGen, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, webhooks, Blueprints…

    187 GitHub stars~1.3k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Review code for logging patterns and suggest evlog adoption.

    1.9k GitHub stars~11k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Cloudbase Sites Runtime

    TencentCloudBase/CloudBase-AI-Toolkit

    A skill your agent uses when the user wants to develop, run, preview, save, deploy, or roll back a CloudBase Web app in this conversation as a Lovable/Codex-Sites-like vibe- coding session — i.e.

    1.1k GitHub stars~5k tokensUpdated yesterday
    MobileAuto-check: notes

More from usenotra/notra

All 17 skills in this repo
  • Ponytail Help

    usenotra/notra

    Quick-reference card for all ponytail modes, skills, and commands.

    255 GitHub starsUsed in 3 repos~697 tokens
    Auto-check passed
  • Neon Postgres

    usenotra/notra

    Guides and best practices for working with Lakebase Postgres, the database behind Neon.

    255 GitHub stars~4.1k tokensUpdated today
    Auto-check: notes
  • Satori

    usenotra/notra

    Expert guidance for Satori, the library that converts JSX/HTML and CSS into SVG (the engine behind dynamic Open Graph images and social cards).

    255 GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Workos Widgets

    usenotra/notra

    A skill your agent uses when the user is implementing, embedding, or debugging a WorkOS Widget — specifically the User Management, User Profile, Admin Portal SSO Connection, or Admin Portal Domain…

    255 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Autumn Catalog

    usenotra/notra

    Modeling a user's pricing into an Autumn catalog — deciding the structure (plans, variants, add-ons, licenses, credit systems, pooled balances) before writing config, then filling in the numbers.

    255 GitHub stars~6.1k tokensUpdated today
    Auto-check passed
  • Code Organization

    usenotra/notra

    Repo file-organization convention for TypeScript projects. An agent skill from usenotra/notra.

    255 GitHub stars~893 tokensUpdated today
    Auto-check passed

Questions about Workflow Init

What does Workflow Init do?

Install and configure Vercel Workflow SDK before it exists in nodemodules. Workflow Init is an agent skill from usenotra/notra. Install and configure Vercel Workflow SDK before it exists in nodemodules.

When should I use Workflow Init?

Workflow Init fits situations like: the user asks to install workflow; set up workflow; add durable workflows; configure workflow sdk.

How do I install Workflow Init in Claude Code?

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

How do I install Workflow Init in Codex?

Run `npx skills add usenotra/notra --skill workflow-init -a codex`. Or copy the skill folder (.agents/skills/workflow-init in usenotra/notra) into .agents/skills/workflow-init in your project. Codex loads it when a task matches its description.

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

What does Workflow Init need to run?

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

Does Workflow Init access the network?

SKILL.md names 1 domain. As links in the text: workflow-sdk.dev. This is read from the text; nothing was executed.

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

Workflow Init is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Workflow Init use?

About 821 tokens (SKILL.md is roughly 3.3k 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 Workflow Init?

Skills that share tags, products or a category with Workflow Init: Launch With AWS (aws/agent-toolkit-for-aws, 2.8k stars), Cloudflare Workers Frameworks (secondsky/claude-skills, 227 stars), Feature Sliced Design (feature-sliced/skills, 109 stars) and Sanity Best Practices (sanity-io/agent-toolkit, 187 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workflow Init?

usenotra (a GitHub organization) maintains it in usenotra/notra, which has 255 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 7, 2026.

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