troubleshooting

Diagnose build errors, image upload failures, and SSE connection issues.

2|1|Updated Oct 27, 2025
One-click install
npx skills add https://github.com/eco2-team/frontend --skill troubleshooting-eco2-team
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: troubleshooting
Source: https://github.com/eco2-team/frontend/tree/main/.claude/skills/troubleshooting
Command: npx skills add https://github.com/eco2-team/frontend --skill troubleshooting-eco2-team

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) components.

What problem does it solve?

์ด ์Šคํ‚ฌ์€ ์—์ด์ „ํŠธ ๊ธฐ๋Šฅ ๊ฐœ๋ฐœ ๋ฐ ์šด์˜ ์ค‘ ๋ฐœ์ƒํ•˜๋Š” ์ผ๋ฐ˜์  ๋ฌธ์ œ๋ฅผ ๋น ๋ฅด๊ฒŒ ์ง„๋‹จํ•˜๊ณ  ํ•ด๊ฒฐํ•˜๋Š” ๊ฐ€์ด๋“œ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ๋นŒ๋“œ ์—๋Ÿฌ, ์ด๋ฏธ์ง€ ์—…๋กœ๋“œ ์‹คํŒจ, SSE ์—ฐ๊ฒฐ ๋ฌธ์ œ, IndexedDB ์ด์Šˆ ๋“ฑ ์‹ค์ „ ํŠธ๋Ÿฌ๋ธ”์ŠˆํŒ… ์‹œ๋‚˜๋ฆฌ์˜ค๋ฅผ ๋‹ค๋ฃน๋‹ˆ๋‹ค.

Core Features & Use Cases

  • ํฌ๊ด„์ ์ธ ์ด์Šˆ ๋ถ„๋ฅ˜: ๋นŒ๋“œ ์—๋Ÿฌ, ์ด๋ฏธ์ง€ ์—…๋กœ๋“œ ์‹คํŒจ, SSE ์—ฐ๊ฒฐ ๋ฌธ์ œ, IndexedDB ๋ฌธ์ œ ๋“ฑ์„ ๋‹จ๊ณ„๋ณ„๋กœ ๋ถ„๋ฅ˜ํ•˜๊ณ  ์›์ธ-ํ•ด๊ฒฐ ๊ฒฝ๋กœ๋ฅผ ์ œ์‹œํ•ฉ๋‹ˆ๋‹ค.
  • ์˜์‚ฌ๊ฒฐ์ • ํŠธ๋ฆฌ ๊ธฐ๋ฐ˜ ์ง„๋‹จ: ์ฆ์ƒ โ†’ ์›์ธ โ†’ ํ•ด๊ฒฐ ์ˆœ์„œ๋กœ ์‹ค๋ฌด ์ƒํ™ฉ์— ๋งž์ถ˜ ํŠธ๋Ÿฌ๋ธ”์ŠˆํŒ… ๊ฒฝ๋กœ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
  • ๋””๋ฒ„๊น… ํŒ ๋ฐ ์•ˆ์ „์„ฑ ํŒจํ„ด: ๋กœ๊น…, ์žฌ์‹œ๋„, ๋ฆฌ์†Œ์Šค ๊ด€๋ฆฌ ๋“ฑ ์žฌํ˜„ ๊ฐ€๋Šฅํ•˜๊ณ  ์•ˆ์ „ํ•œ ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•์„ ์ œ์‹œํ•ฉ๋‹ˆ๋‹ค.

Quick Start

์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ ์ƒํ™ฉ์—์„œ ์ด ๊ฐ€์ด๋“œ์˜ ์ฒด๊ณ„์  ํ”„๋กœ์„ธ์Šค๋ฅผ ๋”ฐ๋ผ ๋‹จ๊ณ„๋ณ„๋กœ ์ง„๋‹จํ•˜๊ณ  ์ฆ‰์‹œ ํ•ด๊ฒฐํ•ฉ๋‹ˆ๋‹ค.

Frequently Asked Questions about troubleshooting

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

FAQPage Schema
How do I troubleshoot SSE connection problems in a frontend-backend pipeline?โ–ผ

To troubleshoot SSE connection problems, follow a decision-tree diagnostic path that categorizes the symptom, identifies the root cause across the frontend-backend pipeline, and applies targeted fixes like connection retry patterns and resource management.

Why does my agent feature fail with build errors during deployment?โ–ผ

Build errors during agent feature deployment are diagnosed through structured error categorization, mapping the specific error pattern to its root cause and applying recommended fixes based on best-practice debugging workflows.

What is the best way to debug image upload failures in a real-world deployment?โ–ผ

The best way to debug image upload failures is using an end-to-end troubleshooting process that traces the issue through the frontend-backend pipeline, categorizes the error, and applies step-by-step triage and recovery actions.

How does the decision-tree based diagnosis work for agent feature issues?โ–ผ

The decision-tree diagnosis works by mapping issues in a structured sequence: symptom identification, root cause analysis, and resolution application, covering scenarios like IndexedDB problems and SSE connection failures.

Can I use this troubleshooting guide for IndexedDB issues alongside SSE connection problems?โ–ผ

Yes, you can use this troubleshooting guide for IndexedDB issues alongside SSE connection problems, as it provides comprehensive issue categorization and step-by-step triage for both scenarios within real-world deployments.

What are the limitations of automated troubleshooting for complex frontend-backend pipelines?โ–ผ

Automated troubleshooting for complex frontend-backend pipelines is limited to known error patterns such as build errors, image upload failures, and SSE issues, guiding developers through structured diagnostics rather than novel anomaly detection.