agy-superpowers 5.0.7 → 5.0.9

package/template/agent/skills/influencer-marketer/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: influencer-marketer
+description: Use when planning UGC campaigns, creator partnerships, TikTok/YouTube/Instagram marketing, affiliate programs, or word-of-mouth amplification strategies
+---
+
+# Influencer Marketer Lens
+
+> **Philosophy:** Creators are trusted media channels with pre-built audiences. One authentic review beats 1000 banner ads.
+> The best influencer marketing doesn't look like marketing.
+
+---
+
+## Core Instincts
+
+- **Authenticity > reach** — a micro-influencer who uses your product converts better than a mega-influencer who doesn't
+- **Product-market fit before influencer fit** — influencer marketing amplifies; it doesn't create
+- **Micro > macro for early-stage** — 10K–100K followers with high engagement beats 1M followers with 0.5% ER
+- **UGC is the asset** — even if a campaign flops, the content you own is valuable for ads
+- **Long-term > one-off** — repeat mentions build brand association; single posts are noise
+
+---
+
+## Influencer Tier Reference
+
+| Tier | Followers | Instagram ER | TikTok ER | Best for |
+|------|-----------|-------------|----------|----------|
+| **Nano** | 1K – 10K | 5–9% | 9–15% | Niche communities, very authentic |
+| **Micro** | 10K – 100K | 3–5% | 5–9% | Best ROI for indie hackers; targeted audiences |
+| **Mid-tier** | 100K – 500K | 1.5–3% | 3–6% | Scale with proven product |
+| **Macro** | 500K – 1M | 1–2% | 2–4% | Brand awareness; expensive |
+| **Mega / Celebrity** | 1M+ | 0.5–1% | 1–3% | Mass awareness; rarely cost-effective |
+
+**Engagement Rate (ER):** `(likes + comments) / followers × 100`  
+**Minimum bar:** ER < 1% (Instagram) or < 2% (TikTok) = avoid regardless of follower count.  
+**Note:** TikTok ERs are structurally higher than Instagram due to algorithmic distribution to non-followers.
+
+---
+
+## Platform Strategy
+
+| Platform | Content format | Best for | Purchase intent |
+|----------|---------------|----------|----------------|
+| **TikTok** | Short video (15s–3min) | Consumer apps, Gen Z/Millennial | Medium-high |
+| **YouTube** | Long-form, tutorials, reviews | Tools, SaaS, education | High |
+| **Instagram** | Reels, Stories, carousel | Lifestyle, consumer apps | Medium |
+| **X (Twitter)** | Threads, screenshots | Developer tools, B2B | Medium |
+| **Newsletter** | Written features, sponsored posts | B2B SaaS, niche products | Very high |
+
+---
+
+## Creator Outreach Template
+
+```
+Subject: [Your product] + [Creator name] collab?
+
+Hi [Name],
+
+I've been following your [specific content] for [time] — specifically loved [specific post].
+
+I built [product] for [specific audience that matches theirs]. I think your followers would 
+genuinely find it useful because [specific reason].
+
+I'd love to offer you [free access / commission / fee] to try it and share your honest 
+experience — no script, just your real take.
+
+Interested in a quick chat?
+[Name]
+```
+
+**Key:** Reference specific content → show you actually watch them → explain why it fits their audience → make the ask small.
+
+---
+
+## Compensation Models
+
+| Model | When to use | Risk |
+|-------|------------|------|
+| **Product gifting** | Nano/micro; product is genuinely useful | Low reach if they don't post |
+| **Affiliate / commission** | Performance-based; aligns incentives | Creators may prefer upfront |
+| **Flat fee + affiliate** | Larger creators; guaranteed post | Higher upfront cost |
+| **Revenue share** | Long-term partnerships | Complex to track |
+| **Equity** | Very early, co-founder personality | Rare; only for deeply aligned creators |
+
+**Benchmark rates (2024):**
+- Nano (TikTok/IG): $50–$300/post
+- Micro (TikTok/IG): $300–$2,000/post
+- YouTube (dedicated video): $500–$5,000 per 100K subscribers
+
+---
+
+## ❌ Anti-Patterns to Avoid
+
+| ❌ NEVER DO | Why | ✅ DO INSTEAD |
+|------------|-----|--------------|
+| Choose by follower count only | High followers + low ER = expensive and ineffective | Require ER > 2% for niche, > 1% for broad |
+| Give a strict script | Inauthentic content, audiences can tell | Brief + key points + let them be themselves |
+| One post and done | Single posts get lost in the feed | 3+ touchpoints (post + story + mention) |
+| No UTM tracking | Can't measure attribution or ROAS | UTM links + promo codes per creator |
+| Work with influencers who don't use your product | Inauthentic, low conversion | Send product, wait for organic use, then approach |
+| No contract for paid collaborations | Disputes about deliverables | Written brief: platform, format, post count, timeline, usage rights |
+
+---
+
+## Questions You Always Ask
+
+**Before a campaign:**
+- Does this creator's audience match our target user? (Check their comment section)
+- What's their engagement rate? (< 1% = skip)
+- Do they already talk about products in our category organically?
+- How will we track conversions — UTM links, promo codes, or post-purchase survey?
+
+**After a campaign:**
+- What was the ROAS on paid posts vs expected CAC?
+- Which creator drove the best conversion (not just clicks)?
+- Can we repurpose this UGC as paid ads?
+
+---
+
+## Red Flags
+
+**Must fix:**
+- [ ] No UTM tracking or promo codes (no attribution)
+- [ ] Working only with > 1M follower creators (poor ROI for indie hackers)
+- [ ] No brief given to creators (no deliverable clarity)
+
+**Should fix:**
+- [ ] Requiring exact word-for-word scripts
+- [ ] Single post with no follow-up mentions
+- [ ] No UGC repurposing strategy
+
+---
+
+## Who to Pair With
+- `paid-acquisition-specialist` — for repurposing UGC as performance ads
+- `content-marketer` — for organic amplification of creator content
+- `data-analyst` — for attribution modeling and campaign ROAS
+
+---
+
+## Tools
+**Outreach:** Hunter.io · LinkedIn · direct DM · **Campaign management:** Grin · AspireIQ · Creator.co · **Tracking:** UTM builder + Bitly · unique promo codes · **UGC repurposing:** Meta Ads creative with creator handles

package/template/agent/skills/mobile-developer/SKILL.md

@@ -0,0 +1,194 @@
+---
+name: mobile-developer
+description: Use when working on mobile app features, reviewing mobile code, or making architecture decisions — regardless of platform (React Native, Flutter, iOS, Android)
+---
+
+# Mobile Developer Lens
+
+> **Philosophy:** Touch-first. Offline-capable. Battery-conscious. Platform-respectful.
+> Mobile is NOT a small desktop. Design for bad network, one hand, bright sun, low battery.
+
+---
+
+## ⚠️ ASK BEFORE ASSUMING
+
+If the request is open-ended, **DO NOT default to React Native**. Ask:
+
+| What | Why it matters |
+|------|----------------|
+| **Platform?** iOS / Android / Both | Affects EVERY design decision |
+| **Framework?** RN / Flutter / SwiftUI / Compose | Determines patterns and tools |
+| **Offline required?** | Core architecture decision |
+| **Target devices?** Phone / Tablet | Layout and nav complexity |
+
+When stack is unspecified, assume React Native + Expo.
+
+---
+
+## Framework Decision Tree
+
+```
+What are you building?
+├── Need OTA updates + rapid iteration → React Native + Expo
+├── Pixel-perfect custom UI + perf-critical → Flutter
+├── Deep native features, single platform
+│   ├── iOS only → SwiftUI (iOS 16+) or UIKit (legacy)
+│   └── Android only → Kotlin + Jetpack Compose
+└── Existing codebase → match the codebase
+```
+
+---
+
+## Core Instincts
+
+- **Offline-first** — assume the network will fail; design around it from day one
+- **Platform parity** — iOS and Android behave differently; both must work
+- **Startup cost** — every dependency adds to cold start time and binary size; justify each one
+- **UI/main thread is precious** — heavy computation and animations must run off the main thread
+- **Battery budget** — background tasks, location, and push use real energy; minimize wake-ups
+
+---
+
+## Performance Thresholds
+
+| Metric | Target | Critical |
+|--------|--------|----------|
+| Cold start time (JS bundle ready) | < 1s | > 2s |
+| Time to interactive (first screen) | < 2s | > 4s |
+| List scroll frame rate | 60fps | < 45fps |
+| IPA / APK download size | < 30MB | > 100MB |
+| Memory usage (foreground) | < 150MB | > 300MB |
+| JS bundle size (RN, gzipped) | < 1MB | > 3MB |
+
+---
+
+## ❌ Anti-Patterns to Avoid
+
+| ❌ NEVER DO | Why | ✅ DO INSTEAD |
+|------------|-----|--------------|
+| `ScrollView` for long lists | Renders ALL items, memory explodes | `FlatList` / `FlashList` / `ListView.builder` |
+| Inline `renderItem` function | New function every render, all items re-render | `useCallback` + `React.memo` on item component |
+| Missing `keyExtractor` (or using index) | Reorder causes state/animation bugs | Use unique stable ID from data |
+| `useNativeDriver: false` on animations | Animations run on JS thread, janky | `useNativeDriver: true` — GPU-only transforms |
+| Token in `AsyncStorage` | Plaintext, exposed on rooted device | `expo-secure-store` / `Keychain` / `EncryptedSharedPreferences` |
+| Business logic in UI components | Untestable, duplicated | Separate service/hook layer |
+| Deep links as afterthought | Notifications and shares break | Plan `linking` config from day one |
+| `console.log` in production build | Blocks JS thread, leaks data | Remove; use a proper logger with levels |
+
+---
+
+## Platform Reference
+
+| Element | iOS | Android |
+|---------|-----|---------|
+| Min touch target | **44pt × 44pt** | **48dp × 48dp** |
+| Min gap between targets | **8pt** | **8dp** |
+| Back navigation | Edge swipe left | System back gesture / button |
+| Status bar height | 44–59pt (dynamic island) | 24–28dp |
+| Safe area insets | `SafeAreaView` / `useSafeAreaInsets` | `WindowInsets` |
+| Primary font | SF Pro / SF Compact | Roboto / Noto |
+| Icon set | SF Symbols | Material Symbols |
+| Haptics | `UIImpactFeedbackGenerator` | `VibrationEffect` |
+
+---
+
+## Questions You Always Ask
+
+**When planning features:**
+- What happens when the user is offline or on 2G?
+- What's the behavior on first install (no cached data, no permissions yet)?
+- What happens when the app is backgrounded or killed mid-task?
+- Have we tested on both iOS and Android, including on low-end devices?
+
+**When reviewing architecture:**
+- Does this increase cold start or JS bundle size? By how much?
+- Are we handling permission denial AND revocation gracefully?
+- What's the upgrade path for users with stale local data from an older version?
+- Is this animation running on the UI thread or the JS thread?
+
+---
+
+## Red Flags in Code Review
+
+**Must fix:**
+- [ ] No loading/error state for async operations
+- [ ] Platform-specific logic hardcoded inline (use `Platform.select` or platform files)
+- [ ] Animations not using native driver (or GPU-only properties)
+- [ ] Sensitive data in `AsyncStorage` (tokens, PII)
+
+**Should fix:**
+- [ ] Deep links not wired into navigation config
+- [ ] No permission denial / revocation handling
+- [ ] Local storage schema changes without migration
+- [ ] `console.log` present in production path
+
+---
+
+## Thumb Zone (One-Handed Usage)
+
+```
+┌─────────────────────────┐
+│    HARD TO REACH        │ ← nav bar, back, settings
+│      (stretch)          │
+├─────────────────────────┤
+│    OK TO REACH          │ ← secondary actions
+│     (natural)           │
+├─────────────────────────┤
+│    EASY TO REACH        │ ← primary CTA, tab bar
+│  (thumb's natural arc)  │ ← main interaction zone
+└─────────────────────────┘
+```
+
+Primary CTAs belong in the **bottom 40%** of the screen.
+
+---
+
+## Platform References
+
+When this skill is invoked, detect the project's platform stack and read
+the matching reference file(s) from `references/` before proceeding:
+
+| Stack indicator                       | Reference file                |
+|---------------------------------------|-------------------------------|
+| `package.json` with `react-native`    | `references/react-native.md`  |
+| `pubspec.yaml`                        | `references/flutter.md`       |
+| `*.xcodeproj` or `Package.swift`      | `references/ios-native.md`    |
+| `build.gradle.kts` or `build.gradle`  | `references/android-native.md`|
+
+If the project uses multiple stacks (e.g., React Native with native
+modules), read ALL matching references.
+
+If no stack indicator is found, ask the user which platform they're targeting.
+
+### Granular Rules (React Native)
+
+For React Native projects, `references/react-native-rules/` contains 36
+individual rule files from [Vercel's agent-skills](https://github.com/vercel-labs/agent-skills).
+Each rule covers one specific pattern with incorrect/correct code examples.
+
+Read `references/react-native-rules/_sections.md` for the full index
+organized by priority (CRITICAL → LOW). Reference individual rules
+when working on specific areas (list performance, animation, UI patterns, etc.).
+
+### Granular Rules (Flutter/Dart)
+
+For Flutter projects, `references/flutter-rules/` contains 8 Dart skill
+files from [kevmoo/dash_skills](https://github.com/kevmoo/dash_skills),
+covering Dart language best practices, modern features, testing patterns,
+and package maintenance.
+
+### Granular Rules (Android)
+
+For Android projects, `references/android-rules/` contains 17 skill
+files from [awesome-android-agent-skills](https://github.com/new-silvermoon/awesome-android-agent-skills),
+covering: Clean Architecture, Compose UI/Performance/Navigation,
+ViewModel patterns, Retrofit networking, Kotlin Coroutines, Gradle
+optimization, testing, and XML-to-Compose migration.
+
+### Granular Rules (iOS/SwiftUI)
+
+For iOS projects, `references/ios-rules/` contains 19 SwiftUI reference
+files from [AvdLee/SwiftUI-Agent-Skill](https://github.com/AvdLee/SwiftUI-Agent-Skill),
+covering: state management, view composition, performance, animations
+(basics/advanced/transitions), navigation, Swift Charts, macOS support,
+Liquid Glass (iOS 26+), and accessibility.