skills.rest
refactory-lang
refactory-langOFFICIAL
Explore all skills by this author →
GitHub

speckit-workflows.bugfix

Create a Git branch and markdown bug report for a bug fix workflow.

Updated Mar 13, 2026
Search Tags:#git#workflow#testing#documentation#spec-kit#bugfix
One-click install
npx skills add https://github.com/refactory-lang/refactory-template --skill speckit-workflows-bugfix
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-workflows.bugfix
Source: https://github.com/refactory-lang/refactory-template/tree/main/.claude/skills/speckit-workflows.bugfix
Command: npx skills add https://github.com/refactory-lang/refactory-template --skill speckit-workflows-bugfix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of a structured bug fix workflow, including a dedicated branch, a bug report, and a clear plan for next steps.

Core Features & Use Cases

  • Automated Branch Creation: Generates a new Git branch for the bug fix.
  • Bug Report Generation: Creates a markdown file to document the bug's details, severity, and analysis.
  • Workflow Initialization: Sets up the initial steps for addressing a bug, including planning and task breakdown.
  • Use Case: When a critical bug is reported, use this Skill to immediately set up the necessary infrastructure to track, document, and begin the fixing process.

Quick Start

Use the speckit.workflows.bugfix skill with the description 'The login button is unresponsive on the staging environment'.

Frequently Asked Questions about speckit-workflows.bugfix

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

FAQPage Schema
How do I create a git branch and bug report for a bug fix workflow?▼

To create a git branch and bug report for a bug fix workflow, use this Skill to automatically initialize a dedicated branch and generate a markdown file documenting the bug details. It parses your bug description to output JSON for naming.

What is a structured bug fix workflow in a spec-kit project?▼

A structured bug fix workflow in a spec-kit project is an automated process that sets up infrastructure to track and document bugs. It generates a dedicated git branch and a detailed markdown bug report to guide subsequent development planning.

How do I initialize a bug tracking process when a critical bug is reported?▼

To initialize a bug tracking process for a critical bug, provide a description of the issue to the Skill. It immediately creates a new git branch and a structured bug report file, establishing the foundation for analysis and task breakdown.

Do I need bash to parse bug details and generate branch names?▼

Yes, you need bash to parse bug details and generate branch names. The Skill requires a bash script to process the provided bug description and generate JSON output, which determines the naming convention for the branch and report file.

Can I document bug severity and analysis within an automated git workflow?▼

Yes, you can document bug severity and analysis within an automated git workflow. The Skill creates a markdown bug report file specifically designed to capture these details, supporting structured documentation alongside the new branch.

Related Skills

Explore More Software Engineering Skills→
refactory-langrefactory-lang

speckit-workflows.baseline

Generate baseline-spec.md and current-state.md from codebase and git history.

Official
Advanced
ricardoalt1515ricardoalt1515

sdd-tasks

Generate structured task breakdowns for SDD changes using Python and Markdown.

Community
Advanced
ApothecaryManApothecaryMan

speckit-specify

Convert natural language feature descriptions into software specifications.

Community
Advanced
BillChiricoBillChirico
5

git-workspace-init

Create an isolated git worktree with conventional branch naming and upstream tracking.

Community
Intermediate