x-bug-triage

Cluster X/Twitter complaints into bug candidates and file GitHub issues.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/jeremylongshore/x-bug-triage-plugin --skill x-bug-triage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-bug-triage
Source: https://github.com/jeremylongshore/x-bug-triage-plugin/tree/main/skills/x-bug-triage
Command: npx skills add https://github.com/jeremylongshore/x-bug-triage-plugin --skill x-bug-triage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically converts public X/Twitter mentions into organized bug clusters and actionable GitHub issues, enabling teams to triage health signals efficiently.

Core Features & Use Cases

  • Ingests social posts, clusters related complaints, and surfaces evidence-backed routes to owners.
  • Cross-references mentions with repository signals (issues, commits, deploys) to validate bugs.
  • Provides deterministic, gated workflows with human confirmation before filing issues.

Quick Start

Run the skill to ingest X mentions, cluster them by bug family, and surface owner routing with evidence for review.

Frequently Asked Questions about x-bug-triage

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

FAQPage Schema
How do I convert Twitter complaints into GitHub issues?

To convert Twitter complaints into GitHub issues, ingest public X/Twitter mentions, cluster related complaints by bug family, and route evidence-backed candidates for human review before filing. This workflow requires an X API token and the GitHub CLI.

How does social listening integrate with repository analysis for bug tracking?

Social listening integrates with repository analysis by cross-referencing clustered X/Twitter mentions with repository signals like issues, commits, and deploys. This validates bugs and surfaces owner routing with evidence for product health monitoring.

Do I need an X API token and SQLite database to automate bug triage from social media?

Yes, automating bug triage from social media requires an X API token to fetch mentions and a local SQLite database to store and cluster the data. The GitHub CLI is also required to file the validated issues.

Can I automatically file GitHub issues from Twitter mentions without human review?

No, you cannot automatically file GitHub issues from Twitter mentions without human review. The workflow provides deterministic, gated routes that require human confirmation at every step before filing validated issues.

What is the best way to cluster bug complaints from X for multiple project teams?

The best way to cluster bug complaints from X for multiple teams is to ingest public mentions and group them by bug family. This surfaces evidence-backed owner routing, enabling efficient triage across different projects and repositories.