القائمة
Monitor and auto-fix the development environment. Use when: debugging backend/frontend errors, watching log streams, diagnosing startup failures, or running make dev.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Clerk authentication router. Use when user asks about adding authentication, setting up Clerk, custom sign-in flows, Swift or native iOS auth, native Android auth, Next.js patterns, organizations, syncing users, or testing. Automatically routes to the specific skill based on their task.
Understand and customize authentication in this project. Use when: adding auth to routes, swapping auth providers (Clerk, Auth0, custom SSO), debugging auth issues, or understanding the UserInfo contract and get_current_user dependency.
Manage database schema changes with Alembic. Use when: creating migrations, adding tables or columns, checking migration status, rolling back, or seeding the database.
Build, push, and deploy to AWS using Docker, ECR, and Terraform. Use when: deploying to dev/staging/prod, checking deploy status, rolling back, or running the deploy checklist.
Discover, evaluate, and create project-specific skills. Use when: the user needs a capability not covered by built-in skills, wants to find patterns for a specific tool or service, or asks about extending the skills directory. Also use when asking 'how do I add a new skill.'
Generate project-specific Agent Skills for any codebase by interviewing the developer about their conventions. Use when: the user wants to add skills to an existing project, asks 'how do I make my agents understand my codebase,' wants to create a .skills/ directory, or says 'generate skills for my project.'
| name | dev-server |
| description | Monitor and auto-fix the development environment. Use when: debugging backend/frontend errors, watching log streams, diagnosing startup failures, or running make dev. |
make dev # Starts Postgres, Redis, runs migrations, launches backend + frontend
make dev-docker # Alternative: run everything in Docker
Backend: http://localhost:8000 · API docs: http://localhost:8000/api/docs Frontend: http://localhost:5173
If make dev fails, check docker compose ps to verify Postgres is healthy.
| Pattern | Meaning | Fix |
|---|---|---|
"level": "ERROR" | Application error | Read traceback, module, lineno fields |
ModuleNotFoundError | Missing dependency | cd backend && uv add <package> |
sqlalchemy.exc.OperationalError | Database connection failed | Check Postgres is running, migrations are current |
sqlalchemy.exc.ProgrammingError: relation "X" does not exist | Missing migration | cd backend && uv run alembic upgrade head |
pydantic.ValidationError | Schema field mismatch | Compare request payload against Pydantic model |
ImportError: cannot import name 'X' from 'app.models' | Model not exported | Add import to backend/app/models/__init__.py |
| Pattern | Meaning | Fix |
|---|---|---|
TS\d{4}: (e.g., TS2345) | TypeScript error | Read file path + line number from message |
[vite] Internal server error | Build failure | Read full error below the message |
Module not found: Can't resolve | Missing package | cd frontend && npm install or add the dependency |
Uncaught Error: | React runtime error | Read component stack trace |
[hmr] Failed to reload | HMR failure (usually syntax) | File path is in the message |
When an error is detected:
git diff HEAD~1 -- <file>make verify # Runs lint + typecheck + test for both backend and frontend