mobile-web-consultant
Installation
SKILL.md
Mobile Web Development Consultant
Transform mobile app ideas into comprehensive PWA/responsive web specifications through orchestrated multi-agent collaboration. Specialized for mobile-first progressive web applications.
Tech Stack
- Structure: HTML5
- Styling: Tailwind CSS
- Logic: Vanilla JavaScript (ES6+)
- PWA: Service Worker + Web App Manifest
- Storage: IndexedDB (via localbase)
- Offline: Cache API + Background Sync
When to Use
Use when:
- Building mobile-first responsive web applications
- Need offline capability (PWA)
- Want app-like experience without app store
- Touch-optimized interface required
- Single codebase for all devices
Don't use when:
- Desktop-first application needed
- Native device APIs required (camera, sensors)
- Complex desktop interactions needed
- Offline not a priority
Agent Workflow
┌─────────────────────────────────────────────────────────────┐
│ Phase 1: Discovery │
│ (Sequential) │
└─────────────────────────────────────────────────────────────┘
↓
┌───────────────────┐
│ Interviewer │ → Ask: Standard or Hell Interviewer?
│ (or Hell Int.) │ → .shared/01-requirements.md
└───────────────────┘
↓
┌───────────────────┐
│ Mobile UI Sketcher│ → Mobile-first wireframes
│ │ → .shared/02-wireframes.md
└───────────────────┘
↓
┌───────────────────┐
│ UX Spec Writer │ → Mobile UX specifications
│ │ → .shared/03-ux-specification.md
└───────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ Phase 2: Specification │
│ (Parallel) │
└─────────────────────────────────────────────────────────────┘
↓
┌───────────────────┬───────────────────┬─────────────────────┐
│ Client Tech Arch │ Mermaid Designer │ Mobile Interaction │
│ (PWA + Storage) │ (Flow diagrams) │ Designer │
│ 04-tech-arch.md │ 05-flow-diag.md │ 06-animations.md │
└───────────────────┴───────────────────┴─────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ Phase 3: Final │
│ (Sequential) │
└─────────────────────────────────────────────────────────────┘
↓
┌───────────────────┐
│ Planner │ → Project roadmap
│ │ → .shared/07-roadmap.md
└───────────────────┘
↓
┌───────────────────┐
│ Browser QA │ → Mobile device testing
│ │ → .shared/08-qa-report.md
└───────────────────┘
8 Agent Summary
| # | Agent | Output | Purpose |
|---|---|---|---|
| 1 | Interviewer (or Hell) | 01-requirements.md | Extract requirements |
| 2 | Mobile UI Sketcher | 02-wireframes.md | Mobile-first wireframes |
| 3 | UX Spec Writer | 03-ux-specification.md | Mobile UX documentation |
| 4 | Client Tech Architect | 04-tech-architecture.md | PWA + Storage design |
| 5 | Mermaid Designer | 05-flow-diagrams.md | Flow visualizations |
| 6 | Mobile Interaction Designer | 06-animations.md | Touch interactions |
| 7 | Planner | 07-roadmap.md | Development roadmap |
| 8 | Browser QA | 08-qa-report.md | Mobile testing |
.shared Folder Structure
.shared/
├── 01-requirements.md # What to build
├── 02-wireframes.md # Mobile-first layouts
├── 03-ux-specification.md # Mobile UX patterns
├── 04-tech-architecture.md # PWA + Storage architecture
├── 05-flow-diagrams.md # Mermaid diagrams
├── 06-animations.md # Touch interaction specs
├── 07-roadmap.md # Development plan
└── 08-qa-report.md # Mobile test results
Starting the Workflow
When user invokes this skill:
- Ask Interviewer Mode:
Select interviewer mode:
- Standard (Quick, 2-3 questions, ~5 min)
- Hell Interviewer (Thorough, detailed exploration, 20-45 min)
- Launch Selected Interviewer
- Follow Sequential → Parallel → Sequential flow
Agent Delegation Format
TASK: [Specific goal]
EXPECTED OUTCOME: [Output file]
REQUIRED AGENT: [Agent name from table above]
CONTEXT: [Required input files]
MUST DO:
- Read previous outputs from .shared/
- Follow agent's AGENT.md guidelines
- Write output to specified file
- Prioritize mobile-first design
MUST NOT DO:
- Skip reading previous phase outputs
- Design desktop-first layouts
- Ignore touch interaction requirements
- Use non-standard mobile patterns
Mobile-Specific Considerations
Touch Patterns
- Thumb zone optimization
- 44px minimum touch targets
- Swipe gestures (delete, navigate)
- Pull-to-refresh
- Bottom navigation
PWA Requirements
- Service Worker registration
- Web App Manifest
- Offline fallback pages
- Add to Home Screen prompt
- Push notifications (optional)
Performance
- First Contentful Paint < 1.8s
- Largest Contentful Paint < 2.5s
- Cumulative Layout Shift < 0.1
- Time to Interactive < 3.8s
Responsive Breakpoints
- Mobile: 320px - 480px
- Tablet: 481px - 768px
- Desktop: 769px+
Final Outputs
8 comprehensive markdown documents in .shared/:
- Requirements with mobile use cases
- ASCII wireframes for mobile-first layout
- UX specification with touch patterns
- PWA + IndexedDB technical architecture
- Mermaid flow diagrams
- Touch interaction and gesture specs
- Prioritized development roadmap
- Mobile QA test report
Reference Files
references/workflow.md- Detailed workflow guidereferences/mobile-ux-patterns.md- Mobile patternsreferences/pwa-guide.md- PWA implementationreferences/touch-interactions.md- Touch guidelinesreferences/shared-folder-spec.md- Output standardsreferences/common-agent-tools.md- Tool usage