organize-linear-tasks

Audits OpenMates Linear backlog for ghost tasks, staleness, duplicates, and unclear metadata.

43|2|Updated Jan 25, 2024
One-click install
npx skills add https://github.com/glowingkitty/OpenMates --skill organize-linear-tasks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: organize-linear-tasks
Source: https://github.com/glowingkitty/OpenMates/tree/main/.agents/skills/organize-linear-tasks
Command: npx skills add https://github.com/glowingkitty/OpenMates --skill organize-linear-tasks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, git, python3.

What problem does it solve?

It prevents Linear workspaces from degrading into stale, duplicated, or misleading tasks by auditing open items against recent git activity and curated metadata.

Core Features & Use Cases

  • Ghost task detection and closure: Finds tasks that appear completed in code (based on commit references) but remain open in Linear, then offers to mark them Done.
  • Stale and label hygiene cleanup: Identifies old tasks with no recent activity and removes or corrects incorrect labels to keep reporting trustworthy.
  • De-duplication and clarification: Surfaces likely duplicates for merge/relate decisions and flags unclear tasks whose titles/descriptions need rewriting or deletion.

Quick Start

Use the organize-linear-tasks skill to audit the weekly OpenMates Linear backlog by running it with a specific section when you want to resume progress, for example: "organize-linear-tasks --section 3".

Frequently Asked Questions about organize-linear-tasks

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

FAQPage Schema
How do I clean up stale Linear tasks by cross-referencing git commit history?

Linear backlog audits detect ghost tasks by cross-referencing recent git activity against open issues, then offers to mark code-completed items as Done. It also flags stale tickets with no recent activity for removal or metadata correction.

What is the best way to deduplicate and audit a Linear backlog?

A Linear backlog audit surfaces likely duplicate issues for merge or relate decisions and flags unclear tasks needing rewritten titles or descriptions. Interactive approvals are required per cleanup stage before applying deletions or updates via GraphQL.

Can I resume a Linear task triage session from a specific section if I stop midway?

Yes, Linear task triage supports resumable sectioning, allowing you to resume progress by specifying a section argument. This enables weekly maintenance across Todo, In Progress, Backlog, In Review, and Done states.

Do I need curl, git, and python3 installed to audit Linear issues?

Yes, auditing Linear issues requires curl, git, and python3 dependencies. The audit uses git for cross-referencing commit history and python3 for processing batch data gathered from Linear MCP tools to detect ghost tasks and staleness.

Why are some completed Linear tasks still showing as open in my backlog?

Completed tasks remain open in Linear when ghost tasks appear done in code commits but lack corresponding status updates. The audit detects these by cross-referencing recent git activity and offers to mark them Done through GraphQL mutations.