# Workflow Run

> Ejecuta un workflow: gestiona el ciclo de vida de un workflow MCP (ejecutar/pausar/reanudar/cancelar) o invoca y reanuda una orquestación nativa .claude/workflows/*.js con la herramienta Workflow.

Fuente: https://skillsagentes.com/skills/ruvnet/ruflo/workflow-run
Markdown: https://skillsagentes.com/skills/ruvnet/ruflo/workflow-run.md

Repositorio: https://github.com/ruvnet/ruflo
Autor: ruvnet
Licencia: MIT
Actualizado: el mes pasado
Coste de contexto: 42 tok instalada, 635 tok al activarse, 635 tok con todos los archivos del bundle
Bundle: 1 archivo, 2 KB
Permisos que pide: mcp__plugin_ruflo-core_ruflo__workflow_execute mcp__plugin_ruflo-core_ruflo__workflow_run mcp__plugin_ruflo-core_ruflo__workflow_pause mcp__plugin_ruflo-core_ruflo__workflow_resume mcp__plugin_ruflo-core_ruflo__workflow_cancel mcp__plugin_ruflo-core_ruflo__workflow_status workflow read bash

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add ruvnet/ruflo --skill workflow-run --agent claude-code
# Cursor
npx -y skills add ruvnet/ruflo --skill workflow-run --agent cursor
# Codex
npx -y skills add ruvnet/ruflo --skill workflow-run --agent codex
# Gemini CLI
npx -y skills add ruvnet/ruflo --skill workflow-run --agent gemini
# Windsurf
npx -y skills add ruvnet/ruflo --skill workflow-run --agent windsurf
# Cline
npx -y skills add ruvnet/ruflo --skill workflow-run --agent cline
```

## Qué hace

- Ejecuta y controla el ciclo de vida de un workflow MCP: execute, status, pause, resume y cancel.
- Soporta modos de ejecución secuencial, paralelo, condicional y de aprobación manual.
- Ejecuta workflows nativos .claude/workflows/*.js con la herramienta Workflow, incluyendo reanudación desde un runId.

## Cuándo usarla

- Necesitas ejecutar una definición de workflow persistida y controlar su ciclo de vida (pausar, reanudar, cancelar).
- Necesitas un fan-out determinista de subagentes mediante un workflow nativo .claude/workflows/*.js.

## Qué la activa

- "Ejecuta el workflow con id X y muéstrame su estado"
- "Pausa el workflow actual en el paso en curso"
- "Corre el workflow nativo plugin-contract-audit con el argumento ruflo-agentdb"

## Archivos

- SKILL.md — 2 KB

## SKILL.md

Reproducido tal cual desde ruvnet/ruflo bajo MIT. Esta sección es el documento original y está en inglés.

# Workflow Run

Run and manage a workflow on either surface.

## A — MCP workflow lifecycle

When you need to run a persisted definition and control its lifecycle (pause/resume/cancel):

1. **Execute** — call `mcp__plugin_ruflo-core_ruflo__workflow_execute` or `mcp__plugin_ruflo-core_ruflo__workflow_run` with the workflow ID
2. **Monitor** — call `mcp__plugin_ruflo-core_ruflo__workflow_status` to check progress and step outcomes
3. **Pause** — call `mcp__plugin_ruflo-core_ruflo__workflow_pause` to halt at the current step
4. **Resume** — call `mcp__plugin_ruflo-core_ruflo__workflow_resume` to continue from where paused
5. **Cancel** — call `mcp__plugin_ruflo-core_ruflo__workflow_cancel` to abort the workflow

Execution modes: **sequential**, **parallel** (independent steps), **conditional** (branch on outcome), **manual gate** (pause for human approval).

## B — Native `.claude/workflows/*.js`

When you need a deterministic subagent fan-out, run a named native workflow with the `Workflow` tool. The named workflows are the `meta.name` of each `.claude/workflows/*.js` file (list them with `/workflow` or `ls .claude/workflows/`).

```js
Workflow({ name: 'plugin-contract-audit' })                    // run a named workflow
Workflow({ name: 'plugin-contract-audit', args: 'ruflo-agentdb' })  // pass args → the script's `args` global
Workflow({ scriptPath: '.claude/workflows/foo.js' })           // run a script by path
Workflow({ scriptPath, resumeFromRunId: 'wf_…' })              // resume — unchanged agent() calls return cached
```

Notes:
- A native workflow runs in the background; you are notified on completion (don't poll). Watch live progress with `/workflows`.
- Pause/resume here is **journal-based** (`resumeFromRunId`), not the MCP state machine. Stop a run first, then resume from its `runId`.
- To author a new native workflow, use the `workflow-create` skill.

See [ADR-0002](../../docs/adrs/0002-native-workflow-orchestration.md).

## Dónde encaja

- Categoría: [Automatización](https://skillsagentes.com/categorias/automatizacion.md) — Flujos de varios pasos que se ejecutan sin supervisión.
- Creador: [ruvnet](https://skillsagentes.com/creators/ruvnet.md) — 275 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Harness Gepa](https://skillsagentes.com/skills/ruvnet/ruflo/harness-gepa.md): Inspecciona y audita genomas GEPA: carga y valida un genoma, renderiza el system prompt que compila, o clasifica los modos de fallo de una transcripción de ejecución.
- [Deepseek Reason](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-reason.md): Completion en modo razonamiento contra deepseek-reasoner (R1) de DeepSeek. Devuelve el chain-of-thought por separado de la respuesta final. Lee DEEPSEEK_API_KEY y degrada si falta o la API no responde.
- [Deepseek Chat](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-chat.md): Completion de un solo turno contra el modelo deepseek-chat de DeepSeek vía /v1/chat/completions. Lee DEEPSEEK_API_KEY y degrada con status:degraded si falta o la API no responde. Para tareas sin razonamiento.
- [Adr Index](https://skillsagentes.com/skills/ruvnet/ruflo/adr-index.md): Construye o reconstruye el índice de ADRs y su grafo de dependencias ejecutando scripts/import.mjs, en vez de cientos de llamadas MCP.
- [Agntcy Status](https://skillsagentes.com/skills/ruvnet/ruflo/agntcy-status.md): Muestra el estado de la integración AGNTCY/SLIM/CASA: si los paquetes están instalados, qué transporte está activo y si el enforcement de CASA está habilitado.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)