BB

bb-create-issue

Creates a labeled handoff protocol for agents to track design artifacts and tasks.

Install

mkdir -p .claude/skills/bb-create-issue && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14431" && unzip -o skill.zip -d .claude/skills/bb-create-issue && rm skill.zip

Installs to .claude/skills/bb-create-issue

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Babel internal issue protocol — create a labeled handoff between pipeline agents. Writes designs/<name>/.handoff/<label>.md and appends to handoff_log.jsonl; best-effort gh issue create if gh available. Triggered by every guru/architect agent at handoff time.
259 charsno explicit “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Beginner

Key capabilities

  • →Create labeled handoff markdown files for pipeline agents
  • →Append handoff details to a JSONL log file
  • →Attempt to create a GitHub issue if `gh` CLI is available
  • →Derive design name from artifact path if not provided
  • →Return output contract with artifact path, log path, and GitHub issue URL

How it works

This skill writes a markdown file with handoff details, appends a log entry to a JSONL file, and attempts to create a GitHub issue. It derives the design name if not explicitly provided.

Inputs & outputs

You give it
Label, artifact path, optional body file, correlation ID, design name, and summary
You get back
Handoff markdown file, updated JSONL log, and optionally a GitHub issue URL

When to use bb-create-issue

  • →Handing off RTL for verification
  • →Logging synthesis status
  • →Escalating issues to the user

About bb-create-issue

This skill standardizes internal handoffs by logging artifacts and creating issues for pipeline transitions like synthesis or verification.

Babel internal issue protocol — create a labeled handoff between pipeline agents. Writes designs/<name>/.handoff/<label>.md and appends to handoff_log.jsonl; best-effort gh issue create if gh available. Triggered by every guru/architect agent at handoff time.

When not to use it

  • →When a handoff is not between pipeline agents
  • →When a GitHub issue is not desired or the `gh` CLI is unavailable
  • →When the label is not part of the allow-list

Limitations

  • →The `gh issue create` is a best-effort attempt and may not always succeed
  • →The label must be one of the predefined allow-list values
  • →Failure to derive `design_name` will result in an error and exit

How it compares

This skill standardizes the creation and logging of handoffs across pipeline agents and integrates with GitHub issues, providing a structured approach compared to manual documentation.

Compared to similar skills

bb-create-issue side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
bb-create-issue (this skill)06moReviewBeginner
linear-ci-integration14moCautionIntermediate
regression05moReviewAdvanced
dev-release05moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry