# workflow-automation

workflow-automation is a Claude Code subagent that creates and updates GitHub Actions workflows. It handles CI/CD setup requests and workflow run analysis.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/agentic-flow/.claude/agents/github/workflow-automation.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/workflow-automation

## What it does

workflow-automation creates or updates GitHub Actions workflows, lists them, retrieves run details, and can dispatch a workflow. Its available tools also include bottleneck analysis and task coordination across agents.

A pre-run hook searches for related patterns with `npx agentdb-cli` and records task data. Afterward, another hook stores the output and metrics; successful work with a reward above `0.9` triggers `npx claude-flow neural train`. Those commands need to be available for the hooks to run.

For Claude Code, add `.claude/agents/workflow-automation.md` to the project. Codex uses `.codex/agents/workflow-automation.toml`; Cursor uses `.cursor/agents/workflow-automation.md`.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/workflow-automation.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/workflow-automation.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/workflow-automation.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ruvnet/agentic-flow/tree/HEAD/agentic-flow/.claude/agents/github/workflow-automation.md

## When to use it
- create a GitHub Actions workflow for a project
- update an existing workflow
- retrieve workflow runs and their results
- find bottlenecks in a CI/CD workflow

## Example prompts
- Create a GitHub Actions workflow to build and test this project.
- List the existing workflows and show their latest run results.
- Find bottlenecks in our CI/CD workflows and suggest optimizations.

## Similar
- [github-automation](https://affpapa.org/en/nevibecode/skills/github-automation.md) — skill · 63 installs
- [github-workflow-automation](https://affpapa.org/en/nevibecode/skills/sickn33-github-workflow-automation.md) — skill · 1500 installs
- [self-improvement-ci](https://affpapa.org/en/nevibecode/skills/self-improvement-ci.md) — skill · 550 installs
- [pr-create](https://affpapa.org/en/nevibecode/skills/pr-create.md) — skill · 807 installs
- [golang-continuous-integration](https://affpapa.org/en/nevibecode/skills/golang-continuous-integration.md) — skill · 41500 installs
- [github-actions](https://affpapa.org/en/nevibecode/skills/github-actions.md) — skill · 12400 installs

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
