resolve-blocker

Resolve blockers for blocked stories with human approval and journal documentation.

13|1|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/Roeia1/SAGA --skill resolve-blocker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: resolve-blocker
Source: https://github.com/Roeia1/SAGA/tree/main/plugin/skills/resolve-blocker
Command: npx skills add https://github.com/Roeia1/SAGA --skill resolve-blocker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineering teams unblock blocked stories by diagnosing the blocker, coordinating a resolution with human approval, and documenting decisions in the story journal.

Core Features & Use Cases

  • Disambiguates blockers when multiple stories match and prompts for selection.
  • Locates and reads the relevant story and journal context to surface the blocker details.
  • Proposes multiple resolution options with implementation guidance and rationale.
  • Records approved resolutions into the journal to resume work and maintain traceability.
  • Supports guided execution of blockers within the SAGA workflow.

Quick Start

Invoke /resolve-blocker with a Story ID to begin resolving a blocker.

Frequently Asked Questions about resolve-blocker

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

FAQPage Schema
How do I resolve a blocker on a blocked story to resume progress?

To resolve a blocker, invoke the resolve-blocker prompt with a Story ID. The skill reads story context and journal entries, proposes resolution options with implementation guidance, and requires explicit human approval before recording the resolution.

What happens when multiple stories match the blocker resolution request?

When multiple stories match, the skill disambiguates blockers by prompting you to select the correct story. It then locates and reads the relevant story and journal context to surface the specific blocker details before proposing resolutions.

How are resolution decisions documented for traceability after unblocking a story?

Resolution decisions are documented by recording approved resolutions directly into the story journal. This maintains traceability and resumes work by ensuring the blocker diagnosis and chosen implementation guidance are persisted.

Do I need access to worktrees and story files to run the blocker resolution process?

Yes, you need access to worktrees and story or journal files. The skill requires these to read story context, surface blocker details, and record approved resolutions back into the journal within the SAGA workflow.

Can I execute a blocker resolution without explicit human approval?

No, explicit human approval is enforced before recording any resolution. The skill guides users through choosing a resolution with implementation guidance and rationale, but a human must approve the action before it is documented.

What implementation guidance is provided when resolving a story blocker?

Implementation guidance includes multiple proposed resolution options with rationale. The skill analyzes story context and journal entries to offer specific, actionable steps for unblocking the story and resuming progress.