upstream-a-bead

Orchestrate upstream loom bead workflows with issue-only or issue+pr lanes.

Updated May 3, 2026
One-click install
npx skills add https://github.com/fkberthold/loom --skill upstream-a-bead
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: upstream-a-bead
Source: https://github.com/fkberthold/loom/tree/main/skills/upstream-a-bead
Command: npx skills add https://github.com/fkberthold/loom --skill upstream-a-bead

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill owns the upstream-specific middle of the loom bead lifecycle, bridging loom's local work with upstream contribution activities by handling clone, test, draft artifacts, and watch-bead orchestration. It defers to the bead-lifecycle-shell for core lifecycle actions (claim/isolate/verify/close/capture) and provides two lanes (--issue-only and --issue+pr) to handle filing upstream issues or PRs.

Core Features & Use Cases

  • Owns the upstream-specific middle of the bead lifecycle and coordinates the transition between loom-side work and upstream contribution workflows.
  • Supports two lanes: --issue-only (upstream issue filing) and --issue+pr (upstream clone + RED/GREEN + PR draft), with privacy redaction gates at M6.
  • Integrates with the bead-lifecycle-shell for the shared steps and emits stage markers (designing, cloning, red, green, draft, review, file) to the workflow-state for cold-start recovery.

Quick Start

Start an upstream bead workflow for a specific bead by saying 'let's work upstream-a-bead <bead-id>' and then proceed with the guidance.

Frequently Asked Questions about upstream-a-bead

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

FAQPage Schema
How does privacy redaction work in an upstream PR workflow?▼

The upstream workflow handles PR privacy redaction at the M6 stage gate during the issue+pr lane. It ensures sensitive data is scrubbed before drafting artifacts and filing the upstream contribution.

How do I start an upstream bead workflow for a specific task?▼

A bead lifecycle transition moves upstream work through 7 stages: designing, cloning, red, green, draft, review, and file. The workflow records stage markers in workflow-state to enable cold-start recovery and coordinates lane selection for issue or PR contributions.

Does the upstream workflow support filing issues without a pull request?▼

Start an upstream bead workflow by triggering the skill with a specific bead ID and proceeding with the guided steps. It handles canonical-owner checks, lane selection between issue-only and issue+PR, and coordinates cloning through PR filing automatically.

What are the limitations of automating upstream PR contributions?▼

Upstream workflows support an issue-only lane that handles filing upstream issues independently of pull requests. The alternative issue+pr lane handles upstream cloning, RED/GREEN testing, and PR drafting, allowing lane selection based on contribution scope.

What are the limitations of automating upstream PR contributions?▼

Upstream PR automation defers core lifecycle actions like claim, isolate, verify, close, and capture to the bead-lifecycle-shell. It specifically owns the upstream-specific middle between design and verification, meaning it does not handle the full lifecycle independently.