unit-executor

Execute a single runnable unit from a CSV task list, updating statuses.

497|38|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill unit-executor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unit-executor
Source: https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/unit-executor
Command: npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill unit-executor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures that complex research workflows are executed step-by-step, allowing for auditing, interruption, and precise control over each individual task.

Core Features & Use Cases

  • Atomic Execution: Guarantees that only one unit is processed at a time, preventing unintended parallel execution.
  • Dependency Management: Automatically identifies and executes the next runnable unit based on defined dependencies.
  • Status Tracking: Updates the status of units in UNITS.csv (TODO, DOING, DONE, BLOCKED) and optionally STATUS.md.
  • Use Case: When running a multi-stage research pipeline, this skill ensures that each stage completes successfully and its status is accurately recorded before the next stage is considered, allowing you to pause and resume the pipeline at any point.

Quick Start

Run the next available unit in the current workspace.

Frequently Asked Questions about unit-executor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I execute a single task unit from a CSV file while managing dependencies?

To execute a single task unit from a CSV file, this Skill processes one runnable unit at a time, automatically checking dependencies and updating statuses in UNITS.csv to ensure atomic execution of your pipeline stages.

What is atomic execution in a multi-stage pipeline and how does it prevent parallel tasks?

Atomic execution in a multi-stage pipeline guarantees only one unit is processed at a time, preventing unintended parallel execution. It ensures each stage completes and its status is recorded before the next stage is considered.

How do I update task statuses like TODO, DOING, and DONE in a research workflow?

You can update task statuses like TODO, DOING, and DONE by running this executor within your workspace directory. It automatically updates UNITS.csv and optionally STATUS.md as it progresses through the pipeline states.

Can I pause and resume a multi-stage research workflow if a unit is blocked?

Yes, you can pause and resume a multi-stage research workflow at any point. This Skill handles blocking conditions like HUMAN checkpoints, marking units as BLOCKED so you can safely resume execution later.

How does pipeline dependency management handle acceptance criteria for produced artifacts?

Pipeline dependency management checks acceptance criteria against produced artifacts after executing a unit. If criteria are not met, it updates the status accordingly to maintain precise control over workflow progression.