setup-bb-skills

Configures a repository and issue tracker for BB ticket publishing skills with an approval-gated contract.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/bbenefield89/skills --skill setup-bb-skills-bbenefield89
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-bb-skills
Source: https://github.com/bbenefield89/skills/tree/main/skills/setup-bb-skills
Command: npx skills add https://github.com/bbenefield89/skills --skill setup-bb-skills-bbenefield89

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams adopting the BB ticket publishing skills (create-ticket, ticket-to-spec, spec-to-tasks) need their repository and issue tracker configured consistently, but tracker concepts like tickets, tasks, executors, and release grouping vary by platform and are easy to misconfigure. ## Core Features & Use Cases - Concept Reconciliation: Resolves tracker concepts (ticket, task, agent/human executor, needs-details, release grouping, parent-child, blocking) against existing tracker configuration before any change. - Approval Gate: Presents the complete proposed configuration and every local or external mutation, then waits for explicit approval before writing. - Contract Generation: Writes a confirmed tracker contract to docs/agents/bb-skills.md and adds a single pointer in AGENTS.md or CLAUDE.md. - Use Case: A team adopting spec-to-tasks on a new repository runs this skill to map their tracker's labels and relationships, reconcile existing objects, and record the conventions so ticket publishing works consistently. ## Quick Start Set up this repository and its issue tracker for the BB ticket publishing skills and write the tracker contract.

Frequently Asked Questions about setup-bb-skills

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

FAQPage Schema
How do I set up a repository for the BB ticket publishing skills?

Run the setup-bb-skills skill, which inspects the repository and tracker read-only, resolves every conceptual mapping with your confirmation, and writes a contract to docs/agents/bb-skills.md after you approve the full proposal.

What tracker concepts does the BB skills setup configure?

It maps ticket, task, agent executor, human executor, needs-details, release grouping, task release behavior, parent-child, and blocking concepts to tracker-native mechanisms such as labels, issue types, fields, statuses, or relationships.

Does the setup skill change my issue tracker without approval?

No. It enforces a non-negotiable approval gate: it presents the complete proposed configuration, every local write, and every external mutation, then waits for explicit approval before making any change.

What happens if my tracker cannot support a confirmed mechanism?

The skill reports the gap and asks whether you will configure it manually or approve a textual fallback. It does not claim completion while the contract and tracker disagree.

Where is the BB skills tracker contract stored?

The contract is written to docs/agents/bb-skills.md, and a single concise pointer is added to the existing AGENTS.md or CLAUDE.md file without duplicating sections or altering unrelated instructions.