Agent skill

New Exec Type

by flowexec in flowexec/flow

Add a new executable type to the flow runner (a new kind of automation block users can define in .flow files).

Apache-2.0Auto-check passed

Install New Exec Type

skills CLI
$ npx skills add flowexec/flow --skill new-exec-type -a claude-code

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

GitHub CLI
$ gh skill install flowexec/flow new-exec-type --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/flowexec/flow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/new-exec-type .claude/skills/new-exec-type && 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
new-exec-type
GitHub stars
137
Token cost
~462 tokens
SKILL.md length
174 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

Add a new executable type to the flow runner (a new kind of automation block users can define in .flow files).

  • Works in 6 steps: Schema first — add the new type's fields… → Runner handler — each type is its own… → Register the type — wire the new handler… → …
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

New Exec Type is an agent skill from flowexec/flow. Add a new executable type to the flow runner (a new kind of automation block users can define in .flow files).

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

The repository describes itself as: Local-first CLI for defining and running your project's workflows. The licence is Apache-2.0.

Example prompts

  • “/new-exec-type”

Requirements

  • Pre-approved tools (allowed-tools): mcp__flow__execute, mcp__flow__run_command, mcp__flow__list_executables, Bash(flow generate:*), Bash(flow validate:*), Bash(flow build:*), Bash(go test:*), Read

Workflow steps

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

  1. Schema first — add the new type's fields to types/executable/executable_schema.yaml.
  2. Runner handler — each type is its own package: create internal/runner//.go.
  3. Register the type — wire the new handler into internal/runner/runner.go (the dispatch table).
  4. Parser support — update internal/fileparser/ if needed to recognize and validate the new type during YAML parsing.
  5. Tests — add unit tests in internal/runner//_test.go using Ginkgo.
  6. Validate — run the validate executable (mcpflowexecute, ref validate) to confirm

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • mcp__flow__execute
    • mcp__flow__run_command
    • mcp__flow__list_executables
    • Bash(flow generate:*)
    • Bash(flow validate:*)
    • Bash(flow build:*)
    • Bash(go test:*)
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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.

Context cost

New Exec Type loads about 462 tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 174 words of instructions outside code blocks.

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

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 flowexec/flow at commit 0583ac5, republished under its Apache-2.0 licence (© flowexec). 174 words, ~462 tokens.

Download SKILL.mdSave it as .claude/skills/new-exec-type/SKILL.md (or your agent's skills folder).
name
new-exec-type
description
Add a new executable type to the flow runner (a new kind of automation block users can define in .flow files).
allowed-tools
mcp__flow__execute, mcp__flow__run_command, mcp__flow__list_executables, Bash(flow generate:*), Bash(flow validate:*), Bash(flow build:*), Bash(go test:*), Read
disable-model-invocation
true
argument-hint
<type-name> — description of what this executable type does

Add a new executable type to the flow runner for: $ARGUMENTS

An "executable type" is a new automation block users can declare in .flow files (like exec, serial, parallel, render). Follow these steps in order:

  1. Schema first — add the new type's fields to types/executable/executable_schema.yaml. Read the existing schema to match the structure. Regenerate with the generate executable (mcp__flow__execute, ref generate) — it rewrites types/executable/executable.gen.go. Never edit the .gen.go file directly.

  2. Runner handler — each type is its own package: create internal/runner/<type>/<type>.go. Read internal/runner/exec/exec.go or internal/runner/serial/serial.go as reference for the exact interface and pattern.

  3. Register the type — wire the new handler into internal/runner/runner.go (the dispatch table).

  4. Parser support — update internal/fileparser/ if needed to recognize and validate the new type during YAML parsing.

  5. Tests — add unit tests in internal/runner/<type>/<type>_test.go using Ginkgo. Use Describe/It/Entry — never FDescribe/FIt. Cover happy path and error cases.

  6. Validate — run the validate executable (mcp__flow__execute, ref validate) to confirm generate, lint, and tests all pass.

Do not skip the schema step — editing generated files directly will cause CI to fail.

© flowexec, Apache-2.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 .claude/skills/new-exec-type of flowexec/flow.

Open the folder on GitHubat commit 0583ac5

Compare with similar skills

New Exec Type 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.

New Exec Type compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
New Exec Type this skillflowexec/flow137—~462Automated safety check: PassApache-2.0
Executealirezarezvani/claude-skills28k—~831Automated safety check: PassMIT
Ulw Executecode-yeongyu/oh-my-openagent70k—~6.3kAutomated safety check: PassCustom licence
Executebrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~370Automated safety check: NotesCustom licence
Agent Test Long Runnerruvnet/ruflo74k2 repos~426Automated safety check: PassMIT
Add Runner Evalpaperclipai/paperclip98k—~1kAutomated safety check: PassMIT

Similar skills

  • Execute

    alirezarezvani/claude-skills

    /cs:execute <decision — Generate a 90-day execution plan with weekly milestones, DRIs, and check-in cadence from an approved decision.

    28k GitHub stars~831 tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Ulw Execute

    code-yeongyu/oh-my-openagent

    Executes a written ulw-plan work plan with Boulder state, evidence ledger, worktree discipline, and parallel subagents.

    70k GitHub stars~6.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Execute

    brycewang-stanford/Auto-Empirical-Research-Skills

    Executes all registered notebooks, strips noisy cell metadata, and syncs Jupytext pairs.

    4.5k GitHub stars~370 tokensUpdated 2 days ago
    Data & AnalyticsAuto-check: notes
  • Agent skill for test-long-runner - invoke with $agent-test-long-runner

    74k GitHub starsUsed in 2 repos~426 tokens
    Agent WorkflowsAuto-check passed
  • Add Runner Eval

    paperclipai/paperclip

    Add or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.

    98k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Execution

    alsk1992/CloddsBot

    Execute trades on prediction markets with slippage protection and order management

    2.9k GitHub stars~1.7k tokensUpdated 5 days ago
    Sales & SupportAuto-check passed

More from flowexec/flow

  • Flow Context

    flowexec/flow

    This project uses flow for automation. An agent skill from flowexec/flow.

    137 GitHub stars~654 tokensUpdated 6 days ago
    Auto-check passed
  • New Command

    flowexec/flow

    Scaffold a new Cobra CLI command following the project's patterns.

    137 GitHub stars~404 tokensUpdated 6 days ago
    Auto-check passed
  • PR Ready

    flowexec/flow

    Run a pre-PR readiness check and report READY or NOT READY. An agent skill from flowexec/flow.

    137 GitHub stars~384 tokensUpdated 6 days ago
    Auto-check passed
  • Validate

    flowexec/flow

    Run flow validate and fix any failures. An agent skill from flowexec/flow.

    137 GitHub stars~375 tokensUpdated 6 days ago
    Auto-check passed

Questions about New Exec Type

What does New Exec Type do?

Add a new executable type to the flow runner (a new kind of automation block users can define in .flow files). New Exec Type is an agent skill from flowexec/flow.flow files).

How do I install New Exec Type in Claude Code?

Run `npx skills add flowexec/flow --skill new-exec-type -a claude-code`. Or copy the skill folder (.claude/skills/new-exec-type in flowexec/flow) into .claude/skills/new-exec-type in your project. Claude Code loads it when a task matches its description.

How do I install New Exec Type in Codex?

Run `npx skills add flowexec/flow --skill new-exec-type -a codex`. Or copy the skill folder (.claude/skills/new-exec-type in flowexec/flow) into .agents/skills/new-exec-type in your project. Codex loads it when a task matches its description.

Can I use New Exec Type 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 flowexec/flow --skill new-exec-type -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/new-exec-type, .gemini/skills/new-exec-type, .github/skills/new-exec-type and .opencode/skills/new-exec-type in your project.

What does New Exec Type need to run?

SKILL.md names no scripts, command-line tools or credentials: New Exec Type is instructions for the agent only. Its frontmatter pre-approves these tools: mcp__flow__execute, mcp__flow__run_command, mcp__flow__list_executables, Bash(flow generate:*), Bash(flow validate:*), Bash(flow build:*), Bash(go test:*), Read.

Does New Exec Type 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 New Exec Type 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 New Exec Type use?

New Exec Type is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does New Exec Type use?

About 462 tokens (SKILL.md is roughly 1.8k 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 New Exec Type?

Skills that share tags, products or a category with New Exec Type: Execute (alirezarezvani/claude-skills, 28k stars), Ulw Execute (code-yeongyu/oh-my-openagent, 70k stars), Execute (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars) and Agent Test Long Runner (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains New Exec Type?

flowexec (a GitHub organization) maintains it in flowexec/flow, which has 137 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 1, 2026.

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