easysdd-issue

Create structured bug reports with YAML-front-matter markdown files.

1.1k|82|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/liuzhengdongfortest/easysdd --skill easysdd-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: easysdd-issue
Source: https://github.com/liuzhengdongfortest/easysdd/tree/main/easysdd-issue
Command: npx skills add https://github.com/liuzhengdongfortest/easysdd --skill easysdd-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often lose context when fixing bugs, leading to missing documentation, unclear root‑cause analysis, and untracked fixes. This Skill structures the bug‑resolution process to keep every step recorded and traceable.

Core Features & Use Cases

  • Issue Reporting: Generates a report.md with a clear problem statement and YAML frontmatter.
  • Root‑Cause Analysis: Guides the creation of an analysis.md documenting investigation details.
  • Fix Documentation: Produces a fix-note.md that records the exact changes and verification steps.
  • Routing Logic: Determines whether to follow the full three‑step flow or a fast‑track path based on existing files and problem complexity.
  • Use Case Example: When a new authentication bug is discovered, the Skill creates the appropriate markdown files, routes you to the correct sub‑skill, and ensures a complete audit trail.

Quick Start

Ask Claude to begin the easysdd‑issue workflow for the bug titled “auth token leak”.

Frequently Asked Questions about easysdd-issue

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

FAQPage Schema
How do I document a software bug fix with structured root cause analysis?

To document a software bug fix with structured root cause analysis, you can use a workflow that generates markdown files for issue reporting, investigation details, and verified fix notes to maintain a complete audit trail. This approach structures each stage into YAML frontmatter markdown documents for consistent traceability.

What is the best way to create traceable bug reports and fix documentation?

The best way to create traceable bug reports and fix documentation is to break the resolution into three stages: issue reporting, root cause analysis, and fix documentation. Generating a separate markdown file for each stage ensures every step of the bug fixing process is recorded and traceable.

How do I track the root cause and fix notes for an issue using markdown?

You track the root cause and fix notes for an issue by creating an analysis.md file documenting the investigation and a fix-note.md file recording exact changes and verification steps. This ensures the bug resolution process keeps every step recorded with YAML frontmatter for consistent traceability.

Can I fast-track simple bug fixes instead of running a full three-step analysis workflow?

Yes, you can fast-track simple bug fixes instead of running a full three-step analysis workflow. The routing logic determines whether to follow the complete report, analysis, and fix-note flow or a fast-track path based on existing files and the complexity of the problem.

Why do developers lose context when fixing bugs and how can structured issue reports help?

Developers lose context when fixing bugs due to missing documentation and unclear root cause analysis, which leads to untracked fixes. Structured issue reports help by guiding the bug through documented stages, ensuring a complete audit trail from problem statement to verified fix note.

Does the bug fixing workflow support routing to sub-skills for different issue types?

Yes, the bug fixing workflow supports routing to sub-skills for different issue types. It determines the appropriate path based on existing files and problem complexity, routing you to the correct sub-skill to ensure consistent traceability throughout the analysis and fix documentation.