Agent skill

Workflow Patterns

by QuintinShaw in QuintinShaw/pi-dynamic-workflows

Argument shapes for the 5 built-in workflow patterns — deep-research, adversarial-review, code-review, multi-perspective, codebase-audit — runnable via the workflow tool's name input, without…

MITAuto-check passedResearch & Science

Install Workflow Patterns

skills CLI
$ npx skills add QuintinShaw/pi-dynamic-workflows --skill workflow-patterns -a claude-code

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

GitHub CLI
$ gh skill install QuintinShaw/pi-dynamic-workflows workflow-patterns --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/QuintinShaw/pi-dynamic-workflows.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/workflow-patterns .claude/skills/workflow-patterns && 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-patterns
GitHub stars
554
Token cost
~827 tokens
SKILL.md length
355 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Argument shapes for the 5 built-in workflow patterns — deep-research, adversarial-review, code-review, multi-perspective, codebase-audit — runnable via the workflow tool's name input, without…

  • Requests like research X
  • SKILL.md covers Patterns, Example and Writing a new workflow instead
  • Calls git and gh
  • Fact-check/adversarially review this

What it does

Workflow Patterns is an agent skill from QuintinShaw/pi-dynamic-workflows. Argument shapes for the 5 built-in workflow patterns — deep-research, adversarial-review, code-review, multi-perspective, codebase-audit — runnable via the workflow tool's name input, without slash-command syntax. Use for requests like "research X", "fact-check/adversarially review this", "review this diff/PR", "analyze from multiple perspectives", or "audit the codebase for Y". Not for authoring a new workflow script — see workflow-authoring.

Its SKILL.md is about 830 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 Research & Science, covering Deep research, Hooks and plugins and Code review. It works with TypeScript. The repository describes itself as: Claude Code–style dynamic workflows for Pi: code-mode subagents with real model routing, journaled resume, git-worktree isolation, cost accounting, an interactive /workflows TUI… The licence is MIT.

When your agent uses it

  • Requests like research X
  • Fact-check/adversarially review this
  • Review this diff/PR
  • Analyze from multiple perspectives

Example prompts

  • “s name input, without slash-command syntax. Use for requests like”
  • “fact-check/adversarially review this”
  • “review this diff/PR”
  • “/workflow-patterns”

What it can do on your machine

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

    • git
    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.

    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 Patterns loads about 827 tokens when it runs. Until then it costs about 117 tokens; SKILL.md has 355 words of instructions outside code blocks.

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

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 QuintinShaw/pi-dynamic-workflows at commit 3a52f19, republished under its MIT licence (© QuintinShaw). 355 words, ~827 tokens.

Download SKILL.mdSave it as .claude/skills/workflow-patterns/SKILL.md (or your agent's skills folder).
name
workflow-patterns
description
Argument shapes for the 5 built-in workflow patterns — deep-research, adversarial-review, code-review, multi-perspective, codebase-audit — runnable via the `workflow` tool's `name` input, without slash-command syntax. Use for requests like "research X", "fact-check/adversarially review this", "review this diff/PR", "analyze from multiple perspectives", or "audit the codebase for Y". Not for authoring a new workflow script — see workflow-authoring.
metadata.version
3.7.0

Built-in workflow patterns

pi-dynamic-workflows ships 5 curated, tested workflow patterns. Each is also a slash command (/deep-research, /adversarial-review, /code-review, /multi-perspective, /codebase-audit), but they are equally reachable from the workflow tool directly: call it with name set to the pattern name below and args matching its shape, instead of writing an equivalent script from scratch. Prefer this over authoring a new script whenever the request fits one of these shapes — the curated version is already reviewed and tested.

A project or user saved workflow of the same name always takes precedence over a built-in of that name — on the slash command, too.

These 5 names are reachable only at the workflow tool's top-level name input, not via the in-script await workflow(savedName, childArgs) helper — that helper resolves saved workflows only. Calling workflow('deep-research') from inside a script fails as an unknown saved workflow; use the top-level name input instead.

Patterns

nameWhen to reach for itargs
deep-researchResearch a question across the web with cross-checked sources{ question: string, angles?: number, minSupport?: number } — angles (default 4) is the number of distinct search queries; minSupport (default 2) is the minimum distinct sources required for a claim to survive cross-checking
adversarial-reviewInvestigate a task/claim, then cross-check each finding with skeptical reviewers{ task: string, reviewers?: number, threshold?: number }
code-reviewMulti-angle review of a diff (correctness, reuse, simplification, efficiency, altitude){ diff: string, diffSource?: string } — get diff yourself first (e.g. git diff, gh pr diff <n>); this path does not fetch it for you
multi-perspectiveAnalyze a topic from several independent perspectives in parallel, then synthesize{ topic: string, perspectives?: string[] } — omit or give fewer than 2 to use the default set (technical, product, security, user experience, maintainability)
codebase-auditRun parallel checks against a codebase scope, then cross-validate and report{ scope: string, checks: string[] }
Show full SKILL.md (60 more words)Show less

Example

json
{ "name": "deep-research", "args": { "question": "What are the tradeoffs of X vs Y?" } }

This is a workflow tool call, not a script — omit script entirely. The run starts in the background exactly like the slash-command form; background, maxAgents, concurrency, agentRetries, agentTimeoutMs, and tokenBudget all still apply.

Writing a new workflow instead

If the request doesn't fit one of these 5 shapes, author a script with script as usual — see the workflow-authoring skill.

© QuintinShaw, 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 skills/workflow-patterns of QuintinShaw/pi-dynamic-workflows.

Open the folder on GitHubat commit 3a52f19

Compare with similar skills

Workflow Patterns 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 Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workflow Patterns this skillQuintinShaw/pi-dynamic-workflows554—~827Automated safety check: PassMIT
Deep Research Agent TeamImbad0202/academic-research-skills51k—~13kAutomated safety check: PassCustom licence
Hunk Extension Authoring Mapmodem-dev/hunk9.5k—~5.8kAutomated safety check: PassMIT
Net Deep Researchh4444433333/net-deep-research123—~3.3kAutomated safety check: PassMIT
Architect ResearchDanMcInerney/architect-loop626—~2.3kAutomated safety check: PassMIT
Ray Trend Searchimraywang/rayskills160—~2.1kAutomated safety check: PassCustom licence

Similar skills

  • Deep Research Agent Team

    Imbad0202/academic-research-skills

    Runs a 13-agent pipeline for rigorous academic research, from forming the question through systematic search, synthesis, bias checks and an APA 7.0 report.

    51k GitHub stars~13k tokensUpdated 5 days ago
    Research & ScienceAuto-check passed
  • Maps the hunkdiff/extension API for building Hunk terminal diff viewer extensions: panes, file views, commands, dialogs, themes, VCS backends and lifecycle events.

    9.5k GitHub stars~5.8k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Net Deep Research

    h4444433333/net-deep-research

    Runs cross-source web research to verify whether an online claim is true, distinguishing confirmed facts from rumor, marketing claims or stale information.

    123 GitHub stars~3.3k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Architect Research

    DanMcInerney/architect-loop

    A skill your agent uses when the user asks for discovery-scale research that informs a decision: brainstorming a project or feature, choosing a technology, or requests like "research X", "what's the…

    626 GitHub stars~2.3k tokensUpdated 24 days ago
    Research & ScienceAuto-check passed
  • Ray Trend Search

    imraywang/rayskills

    Researches what people are saying about a topic over a recent window across X, Reddit, YouTube and the public web, reporting each source's status with links.

    160 GitHub stars~2.1k tokensUpdated 15 days ago
    Research & ScienceAuto-check passed
  • Tbd

    jlevy/strif

    Git-native issue tracking (beads), coding guidelines, knowledge injection, and spec-driven planning for AI agents.

    131 GitHub stars~3.5k tokensUpdated 4 mo ago
    DevelopmentAuto-check passed

More from QuintinShaw/pi-dynamic-workflows

  • Workflow Authoring

    QuintinShaw/pi-dynamic-workflows

    Guidance for writing, editing, reviewing, and debugging JavaScript workflow code for pi-dynamic-workflows.

    554 GitHub stars~671 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Workflow Patterns

What does Workflow Patterns do?

Argument shapes for the 5 built-in workflow patterns — deep-research, adversarial-review, code-review, multi-perspective, codebase-audit — runnable via the workflow tool's name input, without…. Workflow Patterns is an agent skill from QuintinShaw/pi-dynamic-workflows. Argument shapes for the 5 built-in workflow patterns — deep-research, adversarial-review, code-review, multi-perspective, codebase-audit — runnable via the workflow tool's name input, without slash-command syntax.

When should I use Workflow Patterns?

Workflow Patterns fits situations like: requests like research X; fact-check/adversarially review this; review this diff/PR; analyze from multiple perspectives.

How do I install Workflow Patterns in Claude Code?

Run `npx skills add QuintinShaw/pi-dynamic-workflows --skill workflow-patterns -a claude-code`. Or copy the skill folder (skills/workflow-patterns in QuintinShaw/pi-dynamic-workflows) into .claude/skills/workflow-patterns in your project. Claude Code loads it when a task matches its description.

How do I install Workflow Patterns in Codex?

Run `npx skills add QuintinShaw/pi-dynamic-workflows --skill workflow-patterns -a codex`. Or copy the skill folder (skills/workflow-patterns in QuintinShaw/pi-dynamic-workflows) into .agents/skills/workflow-patterns in your project. Codex loads it when a task matches its description.

Can I use Workflow Patterns 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 QuintinShaw/pi-dynamic-workflows --skill workflow-patterns -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-patterns, .gemini/skills/workflow-patterns, .github/skills/workflow-patterns and .opencode/skills/workflow-patterns in your project.

What does Workflow Patterns need to run?

Going by SKILL.md and its folder, Workflow Patterns needs the command-line tools its instructions call (git and gh).

Does Workflow Patterns access the network?

SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

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

Workflow Patterns 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 Workflow Patterns use?

About 827 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 Patterns?

Skills that share tags, products or a category with Workflow Patterns: Deep Research Agent Team (Imbad0202/academic-research-skills, 51k stars), Hunk Extension Authoring Map (modem-dev/hunk, 9.5k stars), Net Deep Research (h4444433333/net-deep-research, 123 stars) and Architect Research (DanMcInerney/architect-loop, 626 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workflow Patterns?

QuintinShaw (a GitHub user) maintains it in QuintinShaw/pi-dynamic-workflows, which has 554 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 6, 2026.

Source: QuintinShaw/pi-dynamic-workflows on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.