agent-skill-kit 3.9.135

package/.agent/skills/mobile-design/SKILL.md

@@ -0,0 +1,165 @@
+---
+name: mobile-design
+description: >-
+  Mobile-first design: touch interaction, platform conventions, offline behavior, and MFRI scoring.
+  Use when designing mobile UI/UX, touch targets, or validating mobile design patterns.
+  NOT for mobile code implementation (use mobile-developer) or web design (use design-system).
+category: mobile-architect
+triggers: ["mobile design", "iOS", "Android", "touch", "responsive mobile"]
+coordinates_with: ["mobile-first", "mobile-developer", "design-system"]
+success_metrics: ["MFRI score > 5", "Touch targets >= 44pt"]
+metadata:
+  author: pikakit
+  version: "3.9.134"
+---
+
+# Mobile Design — Mobile-First Design Doctrine
+
+> Touch-first. Platform-respectful. MFRI scored. 44×44pt / 48×48dp minimum.
+
+**Core Law:** Mobile is NOT a small desktop.
+
+---
+
+## When to Use
+
+| Situation | Action |
+|-----------|--------|
+| Designing mobile UI | Score with MFRI |
+| iOS vs Android | Check platform guidelines |
+| Touch interactions | Use touch target standards |
+| Accessibility audit | Check a11y requirements |
+
+---
+
+## System Boundaries
+
+| Owned by This Skill | NOT Owned |
+|---------------------|-----------|
+| MFRI scoring (5 dimensions) | Mobile orchestration (→ mobile-first) |
+| Platform guidelines (iOS/Android) | Mobile implementation (→ mobile-developer) |
+| Touch target standards | Design system components (→ design-system) |
+| Typography routing (SF Pro/Roboto) | API design (→ api-architect) |
+
+**Expert decision skill:** Produces design decisions. Does not write code or create components.
+
+---
+
+## 5 Must-Ask Questions (Before Any Design)
+
+| # | Question | Options |
+|---|----------|---------|
+| 1 | Platform? | iOS, Android, or both |
+| 2 | Framework? | React Native, Flutter, native |
+| 3 | Navigation? | Tabs, stack, drawer |
+| 4 | Offline? | Must work offline? |
+| 5 | Devices? | Phone only or tablet too |
+
+---
+
+## MFRI Scoring (Mobile Feasibility & Risk Index)
+
+| Dimension | Assessment |
+|-----------|------------|
+| Platform Clarity | Target platform defined? |
+| Interaction Complexity | How complex are gestures? |
+| Performance Risk | Heavy lists, animations, media? |
+| Offline Dependence | Breaks without network? |
+| Accessibility Risk | Motor, visual, cognitive impact? |
+
+| Score | Action |
+|-------|--------|
+| 6-10 | ✅ Safe — proceed |
+| 3-5 | ⚠️ Add validation |
+| 0-2 | 🔴 Simplify first |
+| < 0 | ❌ Redesign required |
+
+---
+
+## Platform Differences (Fixed)
+
+| Element | iOS | Android |
+|---------|-----|---------|
+| Back | No button | System back |
+| Navigation | Bottom tabs | Bottom nav / drawer |
+| Typography | **SF Pro** | **Roboto** |
+| Corner radius | Rounded (continuous) | Varies (MD3) |
+
+---
+
+## Touch Targets (Fixed)
+
+| Standard | Minimum |
+|----------|---------|
+| **iOS** | 44×44 pt |
+| **Android** | 48×48 dp |
+| **Spacing** | 8dp between targets |
+
+---
+
+## Core Philosophy (Fixed Order)
+
+```
+Touch-first → Battery-conscious → Platform-respectful → Offline-capable
+```
+
+---
+
+## Error Taxonomy
+
+| Code | Recoverable | Trigger |
+|------|-------------|---------|
+| `ERR_INVALID_REQUEST_TYPE` | No | Request type not supported |
+| `ERR_UNKNOWN_PLATFORM` | Yes | Platform not ios/android/both |
+| `ERR_MISSING_PLATFORM` | Yes | Platform not provided |
+| `WARN_LOW_MFRI` | Yes | MFRI score below 3 |
+
+**Zero internal retries.** Deterministic; same context = same assessment.
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|---------|-------|
+| Apply desktop patterns | Touch-first design |
+| Use hover states | Tap and press states |
+| Small tap targets | 44×44pt (iOS) / 48×48dp (Android) |
+| Assume network | Design for offline |
+| Mix platform conventions | Respect iOS HIG / Material Design |
+
+
+## 📑 Content Map
+
+| File | Description | When to Read |
+|------|-------------|--------------|
+| [platform-ios.md](rules/platform-ios.md) | iOS HIG guidelines | iOS design |
+| [platform-android.md](rules/platform-android.md) | Material Design guidelines | Android design |
+| [touch-psychology.md](rules/touch-psychology.md) | Touch interaction patterns | Touch UX |
+| [mobile-navigation.md](rules/mobile-navigation.md) | Navigation patterns | Nav decisions |
+| [mobile-typography.md](rules/mobile-typography.md) | Typography systems | Font selection |
+| [mobile-color-system.md](rules/mobile-color-system.md) | Color palettes | Color decisions |
+| [mobile-performance.md](rules/mobile-performance.md) | Performance guidelines | Perf concerns |
+| [mobile-testing.md](rules/mobile-testing.md) | Testing strategies | QA planning |
+| [mobile-debugging.md](rules/mobile-debugging.md) | Debugging patterns | Bug fixing |
+| [mobile-backend.md](rules/mobile-backend.md) | Backend integration | API decisions |
+| [mobile-design-thinking.md](rules/mobile-design-thinking.md) | Design methodology | Design process |
+| [decision-trees.md](rules/decision-trees.md) | Decision frameworks | Complex decisions |
+| [mobile_audit.ts](scripts/mobile_audit.ts) | Mobile design audit CLI | Design audit |
+| [engineering-spec.md](rules/engineering-spec.md) | Full engineering spec | Architecture review |
+
+**Selective reading:** Read ONLY files relevant to current design question.
+
+---
+
+## 🔗 Related
+
+| Item | Type | Purpose |
+|------|------|---------|
+| `mobile-first` | Skill | Mobile orchestrator |
+| `mobile-developer` | Skill | Implementation |
+| `design-system` | Skill | Design patterns |
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/mobile-design/rules/_sections.md

@@ -0,0 +1,45 @@
+# Sections
+
+This file defines all sections, their ordering, impact levels, and descriptions.
+The section ID (in parentheses) is the filename prefix used to group rules.
+
+---
+
+## 1. Mobile Patterns (mobile)
+
+**Impact:** HIGH  
+**Description:** Mobile-specific patterns for touch, performance, and platform conventions.
+
+## 2. Platform (platform)
+
+**Impact:** LOW  
+**Description:** Platform patterns and best practices.
+
+## 3. Decision Trees (decision)
+
+**Impact:** HIGH  
+**Description:** Structured decision-making frameworks for design choices.
+
+## 4. Engineering Specification (engineering)
+
+**Impact:** MEDIUM  
+**Description:** Full engineering specification covering contracts, security, and scalability.
+
+## 5. Mobile color (mobile-color)
+
+**Impact:** LOW  
+**Description:** Mobile color patterns and best practices.
+
+## 6. Mobile design (mobile-design)
+
+**Impact:** LOW  
+**Description:** Mobile design patterns and best practices.
+
+## 7. Touch & Interaction (touch)
+
+**Impact:** HIGH  
+**Description:** Touch-first interaction patterns optimized for mobile devices.
+
+---
+
+⚡ PikaKit v3.9.134

package/.agent/skills/mobile-design/rules/_template.md

@@ -0,0 +1,32 @@
+---
+title: Rule Title Here
+impact: MEDIUM
+impactDescription: Optional description of impact (e.g., "20-50% improvement")
+tags: tag1, tag2
+---
+
+## Rule Title Here
+
+**Impact: MEDIUM (optional impact description)**
+
+Brief explanation of the rule and why it matters. This should be clear and concise, explaining the performance implications.
+
+**Incorrect (description of what's wrong):**
+
+```typescript
+// Bad code example here
+const bad = example()
+```
+
+**Correct (description of what's right):**
+
+```typescript
+// Good code example here
+const good = example()
+```
+
+Reference: [Link to documentation or resource](https://example.com)
+
+---
+
+⚡ PikaKit v3.9.134