bug-capture

Convert conversational bug reports into durable GitHub issues written in domain language.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill bug-capture-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-capture
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/bug-capture
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill bug-capture-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? User-reported defects often get lost in chat or get filed as issues full of file paths and function names that go stale after a refactor. This Skill turns a conversational bug report into a well-structured GitHub issue that stays readable and actionable for maintainers over time. ## Core Features & Use Cases - Domain-language issue writing: Explores the codebase in parallel to absorb the project's own vocabulary, then writes issues that read like a maintainer wrote them, with no file paths, line numbers, or function names. - Duplicate detection and breakdown logic: Searches existing issues with gh issue list before filing, and splits multi-failure reports into ordered child issues with honest dependency links. - Structured templates: Enforces reproduction steps, expected vs. actual behavior, and a thirty-second read target on every issue filed via gh issue create. - Use Case: A user says "the import silently drops rows when the CSV has a trailing blank line — log this as a bug." The Skill clarifies minimally, checks for duplicates, and files a scoped issue with reproduction steps, returning the URL. ## Quick Start Report a bug in plain language and ask the assistant to file it as a GitHub issue, for example by saying "capture this: the export button does nothing on the second click."

Frequently Asked Questions about bug-capture

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

FAQPage Schema
How do I file a GitHub issue from a conversation?

Describe the bug in your own words and ask for it to be captured. The Skill asks at most two clarifying questions, checks for duplicates with gh issue list, then files the issue with gh issue create and returns the URL.

How to write bug reports that survive code refactors?

Describe behavior in the project's domain nouns instead of code references. This Skill enforces that rule by banning file paths, line numbers, and function names from issue bodies, so the report stays accurate after renames and refactors.

Does this Skill require the GitHub CLI?

Yes, it relies on the gh CLI for both duplicate detection (gh issue list --search) and filing (gh issue create). You need gh installed and authenticated against the target repository.

When should a bug report be split into multiple issues?

Split when the report contains two or more independent failure modes that different contributors could fix in parallel. The Skill files child issues in dependency order with honest Blocked-by links, and keeps everything as one issue when symptoms trace to a single behavior.

Why does the Skill avoid file paths in issue descriptions?

File paths, line numbers, and function names go stale as the codebase evolves, making old issues misleading. Describing behavior in domain terms keeps the issue correct and searchable even after major refactors.