Update Linear Post-Job

Mark child Linear issues as Done and update parent work blocks.

6|1|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/auldsyababua/instructor-workflow --skill update-linear-post-job
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Update Linear Post-Job
Source: https://github.com/auldsyababua/instructor-workflow/tree/main/skills/update-linear-post-job
Command: npx skills add https://github.com/auldsyababua/instructor-workflow --skill update-linear-post-job

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the critical, multi-step process of updating Linear issues after a job is completed. It ensures accurate status tracking, proper parent-child issue management, and clear communication within the Linear workflow, saving manual effort and preventing oversight.

Core Features & Use Cases

  • Child Issue Closure: Marks individual completed jobs (child issues) as "Done" in Linear and adds a detailed completion comment.
  • Parent Work Block Tracking: Automatically checks if all child issues within a parent work block are complete and updates the parent's status accordingly.
  • Error Handling & Reporting: Provides robust error handling for Linear API calls and generates comprehensive completion reports for the Planning Agent.
  • Use Case: After an AI agent finishes a coding task and QA validates it, this skill can automatically update the corresponding Linear issue to "Done," add a summary of changes, and then check if the larger project (parent issue) is also complete, updating it if all sub-tasks are finished.

Quick Start

Update Linear issue 'LAW-5' to "Done" after job completion, then check its parent 'LAW-4' for overall work block completion.

Frequently Asked Questions about Update Linear Post-Job

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

FAQPage Schema
How do I automatically mark Linear issues as Done after a job completes?

Automate Linear issue updates by marking child issues as Done post-job completion. The Skill updates the child issue status, adds a completion comment, checks if all sibling issues in the parent work block are complete, and updates the parent status accordingly—eliminating manual tracking.

Can I use Linear issue automation to track parent-child task hierarchies?

Yes. This Skill manages parent-child Linear issue relationships by updating child statuses, retrieving parent and sibling data via API, assessing overall work block completion, and updating parent issues when all children reach Done status.

What happens when I update a Linear child issue—does the parent update automatically?

After marking a child issue Done, the Skill retrieves the parent issue and all its children, evaluates completion status across siblings, and automatically updates the parent issue if all child issues are complete. This closes work blocks in one operation.

How do I integrate Linear issue updates into a TDD workflow?

The Skill fits into Phase 7 of TDD workflows and work-block scenarios. After a completed task triggers job completion, it performs API calls to sync Linear statuses, verify child completion, update parents, and emit completion notes or error reports back to the Planning Agent.

What error handling does Linear issue automation provide?

The Skill includes robust error handling for Linear API calls, generating comprehensive completion reports and error notifications. This prevents silent failures and ensures the Planning Agent receives accurate status updates or troubleshooting information.

Do I need to manually check if all Linear child issues are done before closing a parent?

No. The Skill automates this check by retrieving all child issues, assessing their Done status, and updating the parent only when all children are complete—eliminating manual verification and preventing premature parent closure.