Agent skill

deps

Visualize and analyze issue dependencies in Linear. Finds blocking chains, circular dependencies, and critical path items.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/alienfast/claude/tree/main/skills/deps

SKILL.md

Deps Skill - Dependency Analysis

You are an expert at analyzing and visualizing software project dependencies.

When to Use

Use this skill when:

  • Understanding what's blocking an issue
  • Planning work order
  • Identifying circular dependencies
  • Finding critical path items

Process

  1. Visualize Dependencies

    bash
    linear deps ENG-100
linear deps --team ENG

  2. Analyze Blocking Chains

    • Find longest blocking chains
    • Identify bottleneck issues
    • Locate circular dependencies

  3. Recommend Actions

Dependency Types

Type Meaning Example
blocks A must complete before B Auth blocks Login UI
blocked_by B cannot start until A done Login UI blocked by Auth
related Informational link Two related features
duplicate Same issue Close one, reference other

Visualization Output

DEPENDENCY GRAPH: ENG-100
════════════════════════════════════════
ENG-100 User Authentication Epic
├─ ENG-101 Login flow [In Progress]
│  ├─ ENG-103 OAuth integration [Todo]
│  │     → blocks: ENG-105
│  └─ ENG-104 Session management [Todo]
├─ ENG-102 Logout flow [Blocked]
│     ← blocked by: ENG-101
└─ ENG-105 Token refresh [Blocked]
      ← blocked by: ENG-103
────────────────────────────────────────
5 issues, 4 dependencies, 0 cycles

Analysis Areas

Blocking Chains

Issues that block many other issues are critical:

Critical blocker: ENG-101
  → blocks 3 issues directly
  → blocks 5 issues transitively

Circular Dependencies

Cycles prevent any issue from completing:

⚠ Circular dependency detected:
  ENG-201 → ENG-202 → ENG-203 → ENG-201

Critical Path

Longest dependency chain determines minimum completion time:

Critical path (4 issues):
  ENG-100 → ENG-101 → ENG-103 → ENG-105
Minimum time: 4 issue completion times

Orphaned Dependencies

Issues referencing non-existent or closed issues:

⚠ Orphaned dependencies:
  ENG-150 blocked by ENG-099 (closed)

Commands Used

bash
# Single issue dependencies
linear deps ENG-100

# Team-wide dependencies
linear deps --team ENG

# Check what blocks an issue
linear issues blocked-by ENG-100

# Check what an issue blocks
linear issues blocking ENG-100

# Create a dependency
linear issues update ENG-102 --blocked-by ENG-101

# Remove a dependency (update with empty)
linear issues update ENG-102 --blocked-by ""

Discovery Commands (NEW)

Use search to discover dependency-related issues:

bash
# Find all blocked issues (useful for prioritizing unblocking work)
linear search --has-blockers --team ENG

# Find issues blocked by a specific issue
linear search --blocked-by ENG-100

# Find issues blocking a specific issue
linear search --blocks ENG-100

# Find circular dependencies
linear search --has-circular-deps --team ENG

# Find complex dependency chains
linear search --max-depth 5 --team ENG

Pro tip: Use /link-deps skill to discover and establish missing dependencies across your backlog.

Action Recommendations

Based on analysis, recommend:

  1. Unblock critical path - Prioritize blockers
  2. Break cycles - Remove unnecessary dependencies
  3. Parallelize - Find work that can happen concurrently
  4. Update stale deps - Clean up outdated relationships

Best Practices

  1. Keep dependencies minimal - Only add necessary ones
  2. Use blocks, not blocked_by - Clearer mental model
  3. Review regularly - Dependencies become stale
  4. Document non-obvious deps - Add comments explaining why

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

alienfast/claude

triage

Triage and prioritize Linear backlog. Analyzes issues for staleness, blockers, and suggests priorities based on dependencies and capacity.

0 0
Explore
alienfast/claude

link-deps

Discover and link related issues as dependencies. Searches for issues that should be connected and recommends dependency relationships to establish proper work order.

0 0
Explore
alienfast/claude

Deprecation Handler

Handles deprecated APIs, types, and modules by applying safe migration patterns. Use when encountering deprecation warnings, migrating from deprecated code, updating dependencies with breaking changes, or modernizing legacy code to use current APIs.

0 0
Explore
alienfast/claude

cycle-plan

Plan Linear cycles using velocity analytics. Suggests scope based on historical capacity, identifies dependency risks, balances workload.

0 0
Explore
alienfast/claude

Dependency Updater

Orchestrates comprehensive dependency updates by delegating research, impact analysis, code changes, and validation to specialized agents. Invoked when users request package updates, dependency updates, version bumps, or mention 'ncu' or npm-check-updates.

0 0
Explore
alienfast/claude

linear

Linear issue tracking - MUST READ before using Linear commands

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results