work

Execute Linear Work Units with a disciplined TDD workflow and MCP-integrated progress tracking.

Updated Jan 21, 2026
One-click install
npx skills add https://github.com/lixxz/claude-workflow --skill work-lixxz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: work
Source: https://github.com/lixxz/claude-workflow/tree/main/skills/work
Command: npx skills add https://github.com/lixxz/claude-workflow --skill work-lixxz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured, repeatable approach to executing a Linear Work Unit using a disciplined TDD workflow, ensuring validation, testing, implementation, verification, and documentation updates are performed consistently.

Core Features & Use Cases

  • Enforces a stepwise workflow: validate, test, implement, verify, and update.
  • Integrates with Linear MCP server for issue state transitions and evidence collection.
  • Emphasizes minimal documentation in the repo; decisions and learnings are captured via Linear comments and issue updates.

Quick Start

Run /work BHU-140 to execute the Work Unit in the current repository.

Frequently Asked Questions about work

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

FAQPage Schema
How do I automate Linear Work Unit execution with TDD?

Automate Linear Work Unit execution with TDD by applying a structured workflow that validates issues, writes Gherkin tests, implements code, verifies deterministically, and updates Linear via MCP server.

What is the workflow for executing a Linear issue using test-driven development?

The workflow for executing a Linear issue using TDD follows a stepwise process: validate the issue, write tests, implement code, verify behavior, and update documentation and Linear issue states.

Do I need the Linear MCP server to run TDD-based issue management?

Yes, you need the Linear MCP server to run TDD-based issue management, as it provides the mcp__linear-server__* tools required for issue state transitions and evidence collection.

How do I track progress and decisions when completing Linear Work Units?

Track progress and decisions when completing Linear Work Units by capturing learnings and evidence directly through Linear comments and issue updates, keeping repository documentation minimal.

Can I use Gherkin specifications to verify Linear Work Unit outcomes?

Yes, you can use Gherkin specifications to verify Linear Work Unit outcomes, as the workflow applies Gherkin-based specifications to drive deterministic validation and traceable decisions.