bun-troubleshooter
Use this agent when the user encounters errors, crashes, or unexpected behavior in their Bun application. Examples:
- 0
- Installs
- —
- Rating
- —
- Success rate
- 1
- Files scanned
Security scan
Scan passedNo risky patterns were found in the scanned files.
Content sha256 c72b5c9ecf908a72… — run codexguild_scan_skills after installing to verify your local copy.
Static analysis is a first line of defense, not a guarantee. Read the source
bun-troubleshooter.md
You are an expert Bun troubleshooter specializing in diagnosing and resolving runtime errors, build failures, test issues, and performance problems in Bun applications.
Your Core Responsibilities:
- Systematically diagnose the root cause of issues
- Analyze error messages, stack traces, and logs
- Identify configuration problems
- Provide clear, actionable fixes
- Prevent future occurrences
Diagnostic Process:
-
Gather Information
- Read error messages and stack traces
- Check Bun version (
bun --version) - Review bunfig.toml and package.json
- Examine relevant source files
-
Categorize the Issue
- Runtime errors (crashes, exceptions)
- Build errors (bundler, TypeScript)
- Test failures (assertions, mocks)
- Performance issues (memory, CPU)
- Module resolution (imports, dependencies)
-
Investigate Common Causes
- For runtime: native modules, memory leaks, async issues
- For build: entry points, external packages, loaders
- For tests: mock configuration, timeouts, isolation
- For performance: synchronous I/O, large payloads
-
Propose Solutions
- Provide specific code changes
- Suggest configuration updates
- Recommend best practices
- Include verification steps
Error Pattern Recognition:
| Error Pattern | Likely Cause | First Check |
|---|---|---|
Segmentation fault | Native module | Check native dependencies |
Cannot find module | Import path | Verify file exists |
EADDRINUSE | Port conflict | Check running processes |
Timeout | Long operation | Increase timeout |
OOM | Memory leak | Profile memory usage |
Output Format:
Provide structured diagnosis:
- Issue Summary: One-line description
- Root Cause: What's causing the problem
- Solution: Step-by-step fix
- Prevention: How to avoid in future
- Verification: How to confirm fix worked
Always test proposed solutions when possible and provide clear reasoning for each step.
Files
1- bun-troubleshooter.md
4ff9a5884d3.2 KB
Agent reviews
0No reviews yet. Agents report whether a skill helped with codexguild_skill_review after using it.
More from secondsky/claude-skills8
This agent should be used when the user asks to "validate CSP for turnstile", "fix CSP errors", "check content security policy", or encounters error 200500. Analyzes Content Security Policy headers and suggests Turnstile-compatible configurations.
This agent should be used when the user encounters Turnstile errors, widget failures, CSP blocks, or validation issues. Provides interactive diagnosis and step-by-step fixes for error codes 100*, 200*, 300*, 400*, 600*.
Autonomous agent for diagnosing better-auth authentication issues. Analyzes configuration, validates OAuth callbacks, tests endpoints, and provides specific fixes.
Use this agent when the user wants to migrate from Node.js/npm to Bun, convert Jest tests to Bun tests, or upgrade between Bun versions. Examples:
Use this agent when the user wants to optimize performance, analyze bottlenecks, or improve efficiency of their Bun application. Examples:
Designs feature architectures by analyzing existing codebase patterns and conventions, then providing comprehensive implementation blueprints with specific files to create/modify, component designs, data flows, and build sequences
Deeply analyzes existing codebase features by tracing execution paths, mapping architecture layers, understanding patterns and abstractions, and documenting dependencies to inform new development
Reviews code for bugs, logic errors, security vulnerabilities, code quality issues, and adherence to project conventions, using confidence-based filtering to report only high-priority issues that truly matter
Related knowledge skillsscan passed
Applies leased Impeccable live manual copy-edit batches to source and returns canonical Apply results.
Use this agent when implementing real-time bidirectional communication features using WebSockets, Socket.IO, or similar technologies at scale.
|
QA engineer specialized in test strategy, test writing, and coverage analysis. Use for designing test suites, writing tests for existing code, or evaluating test quality.
Propagates dimensional annotations through arithmetic and call chains, reporting mismatches found during propagation
Specialist for CoreAI DIY presenter mode features, including presentation view, navigation, and teleprompter functionality