Skip to content

aspiers/ai-config / .agents/skills/beads-blocker-review

beads-blocker-review

Verified

Review every Beads issue waiting on a person, one at a time, using the interactive questionnaire UI rather than plain-text prompts. Use when asked to go through blockers, clear the human queue, answer beads waiting on the user, triage `bd human list`, or unblock agent work that needs a decision.

FileKindSize
SKILL.mdskill md9.2 KB
scripts/list-actionable-human-beads.pyexecutablescript2.9 KB

scripts/list-actionable-human-beads.py

View on GitHub
#!/usr/bin/env python3
"""Partition open human-labelled Beads issues by current readiness."""

from __future__ import annotations

import argparse
import json
import shutil
import subprocess
from json import JSONDecodeError
from typing import Any, Sequence


def read_issues(arguments: Sequence[str]) -> list[dict[str, Any]]:
    """Run a Beads JSON query and return its issue list."""
    resolved_bd_command = shutil.which("bd")
    if resolved_bd_command is None:
        raise RuntimeError("Beads command not found: bd")

    command = [resolved_bd_command, *arguments, "--json"]
    result = subprocess.run(
        command,
        check=False,
        capture_output=True,
        text=True,
    )
    if result.returncode:
        detail = result.stderr.strip() or f"exit status {result.returncode}"
        raise RuntimeError(f"{' '.join(command)} failed: {detail}")

    try:
        issues = json.loads(result.stdout)
    except (JSONDecodeError,):
        raise RuntimeError(f"{' '.join(command)} returned invalid JSON") from None

    # An empty queue is a normal state, but bd is inconsistent about how it says
    # so: `bd human list` emits a bare `null` while `bd ready` emits `[]`.
    if issues is None:
        return []

    if not isinstance(issues, list) or not all(
        isinstance(issue, dict) and isinstance(issue.get("id"), str)
        for issue in issues
    ):
        raise RuntimeError(f"{' '.join(command)} returned an invalid issue list")

    return issues


def partition_human_issues(
    human_issues: Sequence[dict[str, Any]],
    ready_issues: Sequence[dict[str, Any]],
) -> dict[str, Any]:
    """Split human-owned issues using Beads' authoritative ready result."""
    ready_ids = {issue["id"] for issue in ready_issues}
    actionable = [issue for issue in human_issues if issue["id"] in ready_ids]
    waiting = [issue for issue in human_issues if issue["id"] not in ready_ids]
    return {
        "counts": {
            "actionable": len(actionable),
            "waiting": len(waiting),
        },
        "actionable": actionable,
        "waiting": waiting,
    }


def parse_arguments() -> argparse.Namespace:
    parser = argparse.ArgumentParser(
        description=(
            "List open human-labelled Beads issues, separating currently "
            "actionable questions from issues waiting on prerequisites."
        )
    )
    parser.add_argument(
        "--compact",
        action="store_true",
        help="emit compact rather than indented JSON",
    )
    return parser.parse_args()


def main() -> int:
    arguments = parse_arguments()
    human_issues = read_issues(["human", "list"])
    ready_issues = read_issues(
        ["ready", "--label=human", "--limit=0", "--brief"]
    )

    result = partition_human_issues(human_issues, ready_issues)
    indent = None if arguments.compact else 2
    print(json.dumps(result, indent=indent, sort_keys=True))
    return 0


if __name__ == "__main__":
    raise SystemExit(main())
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall