skills/bkend-cookbook/SKILL.md
bkend.ai project tutorials (todo to SaaS) and common error troubleshooting. Triggers: bkend tutorial, cookbook, troubleshooting, 튜토리얼, 에러 해결.
npx skillsauth add popup-studio-ai/bkit-claude-code bkend-cookbookInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
| Project | Level | Key Features | |---------|-------|-------------| | Todo App | Beginner | Basic CRUD, state management | | Note App | Beginner | Rich text, categories | | Blog | Intermediate | Posts, tags, file upload | | Chat App | Intermediate | Real-time messaging | | E-commerce | Intermediate | Products, orders, payments | | Booking System | Intermediate | Reservations, calendar | | Social Feed | Advanced | Posts, follows, feeds | | Dashboard | Advanced | Charts, analytics, roles | | Multi-tenant | Advanced | Organization-scoped data | | SaaS Starter | Advanced | Subscriptions, billing, onboarding |
| Project | Auth | Core CRUD | Files | Advanced | AI | |---------|------|-----------|-------|----------|-----| | Blog | Email/Social | Articles, Tags | Images | Bookmarks | AI summary | | Recipe App | Email/Social | Recipes, Ingredients | Photos | Meal Plan, Shopping List | AI recommendations | | Shopping Mall | Email/Social | Stores, Products, Orders | Product images | Reviews | AI search | | Social Network | Email/Social | Profiles, Posts | Media | Follows, Feeds | AI recommendations |
1. Auth setup (email + social login)
2. Core CRUD (main data tables)
3. File upload (images/media)
4. Advanced features (search, filters, relationships)
5. AI integration (recommendations, summaries)
6. Troubleshooting & optimization
| Error | Cause | Solution | |-------|-------|----------| | 401 Unauthorized | Token expired | POST /v1/auth/refresh | | 403 Forbidden | Insufficient permissions | Check RBAC settings | | 404 Not Found | Wrong path/ID | Verify endpoint and environment | | 409 Conflict | Unique field duplicate | Check duplicate data | | 429 Rate Limit | Request limit exceeded (100/h) | Check Retry-After header | | CORS Error | Domain not registered | Register in bkend console | | MCP Connection Failed | OAuth incomplete | Complete browser auth | | Schema Validation | BSON type mismatch | Check schema with backend_table_get |
| Question | Answer |
|----------|--------|
| Table not visible | Check environment (dev/staging/prod) |
| MCP tools not showing | Run claude mcp list to verify connection |
| Social login not working | Check Provider settings in console |
| File upload fails | Verify size limits (image 10MB, video 100MB) |
| Slow queries | Add indexes via backend_index_manage |
| Data not syncing | Check x-environment header matches |
For the latest cookbook and troubleshooting, use WebFetch:
testing
Sprint Management — generic sprint capability for ANY bkit user. 16 sub-actions: init, start, status, watch, phase, iterate, qa, report, archive, list, feature, pause, resume, fork, help, master-plan. Triggers: sprint, sprint start, sprint init, sprint status, sprint list, 스프린트, 스프린트 시작, 스프린트 상태, スプリント, スプリント開始, スプリント状態, 冲刺, 冲刺开始, 冲刺状态, sprint, iniciar sprint, estado sprint, sprint, demarrer sprint, statut sprint, Sprint, Sprint starten, Sprint Status, sprint, avviare sprint, stato sprint, master plan, multi-sprint plan, sprint master plan, 마스터 플랜, 멀티 스프린트 계획, 스프린트 마스터 플랜, マスタープラン, マルチスプリント計画, スプリントマスタープラン, 主计划, 多冲刺计划, 冲刺主计划, plan maestro, plan multi-sprint, plan maestro sprint, plan maître, plan multi-sprint, plan maître sprint, Masterplan, Multi-Sprint-Plan, Sprint-Masterplan, piano principale, piano multi-sprint, piano principale sprint.
tools
CC CLI version upgrade impact analysis — research changes, analyze bkit impact, generate report. Triggers: cc-version-analysis, CC upgrade, version analysis, CC 버전 분석, 버전 영향.
testing
Manage PDCA checkpoints and rollback — create, list, restore for safe recovery. Rollback events are recorded via lib/audit/audit-logger ACTION_TYPES.rollback_executed. For sprint-level recovery, individual feature rollbacks may be triggered from within sprint phases (sprint itself is forward-only — terminal state is `archived`, not rolled back; v2.1.13). Triggers: rollback, checkpoint, restore, undo, 롤백, 체크포인트, 복원.
testing
QA Phase execution — L1-L5 test planning, generation, execution, and reporting for a single feature. For sprint-level QA (7-Layer dataFlowIntegrity / S1 gate across multiple features) use /sprint qa <sprintId> which delegates to sprint-qa-flow agent (v2.1.13). Triggers: qa phase, QA test, qa run, QA 실행, QAフェーズ, QA阶段, fase QA, phase QA, QA-Phase, fase QA.