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
Ready-to-paste message
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-opsOr download just the file:
curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/project-flow-ops/SKILL.md -o SKILL.mdTechnical 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
Comments
- …
More skills from this repository
accessibility
Helps your agent create interfaces that everyone can use. Ensures websites and apps work well for people with disabilities, like those who are blind or have reduced mobility.
affaan-m/ECC
agent-architecture-audit
Makes your agent check if everything is working correctly. It finds and fixes problems in AI systems, ensuring they perform as expected.
affaan-m/ECC
agent-eval
Helps your agent compare different AI coding tools. It measures which one is faster, cheaper, and more reliable for specific tasks.
affaan-m/ECC
agent-harness-construction
Makes your agent better understand how to perform tasks. It optimizes the tools and instructions the agent uses to increase its chances of success.
affaan-m/ECC
Similar skills
context-engineering
Optimizes the initial setup and rules for the agent. It's useful for ensuring the agent has the right context to perform tasks efficiently and with quality.
addyosmani/agent-skills
doubt-driven-development
Questions all important decisions before they are made. It's useful when accuracy is crucial, to ensure there are no hidden flaws and that the plan is robust.
addyosmani/agent-skills
idea-refine
Transforms vague ideas into clear, actionable plans. Helps think through different options and choose the best path forward.
addyosmani/agent-skills