Blocker Detection Skill
Overview
This skill helps identify and resolve blockers before they derail projects.
What Counts as a Blocker?
- •Explicit blockers - Issues labeled "blocked" or with blocking dependencies
- •Stalled work - Items with no updates for 7+ days
- •Missing dependencies - Waiting on external input, decisions, or other work
- •Resource constraints - Not enough people or time assigned
Instructions
1. Detecting Blockers
Use these tools in order:
- •
get_linear_issues(filter: "blockers")- Explicitly blocked items - •
get_linear_issues(filter: "stalled")- Work that stopped moving - •
search_memories(query: "blocked waiting dependency")- Historical context
2. Analyzing a Blocker
For each blocker, identify:
- •What's blocked: The ticket/PR/item
- •Why it's blocked: Dependency, decision, resource, external
- •How long: Days blocked
- •Who can unblock: Person or team
- •Impact: What else is affected
3. Suggesting Resolution
Always provide actionable next steps:
- •Who should be contacted
- •What decision needs to be made
- •Offer to add comments or escalate
Blocker Types
| Type | Signs | Resolution |
|---|---|---|
| Dependency | "waiting on X", linked issue | Escalate to owner of X |
| Decision | "need to decide", "TBD" | Identify decision maker |
| Resource | Unassigned, overloaded owner | Reassign or add capacity |
| External | Third-party, API, approval | Escalate, find workaround |
| Technical | Bug, infrastructure issue | Get engineering help |
Example Response
code
3 Active Blockers: 1. **ABC-123** blocked 5 days - Waiting on security review - @security-team can unblock - Suggested: Ping in #security-reviews? 2. **DEF-456** stalled 8 days - No activity, assignee @mike - May be forgotten - Suggested: Check if still needed? 3. **GHI-789** blocked by dependency - Waiting on ABC-100 - ABC-100 is 80% complete - Should unblock in ~2 days **Suggested actions:** 1. Escalate security review 2. Check in with Mike 3. Monitor ABC-100 progress