@musashishao/agent-kit 1.9.0 → 1.9.1

package/.agent/skills/game-development/game-economy-designer/SKILL.md

@@ -0,0 +1,375 @@
+---
+name: game-economy-designer
+description: AI-powered F2P game economy design. Currency systems, progression curves, monetization patterns, gacha math, and balance simulation for mobile games.
+allowed-tools: Read, Write, Edit, Bash, Grep, WebSearch
+---
+
+# Game Economy Designer Skill
+
+> Design profitable, fair, and engaging F2P economies with AI assistance.
+
+---
+
+## When to Use
+
+- Designing currency systems for F2P games
+- Balancing progression and monetization
+- Implementing IAP, ads, battle passes
+- Gacha/loot box probability design
+- Revenue projection and modeling
+
+---
+
+## Currency Design
+
+### Three-Currency Model
+
+| Currency | Earn Method | Spend On | Psychology |
+|----------|-------------|----------|------------|
+| **Soft** (Coins) | Gameplay | Basic items, upgrades | Progression feeling |
+| **Hard** (Gems) | IAP, rare drops | Premium items, skips | Scarcity value |
+| **Premium** (Tickets) | Events, special | Exclusive content | FOMO, collectibility |
+
+### Conversion Ratios
+```
+Soft ←→ Hard: 100:1 (indirect via time)
+Hard ←→ Real $: 100 = $0.99
+
+Example packs:
+100 Gems = $0.99  (worst value, impulse)
+500 Gems = $4.99  (10% bonus)
+1200 Gems = $9.99 (20% bonus)
+2800 Gems = $19.99 (40% bonus, best value)
+```
+
+---
+
+## Progression Curves
+
+### XP Formula
+```csharp
+public static int XPForLevel(int level)
+{
+    // Exponential curve with diminishing returns
+    return Mathf.RoundToInt(100 * Mathf.Pow(level, 1.5f));
+}
+
+// Level 1:  100 XP
+// Level 5:  559 XP
+// Level 10: 1000 XP
+// Level 20: 1789 XP
+// Level 50: 3536 XP
+```
+
+### Unlock Schedule
+```
+Level 1-5:   Tutorial (all features locked)
+Level 5:    Daily Challenges unlocked
+Level 10:   PvP unlocked
+Level 15:   Crafting unlocked
+Level 20:   Guilds unlocked
+Level 30:   Events unlocked
+Level 50+:  Prestige/Endgame
+```
+
+---
+
+## Monetization Patterns
+
+### IAP Pricing Psychology
+
+| Tier | Price | Target | Examples |
+|------|-------|--------|----------|
+| **Micro** | $0.99-1.99 | Impulse buyers | Extra lives, small packs |
+| **Small** | $4.99-9.99 | Engaged players | Remove ads, starter packs |
+| **Medium** | $14.99-24.99 | Committed | Season pass, larger packs |
+| **Whale** | $49.99-99.99 | Big spenders | Ultimate bundles |
+
+### Starter Pack Design
+```json
+{
+  "name": "Starter Pack",
+  "price": 4.99,
+  "originalValue": 14.99,
+  "discount": "67% OFF",
+  "oneTimePurchase": true,
+  "contents": [
+    {"item": "gems", "amount": 500},
+    {"item": "exclusive_skin", "amount": 1},
+    {"item": "premium_currency", "amount": 100}
+  ],
+  "availability": "first_7_days"
+}
+```
+
+### Battle Pass Design
+```markdown
+## Battle Pass Structure
+
+**Duration:** 30 days
+**Levels:** 50
+**XP per level:** 1000 (5 games avg)
+
+### Free Track
+- Level 5: 100 Coins
+- Level 10: Common Skin
+- Level 20: 50 Gems
+- Level 30: Rare Item
+- Level 50: Unique Title
+
+### Premium Track ($9.99)
+- All Free Track rewards
+- Level 1: Premium Frame
+- Level 5: 200 Coins
+- Level 10: Rare Skin
+- Level 20: 100 Gems
+- Level 30: Legendary Item
+- Level 50: Exclusive Character
+
+### Catch-Up Mechanic
+- Buy levels: 150 Gems each
+- XP boost purchasable
+```
+
+---
+
+## Gacha/Loot Box Math
+
+### Probability Table
+```csharp
+public class GachaSystem
+{
+    public static readonly Dictionary<Rarity, float> BaseRates = new()
+    {
+        [Rarity.Common] = 60f,
+        [Rarity.Uncommon] = 25f,
+        [Rarity.Rare] = 10f,
+        [Rarity.Epic] = 4f,
+        [Rarity.Legendary] = 1f
+    };
+    
+    // Pity system: Guaranteed legendary after N pulls
+    private int _pullsSinceLegendary = 0;
+    private const int PITY_THRESHOLD = 90;
+    
+    public Rarity Pull()
+    {
+        _pullsSinceLegendary++;
+        
+        // Pity guarantee
+        if (_pullsSinceLegendary >= PITY_THRESHOLD)
+        {
+            _pullsSinceLegendary = 0;
+            return Rarity.Legendary;
+        }
+        
+        // Soft pity: Increase rates near threshold
+        float legendaryRate = BaseRates[Rarity.Legendary];
+        if (_pullsSinceLegendary > 75)
+            legendaryRate += (_pullsSinceLegendary - 75) * 2f;
+        
+        return WeightedRandom(legendaryRate);
+    }
+}
+```
+
+### Expected Value Calculation
+```
+Single pull cost: 100 Gems ($0.99)
+Legendary rate: 1%
+Pity: 90 pulls
+
+Expected pulls for legendary: 
+- Lucky: ~37 pulls (median with pity)
+- Worst case: 90 pulls (guaranteed)
+- Average: ~62 pulls
+
+Expected cost for legendary:
+- Average: 62 × $0.99 = $61.38
+- Worst: 90 × $0.99 = $89.10
+```
+
+---
+
+## Ad Integration
+
+### Rewarded Video Placement
+```csharp
+public class AdManager
+{
+    public enum AdPlacement
+    {
+        DoubleCoins,      // After level complete
+        ExtraLife,        // On death
+        DailyBonus,       // Once per day
+        SpeedUpTimer,     // Skip wait time
+        FreeGacha         // One free pull
+    }
+    
+    public int GetDailyLimit(AdPlacement placement)
+    {
+        return placement switch
+        {
+            AdPlacement.DoubleCoins => 5,
+            AdPlacement.ExtraLife => 3,
+            AdPlacement.DailyBonus => 1,
+            AdPlacement.SpeedUpTimer => 10,
+            AdPlacement.FreeGacha => 1,
+            _ => 3
+        };
+    }
+}
+```
+
+### Revenue Mix Target
+```
+Typical F2P Mobile Game:
+- IAP: 70%
+- Ads: 25%
+- Subscriptions: 5%
+
+Hyper-Casual:
+- IAP: 20%
+- Ads: 80%
+
+Mid-Core:
+- IAP: 85%
+- Ads: 10%
+- Subscriptions: 5%
+```
+
+---
+
+## AI Economy Generator
+
+### Prompt Template
+```
+Design a F2P economy for a {genre} mobile game.
+
+Requirements:
+- Target ARPU: ${arpu}
+- Session length: {session_length} minutes
+- Retention focus: {D1/D7/D30}
+
+Output:
+1. Currency definitions (soft, hard, premium)
+2. Progression curve (levels 1-50)
+3. IAP catalog (5-8 products)
+4. Ad placements and limits
+5. Revenue projection
+
+Format as JSON.
+```
+
+### Example Output
+```json
+{
+  "currencies": {
+    "coins": {
+      "type": "soft",
+      "earnRate": "10-50 per level",
+      "uses": ["upgrades", "consumables"]
+    },
+    "gems": {
+      "type": "hard",
+      "earnRate": "5 per day from ads",
+      "purchasable": true
+    }
+  },
+  "progression": {
+    "maxLevel": 100,
+    "xpCurve": "level^1.5 * 100",
+    "keyUnlocks": {
+      "5": "Daily Challenges",
+      "10": "PvP Mode",
+      "20": "Guilds"
+    }
+  },
+  "iapCatalog": [
+    {"id": "remove_ads", "price": 2.99, "type": "non_consumable"},
+    {"id": "starter_pack", "price": 4.99, "gems": 500, "oneTime": true},
+    {"id": "gems_100", "price": 0.99, "gems": 100},
+    {"id": "gems_500", "price": 4.99, "gems": 550},
+    {"id": "battle_pass", "price": 9.99, "duration": "30_days"}
+  ],
+  "projectedMetrics": {
+    "arpu": 0.52,
+    "arppu": 8.50,
+    "conversionRate": 0.06
+  }
+}
+```
+
+---
+
+## Balance Simulation
+
+```csharp
+public class EconomySimulator
+{
+    public SimulationResult RunSimulation(EconomyConfig config, int days, int players)
+    {
+        var results = new SimulationResult();
+        
+        for (int p = 0; p < players; p++)
+        {
+            var player = new SimulatedPlayer(GetRandomPlayerType());
+            
+            for (int d = 0; d < days; d++)
+            {
+                player.PlayDay(config);
+                results.TrackDay(player, d);
+            }
+            
+            results.TrackPlayer(player);
+        }
+        
+        return results;
+    }
+    
+    private PlayerType GetRandomPlayerType()
+    {
+        float r = Random.value;
+        if (r < 0.70f) return PlayerType.FreeToPlay;
+        if (r < 0.90f) return PlayerType.Minnow;
+        if (r < 0.98f) return PlayerType.Dolphin;
+        return PlayerType.Whale;
+    }
+}
+
+public enum PlayerType
+{
+    FreeToPlay,  // Never pays
+    Minnow,      // <$10 total
+    Dolphin,     // $10-100 total
+    Whale        // >$100 total
+}
+```
+
+---
+
+## Compliance Considerations
+
+| Regulation | Requirements |
+|------------|--------------|
+| **COPPA** | No IAP targeting <13, parental gates |
+| **GDPR** | Data consent, deletion rights |
+| **Loot Box Laws** | Disclose rates (Belgium, Netherlands ban) |
+| **App Store** | Age ratings, rate disclosure |
+| **Google Play** | Loot box rate disclosure in listing |
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|----------|-------|
+| Pay-to-win mechanics | Pay-to-progress, cosmetics |
+| Hidden probabilities | Transparent gacha rates |
+| Infinite grind walls | Reasonable progression |
+| Target children with IAP | Age-appropriate design |
+| No pity system | Guaranteed outcomes |
+
+---
+
+> **Remember:** A good economy feels fair while being profitable.

package/.agent/skills/game-development/game-marketing/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: game-marketing
+description: Expertise in App Store Optimization (ASO), User Acquisition (UA), and game launch strategies.
+allowed-tools: Read, Write, Edit, Glob, Grep
+---
+
+# 📣 Game Marketing & Growth
+
+> **Purpose:** Maximize game visibility, downloads, and user retention.
+
+---
+
+## 1. App Store Optimization (ASO)
+
+### Keywords & Metadata
+- **Title:** Brand Name + High volume keywords (e.g., "Block Blast - Puzzle Game").
+- **Subtitle/Short Desc:** Hook in 80 chars. Value prop.
+- **Description:** SEO-rich text. First 3 lines matter most.
+
+### Visual Assets
+- **Icon:** High contrast, no small text. Face or character often works best.
+- **Screenshots:** Show gameplay, not just cinematics. Use captions.
+- **Video Preview:** First 5 seconds are critical. Fast cuts.
+
+---
+
+## 2. User Acquisition (UA)
+
+### Channels
+1.  **Organic Social:** TikTok/Shorts (Viral potential), Reddit (Devlogs).
+2.  **Paid Ads:** Meta (Facebook/Instagram), Unity Ads, AppLovin.
+3.  **Influencers:** Streamers/YouTubers (High trust factor).
+
+### Creative Strategy
+- **Gameplay-first:** Show the core loop immediately.
+- **"Fail" Ads:** "Only 1% can pass level 3" (Controversial but effective).
+- **UGC style:** Ads that look like user reviews/TikToks.
+
+---
+
+## 3. Community Building
+
+### Platforms
+- **Discord:** Your "Hardcore" fanbase. Use for beta testing and feedback.
+- **Reddit:** r/gamedev, r/indiegames. Share development journey.
+- **Twitter/X:** Networking with other devs and publishers.
+
+### Engagement
+- **Devlogs:** Regular updates on progress.
+- **Playtests:** Invite community to exclusive builds.
+- **Feedback Loop:** Show that you listen to player suggestions.
+
+---
+
+## 4. Launch Strategy
+
+### Timeline
+1.  **Pre-Registration (1-2 months out):** Build hype, collect emails/wishlists.
+2.  **Soft Launch (Geo-beta):** Release in a cheap market (e.g., Philippines, Brazil) to test retention/monetization and fix bugs.
+3.  **Global Launch:** Marketing blitz. Contact App Store editors for featuring.
+4.  **LiveOps:** Post-launch events, updates, seasonal content.
+
+---
+
+## 5. Analytics & KPIs
+
+| Metric | Meaning | Target (Good) |
+|--------|---------|---------------|
+| **Retention D1** | % Users returning after 1 day | > 35-40% |
+| **Retention D7** | % Users returning after 7 days | > 15-20% |
+| **LTV** | Lifetime Value (Avg $ per user) | > CPI |
+| **CPI** | Cost Per Install (Ad spend) | < LTV |
+
+---
+
+## Usage Example
+
+**User:** "My game is ready, how do I launch?"
+
+**Agent Response:**
+"Don't do a Global Launch immediately.
+1.  **Soft Launch:** Release in Canada or Australia first.
+2.  **Measure:** Check D1 Retention. If < 30%, fix gameplay before spending on ads.
+3.  **ASO:** A/B test your icon and screenshots during soft launch.
+4.  **Global:** Once metrics are healthy, open Pre-registration globally."