common-accessibility
Enforce WCAG 2.2 AA compliance with semantic HTML, ARIA roles, keyboard navigation, and color contrast standards for web UIs. Use…
@hoangnguyen0403Install SkillDevelopment
Skill
/common-debugging
Troubleshoot systematically using the Scientific Method. Use when debugging crashes, tracing errors, diagnosing unexpected behavior, or investigating exceptions.
Claude Code
$ npx -y skills add hoangnguyen0403/agent-skills-standard --skill common-debugging --agent claude-code
Codex
$ npx skills add hoangnguyen0403/agent-skills-standard --skill common-debugging -a codex -y
Cursor
$ npx skills add hoangnguyen0403/agent-skills-standard --skill common-debugging -a cursor -y
Gemini CLI
$ npx skills add hoangnguyen0403/agent-skills-standard --skill common-debugging -a gemini-cli -y
GitHub Copilot
$ npx skills add hoangnguyen0403/agent-skills-standard --skill common-debugging -a github-copilot -y
OpenCode
$ npx skills add hoangnguyen0403/agent-skills-standard --skill common-debugging -a opencode -y
Windsurf
$ npx skills add hoangnguyen0403/agent-skills-standard --skill common-debugging -a windsurf -y
SKILL.md
common-debugging.SKILL.mdname: common-debugging
description: Troubleshoot systematically using the Scientific Method. Use when debugging crashes, tracing errors, diagnosing unexpected behavior, or investigating exceptions.
metadata:
triggers:
keywords:
- debug
- fix bug
- crash
- error
- exception
- troubleshootingDebugging Expert
**Priority: P1 (HIGH)**
Root-Cause Protocol
1. **OBSERVE**: Gather error, logs, repro steps, recent diffs. 2. **REPRODUCE**: Make the failure happen on demand or gather more evidence. 3. **HYPOTHESIZE**: State one hypothesis in plain language. 4. **EXPERIMENT**: Change one variable to prove or kill the theory. 5. **FIX**: Touch code only after root cause proven. 6. **VERIFY**: Re-run the failing case and regression checks.
Red Flags
- **Stop if you are changing code before repro**: You are guessing.
- **Stop if fix #2 starts before understanding fix #1**: Re-open root cause.
- **Stop if "quick patch for now" appears**: Symptom masking starts there.
Rationalization Prevention
- **"The bug is obvious"**: Obvious bugs still need evidence.
- **"I already tried a few things"**: That means you need structure.
- **"It only fails in prod"**: Gather prod evidence, do not invent local myths.
- **Minimal repro first**: A minimal reproduction beats more random fixes.
Anti-Patterns
- **No shotgun debugging**: Prove root cause before changing code.
- **No debug prints in production**: Remove all print/console.log before commit.
- **No symptom masking**: Fix root cause; never swallow errors without handling.
References
- [Bug Report Template](references/bug-report-template.md)
Incident pressure checklist
- For production incidents, reproduce with a production-like replay and state one hypothesis before changing code; stop symptom patches until the root cause is proven.
Read more
name: common-debugging
description: Troubleshoot systematically using the Scientific Method. Use when debugging crashes, tracing errors, diagnosing unexpected behavior, or investigating exceptions.
metadata:
triggers:
keywords:
- debug
- fix bug
- crash
- error
- exception
- troubleshootingDebugging Expert
**Priority: P1 (HIGH)**
Root-Cause Protocol
1. **OBSERVE**: Gather error, logs, repro steps, recent diffs. 2. **REPRODUCE**: Make the failure happen on demand or gather more evidence. 3. **HYPOTHESIZE**: State one hypothesis in plain language. 4. **EXPERIMENT**: Change one variable to prove or kill the theory. 5. **FIX**: Touch code only after root cause proven. 6. **VERIFY**: Re-run the failing case and regression checks.
Red Flags
- **Stop if you are changing code before repro**: You are guessing.
- **Stop if fix #2 starts before understanding fix #1**: Re-open root cause.
- **Stop if "quick patch for now" appears**: Symptom masking starts there.
Rationalization Prevention
- **"The bug is obvious"**: Obvious bugs still need evidence.
- **"I already tried a few things"**: That means you need structure.
- **"It only fails in prod"**: Gather prod evidence, do not invent local myths.
- **Minimal repro first**: A minimal reproduction beats more random fixes.
Anti-Patterns
- **No shotgun debugging**: Prove root cause before changing code.
- **No debug prints in production**: Remove all print/console.log before commit.
- **No symptom masking**: Fix root cause; never swallow errors without handling.
References
- [Bug Report Template](references/bug-report-template.md)
Incident pressure checklist
- For production incidents, reproduce with a production-like replay and state one hypothesis before changing code; stop symptom patches until the root cause is proven.
Ships withagent-skills-standard
The portable standards layer for AI coding agents. Sync once, then work in your own runtime.
583200 skills21 agents1 MCP
Stars on GitHub
Momentum
- stars in total
- 583
Other skills on agent-skills-standard.
@hoangnguyen0403Install Skillcommon-agent-guardrail…
Define deterministic guardrails for agent tool calls — protected paths, test-file locks during bug fixes, post-edit formatters,…
@hoangnguyen0403Install Skillcommon-api-design
Apply REST API conventions — HTTP semantics, status codes, versioning, pagination, and OpenAPI standards for any framework. Use…
@hoangnguyen0403Install Skillcommon-architecture-au…
Audit structural debt, logic leakage, and monolithic components across Web, Mobile, and Backend codebases. Use when reviewing…
@hoangnguyen0403Install Skillcommon-architecture-di…
Draws architecture diagrams as editable draw.io files with a fixed house style, C4 levels, evidence-tagged shapes, and optional…
@hoangnguyen0403Install Skillcommon-best-practices
Enforce SOLID principles, guard-clause style, function size limits, and intention-revealing naming across all languages. Use when…
@hoangnguyen0403Install SkillMore skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about common-debugging.
- Which coding agents can use common-debugging?
- common-debugging installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.