tx-workflow

Automate task pick-up, execution, and dependency handling with tx commands.

6|3|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/jamesaphoenix/tx --skill tx-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tx-workflow
Source: https://github.com/jamesaphoenix/tx/tree/main/apps/cli/src/templates/claude/skills/tx-workflow
Command: npx skills add https://github.com/jamesaphoenix/tx --skill tx-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow helps engineering teams coordinate task pickup, progress, and dependency-aware execution within the tx platform, reducing blockers and handoffs.

Core Features & Use Cases

  • Picking Up a Task: fetch the next unblocked task with tx ready and inspect details with tx show.
  • Working on a Task: understand requirements, check learnings, set shared context when needed, and implement changes.
  • Completing a Task: run targeted tests and mark the task done to unlock dependents.
  • Creating Sub-tasks: split large work into manageable subtasks with parent-child relationships.
  • Managing Dependencies: declare and remove blocking edges to control task sequencing.
  • Recording Learnings: capture knowledge to memory for future reuse.

Quick Start

Start by running tx ready --limit 1 --json to fetch the next task, inspect it with tx show, and begin work following the workflow guidelines.

Frequently Asked Questions about tx-workflow

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

FAQPage Schema
How do I coordinate task dependencies and workflow automatically in tx?

Task workflow coordination in tx is automated by picking up unblocked tasks, executing work, and managing dependency edges to control sequencing. This ensures deterministic task progression and reduces blockers across engineering teams.

What is the best way to decompose large tasks into sub-tasks in tx?

Sub-task decomposition in tx splits large work into manageable pieces by creating parent-child relationships. This allows engineering teams to track progress on smaller components while maintaining visibility across the overall project.

How does dependency tracking work for task sequencing in tx?

Dependency tracking in tx works by declaring and removing blocking edges between tasks. Marking a task complete automatically unlocks its dependents, ensuring work proceeds only when prerequisite tasks are finished.

Can I link PRDs and record learnings within the tx task workflow?

Yes, tx task orchestration supports PRD linking for requirements tracing and recording learnings to memory for future reuse. This captures knowledge generated during task execution for subsequent project iterations.

How do I fetch the next available task in tx without hitting blockers?

Fetch the next unblocked task by running tx ready --limit 1 --json, then inspect details with tx show. This workflow guarantees you only pick up tasks whose dependencies are resolved and ready for execution.

When should I manually remove blocking edges in tx task management?

Manually remove blocking edges in tx task management when a declared dependency becomes irrelevant or is resolved outside the workflow. This prevents artificial blockers from halting dependent tasks and keeping them in an unblocked state.