Skip to content
Skillpedia
Tasks & projects280k · #260

project-flow-ops

Helps your agent manage workflow between GitHub and Linear. It organizes issues and pull requests to keep everything in order.

What it does

This tool helps manage work between GitHub (public code) and Linear (internal task management). It decides what to do with GitHub issues and pull requests, like merging, rebuilding, or closing them, and keeps both systems in sync.

When to use it

  • ✓Organizing a backlog of GitHub tasks.
  • ✓Deciding if an item needs Linear tracking or should stay GitHub-only.
  • ✓Linking active GitHub work to internal planning in Linear.

Example of what to ask your AI

“Triage the open PR backlog and tell me what to merge versus what needs to be rebuilt.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/affaan-m/ECC/blob/main/skills/project-flow-ops/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/affaan-m/ECC/blob/main/skills/project-flow-ops/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

The tool first checks the status of work on GitHub (who authored it, comments, tests). Then, it classifies each item (merge, rebuild, close, or park) and decides if it needs to be tracked in Linear, creating or updating tasks there if necessary.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add affaan-m/ECC --skill project-flow-ops

Or download just the file:

curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/project-flow-ops/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Project Flow Ops

This skill turns disconnected GitHub issues, PRs, and Linear tasks into one execution flow.

Use it when the problem is coordination, not coding.

When to Use

  • Triage open PR or issue backlogs
  • Decide what belongs in Linear vs what should remain GitHub-only
  • Link active GitHub work to internal execution lanes
  • Classify PRs into merge, port/rebuild, close, or park
  • Audit whether review comments, CI failures, or stale issues are blocking execution

Operating Model

  • GitHub is the public and community truth
  • Linear is the internal execution truth for active scheduled work
  • Not every GitHub issue needs a Linear issue
  • Create or update Linear only when the work is:
    • active
    • delegated
    • scheduled
    • cross-functional
    • important enough to track internally

Core Workflow

1. Read the public surface first

Gather:

  • GitHub issue or PR state
  • author and branch status
  • review comments
  • CI status
  • linked issues

2. Classify the work

Every item should end up in one of these states:

State Meaning
Merge self-contained, policy-compliant, ready
Port/Rebuild useful idea, but should be manually re-landed inside ECC
Close wrong direction, stale, unsafe, or duplicated
Park potentially useful, but not scheduled now

3. Decide whether Linear is warranted

Create or update Linear only if:

  • execution is actively planned
  • multiple repos or workstreams are involved
  • the work needs internal ownership or sequencing
  • the issue is part of a larger program lane

Do not mirror everything mechanically.

4. Keep the two systems consistent

When work is active:

  • GitHub issue/PR should say what is happening publicly
  • Linear should track owner, priority, and execution lane internally

When work ships or is rejected:

  • post the public resolution back to GitHub
  • mark the Linear task accordingly

Review Rules

  • Never merge from title, summary, or trust alone; use the full diff
  • External-source features should be rebuilt inside ECC when they are valuable but not self-contained
  • CI red means classify and fix or block; do not pretend it is merge-ready
  • If the real blocker is product direction, say so instead of hiding behind tooling

Output Format

Return:

PUBLIC STATUS
- issue / PR state
- CI / review state

CLASSIFICATION
- merge / port-rebuild / close / park
- one-paragraph rationale

LINEAR ACTION
- create / update / no Linear item needed
- project / lane if applicable

NEXT OPERATOR ACTION
- exact next move

Good Use Cases

  • "Audit the open PR backlog and tell me what to merge vs rebuild"
  • "Map GitHub issues into our ECC 1.x and ECC 2.0 program lanes"
  • "Check whether this needs a Linear issue or should stay GitHub-only"
FAQ

When should I use Linear versus just GitHub?

Use Linear for active, scheduled work that needs internal tracking by multiple people or teams. GitHub is for everything public or that doesn't require detailed internal follow-up.

What does 'classify' the work mean?

It means deciding the fate of each item: 'Merge' if it's ready, 'Port/Rebuild' if the idea is good but needs internal adaptation, 'Close' if it's no longer relevant or incorrect, or 'Park' if it's useful but not for now.

Will the tool automatically create Linear tasks for everything on GitHub?

No. It only creates or updates Linear tasks if the work is active, delegable, scheduled, and important enough for internal tracking.

Details

Original description by the author

Operate execution flow across GitHub and Linear by triaging issues and pull requests, linking active work, and keeping GitHub public-facing while Linear remains the internal execution layer. Use when the user wants backlog control, PR triage, or GitHub-to-Linear coordination.

repo: affaan-m/ECC

Popularity

GitHub stars
280k
Ranking position
#260
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills