BaoNguyen09/fixit
.agents/skills/fixit/SKILL.md
Run health checks and fix problems. Checks if the dev server is running, runs lint and build checks, verifies file integrity, and automatically fixes any issues found.
$ install --global
skillsauthnpx skillsauth add BaoNguyen09/grade-pilot fixitInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 11:51 PM3.5s1 file scanned
SKILL.md
- name:
- fixit
- description:
- Run health checks and fix problems. Checks if the dev server is running, runs lint and build checks, verifies file integrity, and automatically fixes any issues found.
$fixit — fix problems
before you touch anything
stop and think:
- what was the user doing when this broke? read the recent conversation.
- what changed recently? look at the last few file modifications.
- what are you assuming is fine that might not be?
- don't just chase the first error you see — is it the root cause or a symptom?
bugs live where the thinking stopped too soon. the obvious fix isn't always the right one. trace the problem back to where it actually started.
diagnostic checklist
run through this diagnostic checklist. stop and fix at the first failure before moving on.
1. Dev Server Running?
curl -s -o /dev/null -w "%{http_code}" http://localhost:3000
If it's not responding:
npm run dev &
Wait for it to come up, then continue. If the background process fails to hold, try starting it again with npm run dev &. If it still fails, check npm run build for errors — the dev server likely can't start because of a build error. Fix the build error first, then retry the dev server.
2. File Integrity
Verify these files exist and are valid:
app/page.tsx— has a default exportapp/layout.tsx— has a default export, wraps children in<Providers>app/providers.tsx— exportsProviderscomponent withHeroUIProviderapp/globals.css— has@import "tailwindcss",@plugin '../hero.ts',@custom-variant dark, and a@themeblockhero.ts— has a default export fromheroui()
If any are missing or broken, recreate them with these essentials:
app/page.tsx— must have"use client"at top and a default export componentapp/layout.tsx— must importProvidersfrom./providers, wrap{children}in<Providers>, havesuppressHydrationWarningon<html>app/providers.tsx— must have"use client", importHeroUIProviderfrom@heroui/react, exportProviderswrapping children in<HeroUIProvider>app/globals.css— must have@import "tailwindcss",@plugin '../hero.ts',@source '../node_modules/@heroui/theme/dist/**/*.{js,ts,jsx,tsx}',@custom-variant dark (&:is(.dark *)), and a@themeblock with--font-sans: var(--font-geist-sans), system-ui, sans-serifand--font-mono: var(--font-geist-mono), monospacehero.ts— mustimport { heroui } from "@heroui/react"andexport default heroui()
3. Import Check
Scan files in app/ and components/ (if it exists) for imports. Check that:
- All
@heroui/reactimports are valid - No imports from missing local files
- No imports from packages not in
package.json
Fix any broken imports.
4. Lint Check
npx eslint app/ --fix
The --fix flag auto-corrects what it can. If errors remain after --fix, they need manual fixes — read the errors, edit the code, and re-run to confirm. Don't show raw lint output to the user.
5. Build Check
npm run build
If the build fails, read the errors, fix them, and run the build again. Translate any errors to plain language for the user.
after fixing
tell the user in plain language what was wrong and that it's fixed:
"found a small issue — [description]. fixed it up, you're good now. check your browser."
if everything passes
"everything looks good — your app is running clean."
if the checklist passes but something still feels wrong
don't stop. the checklist catches common problems, not all problems.
- re-read the user's last few messages. what exactly are they seeing?
- open the files they were working on. read them fresh, like you've never seen them.
- check if the logic actually does what the user expects, not just what the code says.
- look for subtle issues: wrong variable, off-by-one, state not updating, component not re-rendering.
- if you've tried 3 things and it's still broken, step back. re-read everything from scratch.
if you truly can't find the issue after digging:
"hey — i ran through everything and it all looks clean on my end. can you tell me exactly what's happening? like what do you see vs what you expected?"
then work from their description to find the real problem.
rules
- never show raw error output, terminal logs, or stack traces
- fix problems, don't just report them
- if you fix something, confirm it's actually fixed before telling the user
- keep it casual — "found a typo in an import" not "ESLint rule import/no-unresolved violation"
- don't stop at "it compiles" — verify it actually works the way the user expects
- if your fix might have introduced a new problem, check for that too
Related Skills
BaoNguyen09/web-design-guidelines
development
VerifiedTrustedCommunity
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
6SKILL.mdUpdated Apr 15, 2026
BaoNguyen09/vercel-react-best-practices
development
VerifiedTrustedCommunity
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
6SKILL.mdUpdated Apr 15, 2026
BaoNguyen09/vercel-deploy
development
VerifiedTrustedCommunity
Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".
6SKILL.mdUpdated Apr 15, 2026
BaoNguyen09/install-windows
tools
VerifiedTrustedCommunity
Set up a Windows PC to run the project. Sets PowerShell execution policy, installs Node.js if needed, and runs npm install.
6SKILL.mdUpdated Apr 15, 2026