One-click install
npx skills add https://github.com/mathiasbourgoin/roster --skill roster-investigate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roster-investigate
Source: https://github.com/mathiasbourgoin/roster/tree/main/.opencode/skills/roster-investigate
Command: npx skills add https://github.com/mathiasbourgoin/roster --skill roster-investigate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates guesswork and risky premature fixes for software bugs by providing structured, read-only root-cause analysis that never modifies out-of-scope code without explicit human approval.

Core Features & Use Cases

  • Structured Hypothesis Testing: Formulates up to 5 probability-ordered root cause hypotheses, then tests each read-only using code tracing, git history, and reproduction attempts.
  • Evidence-Based Reporting: Produces a formal investigation report with cited code evidence, tested hypotheses, fix plans, and test recommendations.
  • Use Case: For example, if a payment processing service is throwing intermittent 500 errors, use this skill to trace the root cause without modifying any payment service code until the issue is fully understood.

Quick Start

Use the roster-investigate skill to analyze the root cause of the intermittent 500 errors in the payment processing service without modifying any service code.

Frequently Asked Questions about roster-investigate

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

FAQPage Schema
What is the best way to perform root cause analysis for intermittent bugs without changing production code?

The best way to perform read-only root cause analysis is to formulate probability-ordered hypotheses and test them using code tracing and git history. This approach identifies the root cause and generates a fix plan without modifying out-of-scope code until the issue is confirmed.

How do I investigate unexplained software failures using structured hypothesis testing?

To investigate unexplained software failures, you formulate up to five probability-ordered root cause hypotheses. You then test each hypothesis read-only by tracing code, reviewing git history, and attempting reproduction to isolate the exact failure mechanism.

Can I troubleshoot flaky application behavior without making out-of-scope code edits?

Yes, you can troubleshoot flaky behavior without making out-of-scope code edits. This read-only debugging approach restricts modifications until human approval, ensuring you produce evidence-based fix plans aligned with pipeline governance rules.

What does an evidence-based software bug investigation report include?

An evidence-based bug investigation report includes cited code evidence, tested hypotheses, documented root causes, and actionable fix plans. It also provides specific test recommendations to verify the identified root cause of the unexpected behavior.

Does read-only debugging work for ambiguous failures in a pipeline governance environment?

Read-only debugging works effectively for ambiguous failures in a pipeline governance environment. It enforces evidence-based troubleshooting that produces documented root causes and tested hypotheses, ensuring any fix planning aligns strictly with pipeline governance rules.

When should I avoid premature fixes during software troubleshooting?

You should avoid premature fixes during software troubleshooting when the root cause of an unexpected behavior is unclear. Applying structured, read-only investigation first eliminates guesswork and prevents risky modifications before the root cause is fully confirmed.