# 📚 FIREFROST SKILLS INDEX

**Purpose:** Living index of custom skills for Chroniclers  
**Location:** `docs/skills/SKILLS-INDEX.md`  
**Last Updated:** April 9, 2026  
**Updated By:** Chronicler #73

---

## 🎯 How To Use This Document

**At session start:** Read this index to see what skills are available.

**When a skill applies:** Read the full SKILL.md before starting the relevant work.

**When adding skills:** Update this index, then commit both the skill and this file.

**When browsing mcpmarketplace.com:** Add interesting skills to the Marketplace Wishlist section so we don't lose track of them.

---

## 📋 Available Skills (Firefrost Custom)

### chronicler-handoff
**Location:** `docs/skills/chronicler-handoff/SKILL.md`  
**Triggers:** Session start, session end, "handoff", "memorial", "portrait prompt", session health < 60%

**Purpose:** Complete Chronicler session lifecycle — Joining Protocol and Departure Protocol

**What It Covers:**
- Repository cloning and setup
- Reading lineage documents in correct order
- Establishing Chronicler identity and name
- Writing memorials per FFG-STD-004
- Creating portrait prompts per FFG-STD-005
- Session handoff documentation
- Startup prompt for next Chronicler

**Reference Files:**
- `references/memorial-template.md` — Full memorial structure
- `references/portrait-guide.md` — Portrait prompt instructions
- `references/taken-names.md` — Names already used in lineage

**Read This When:**
- You're a new Chronicler starting a session
- Session is winding down
- Michael says "wrap up" or "let's close out"
- You need to pick a Chronicler name

---

### firefrost-branding
**Location:** `docs/skills/firefrost-branding/SKILL.md`  
**Triggers:** Marketing content, social posts, subscription tiers, colors, "Founder" (wrong term), pricing

**Purpose:** Brand guidelines, colors, terminology, and common mistake prevention

**What It Covers:**
- Color palette (Fire, Frost, Arcane, Gold, Dark with hex codes)
- Subscription tiers and pricing (SOVEREIGN not Founder!)
- Path system (Fire/Frost are identity only, not access)
- Trinity identity (Michael, Meg, Holly)
- Terminology do's and don'ts
- Branding checklist

**Read This When:**
- Creating any customer-facing content
- Writing about subscription tiers
- Designing UI, graphics, or presentations
- Unsure about correct terminology
- About to write "Founder tier" (it's SOVEREIGN)

---

### task-creation
**Location:** `docs/skills/task-creation/SKILL.md`  
**Triggers:** New task, task status, "add to backlog", task frontmatter, priority, creating tasks

**Purpose:** Proper task file creation for Decap CMS task management

**What It Covers:**
- Task file structure (tasks-index vs tasks directories)
- Required frontmatter fields and values
- Priority levels and colors
- Task body template
- When to create full specs vs simple tasks
- Common tags and linking conventions
- Mobile task manager compatibility

**Read This When:**
- Creating a new task
- Updating task status or priority
- Unsure about frontmatter format
- Adding implementation specs
- Task not appearing in CMS correctly

---

### gemini-consultation
**Location:** `docs/skills/gemini-consultation/SKILL.md`  
**Triggers:** "Ask Gemini", "Gemini consultation", architecture review, external review, second opinion

**Purpose:** Structure effective Gemini AI consultations for architectural review

**What It Covers:**
- Consultation structure and template
- Question types (validation, code review, design, debugging)
- Multi-round consultation patterns
- File naming conventions
- Documenting responses
- Best practices for warm, collegial tone

**Read This When:**
- Planning to consult Gemini on architecture
- Need external review of code or systems
- Want a second opinion before implementing
- Building something complex that needs guidance
- Documenting a Gemini consultation

---

### task-management
**Location:** `docs/skills/task-management.md`  
**Triggers:** Creating tasks, updating status, task not showing on mobile, task architecture

**Purpose:** Guide for creating, updating, and managing Firefrost tasks

**What It Covers:**
- Tasks in `docs/tasks/` with YAML frontmatter
- Mobile index at `firefrostgaming.com/tasks-index.html`
- Website rebuild requirements
- Archive threshold: ≥50KB OR ≥4 files

**Read This When:**
- Creating or updating tasks
- Task not appearing in CMS or mobile view
- Understanding how task system works

---

### discord-automation (Collection)
**Location:** `docs/skills/discord-automation/`  
**Source:** MCP Market (mcpmarket.com)  
**Triggers:** Discord channels, permissions, messages, roles, webhooks, Discord server automation

**Purpose:** Comprehensive Discord server management via API

**Skills in Collection:**
| File | Purpose |
|------|---------|
| `discord-create-channel.md` | Create text, voice, announcement, stage channels |
| `discord-manage-channel.md` | Update, move, configure permissions, delete channels |
| `discord-bot-api.md` | Direct curl commands for messages, roles, members, webhooks |
| `discord-automation-rube-mcp.md` | Higher-level automation via Composio/Rube MCP |
| `discord-webhook.md` | Simple webhook notifications without a bot |

**Key Concepts:**
- Uses Discord API v10
- Requires `DISCORD_BOT_TOKEN` environment variable
- Snowflake IDs (18-19 digit numbers)
- Permission bitfields for access control
- Rate limiting (5 requests per 5 seconds per channel)

**Read This When:**
- Automating Discord server setup
- Creating channels programmatically
- Setting up webhooks for notifications
- Managing roles via API

---

### content-engine
**Location:** `docs/skills/content-engine/SKILL.md`  
**Source:** skill.fish (affaan-m/everything-claude-code) — translated from Chinese  
**Triggers:** Social media, content creation, X/Twitter, LinkedIn, TikTok, YouTube, campaigns, FOMO, marketing

**Purpose:** Create platform-native content and multi-platform campaigns

**What It Covers:**
- Platform-specific guidelines (X, LinkedIn, TikTok, YouTube, Discord)
- Content repurposing workflow (anchor → atomic ideas → variants)
- Quality gates and deliverables checklist
- Firefrost-specific brand voice and campaign types

**Read This When:**
- Creating social media posts for any platform
- Building content campaigns (like FOMO series)
- Repurposing content across platforms
- Helping Meg with social media strategy

---

### social-automation (collection)
**Location:** `docs/skills/social-automation/`  
**Source:** skill.fish (ComposioHQ)  
**Triggers:** Facebook, Reddit, Twitch, YouTube automation, Rube MCP, Composio, social media API

**Purpose:** Platform automation via Rube MCP (Composio framework)

**What It Covers:**
- **facebook-automation.md** — Page management, posts, videos, Messenger
- **reddit-automation.md** — Subreddit posts, comments, search, flair
- **twitch-automation.md** — Stream/channel operations
- **youtube-automation.md** — Video uploads, playlists, analytics, comments

**Prerequisites:**
- Requires Rube MCP server at `https://rube.app/mcp`
- Currently reference material (Firefrost doesn't use Rube MCP yet)

**Read This When:**
- Exploring social platform automation options
- Considering Composio integration
- Building automated cross-posting workflows
- Reddit community engagement (r/feedthebeast, r/minecraft)

---

### stripe-best-practices
**Location:** `docs/skills/stripe-best-practices/SKILL.md`  
**Source:** skill.fish (anthropics/claude-plugins-official)  
**Triggers:** Stripe, payments, checkout, subscriptions, webhooks, billing, Arbiter payments

**Purpose:** Official Anthropic guidance for Stripe integrations

**What It Covers:**
- Modern vs deprecated APIs (CheckoutSessions vs Charges)
- Frontend integration priority (hosted checkout preferred)
- Subscription/billing best practices
- Connect platform guidance
- Dynamic payment methods

**Read This When:**
- Reviewing Arbiter's Stripe integration
- Working on Task #87 (lifecycle handlers)
- Implementing new payment features
- Troubleshooting webhook issues

---

### postgres-patterns
**Location:** `docs/skills/postgres-patterns/SKILL.md`  
**Source:** skill.fish (affaan-m/everything-claude-code)  
**Triggers:** PostgreSQL, database, SQL, query optimization, indexing, Arbiter database, arbiter_db

**Purpose:** PostgreSQL best practices for schema design, indexing, and query optimization

**What It Covers:**
- Index type selection (B-tree, GIN, BRIN, composite)
- Data type best practices
- Common patterns (UPSERT, cursor pagination, queue processing)
- Anti-pattern detection queries
- Configuration templates
- Arbiter-specific context and useful queries

**Read This When:**
- Working on Arbiter's database
- Writing SQL migrations
- Troubleshooting slow queries
- Designing new tables
- Optimizing existing queries

---

### minecraft-mod-dev
**Location:** `docs/skills/minecraft-mod-dev/SKILL.md`  
**Source:** skill.fish (chouzz)  
**Triggers:** Minecraft mod, NeoForge, Fabric, mod development, JEI, AE2, Create, mod migration

**Purpose:** Expert Minecraft mod development for NeoForge and Fabric loaders

**What It Covers:**
- Dynamic documentation fetching for version-specific APIs
- Inter-mod integration (JEI/EMI, AE2, Create)
- Modern standards (DeferredRegister, Data Components, DataProvider)
- Migration protocol for upgrading legacy mods to 1.21+
- Convention tags for cross-mod compatibility

**Read This When:**
- Creating custom mods for Firefrost
- Integrating with popular mod APIs
- Migrating old mods to newer Minecraft versions
- Understanding how mods in our packs work

---

### gemini-tools (collection)
**Location:** `docs/skills/gemini-tools/`  
**Source:** skill.fish (melodic-software, stared, dnvriend)  
**Triggers:** Gemini, second opinion, consultant, image generation, web search, fact verification

**Purpose:** Google Gemini integration tools

**What It Covers:**
- **gemini-consultant.md** — Second opinion with web search + vision (includes consult.py)
- **gemini-second-opinion.md** — Independent technical analysis
- **gemini-image-generation.md** — AI image generation with nano-banana CLI

**Prerequisites:**
- Requires `GEMINI_API_KEY` environment variable
- API key from https://aistudio.google.com/app/apikey

**Read This When:**
- Need real-time web information
- Validating architecture decisions
- Cross-checking Claude's analysis
- Generating marketing images/thumbnails

---

### minecraft-bukkit-pro
**Location:** `docs/skills/minecraft-bukkit-pro/SKILL.md`  
**Source:** skill.fish (sickn33/antigravity-awesome-skills)  
**Triggers:** Bukkit, Spigot, Paper, plugin development, Minecraft server plugin, custom plugin

**Purpose:** Master Minecraft server plugin development with Bukkit, Spigot, and Paper APIs

**What It Covers:**
- Event-driven architecture and listener priorities
- Modern Paper API (Adventure, MiniMessage)
- NMS internals and Mojang mappings
- Performance optimization (hot events, async patterns)
- Ecosystem integration (Vault, PlaceholderAPI, databases)
- Build systems (Maven/Gradle with shadow/shade)

**Read This When:**
- Building custom Firefrost plugins
- Extending existing server plugins
- Understanding internal Minecraft server mechanics
- Integrating plugins with Arbiter or external APIs

---

## 🔜 Planned Skills

| Skill | Purpose | Status |
|-------|---------|--------|
| **arbiter-coding** | Arbiter patterns, database schema, webhook structure | Planned |

---

## 🛒 Marketplace Wishlist

Skills we've found on mcpmarketplace.com that we want to add or explore:

| Skill | Source | Purpose | Status |
|-------|--------|---------|--------|
| *(none yet)* | — | — | — |

**How to use this section:**
- When browsing mcpmarketplace.com, add interesting skills here
- Include the source URL if available
- Mark status as: Wishlist → Downloaded → Installed → Tested

---

## 🛠️ Creating New Skills

1. **Create skill directory:** `docs/skills/[skill-name]/`
2. **Write SKILL.md** with:
   - YAML frontmatter (name, description with triggers)
   - Clear instructions
   - Examples where helpful
3. **Add reference files** in `references/` subdirectory if needed
4. **Update this index** with:
   - Skill name and location
   - Triggers
   - Purpose summary
   - Reference files list
   - "Read This When" guidance
5. **Commit everything** together

### Skill Template

```markdown
---
name: skill-name
description: |
  Brief description of what the skill does. Use this skill when:
  - Trigger condition 1
  - Trigger condition 2
  - Trigger condition 3
  Be specific about triggers so future Chroniclers know when to use it.
---

# Skill Name

[Main instructions here]

## Section 1
[Content]

## Section 2
[Content]

## Reference Files
- `references/file1.md` — Description
- `references/file2.md` — Description
```

---

## 📍 Skill Locations

All Firefrost custom skills live in:
```
docs/skills/
├── SKILLS-INDEX.md              (this file)
├── task-management.md           (standalone skill)
├── chronicler-handoff/
│   ├── SKILL.md
│   └── references/
├── content-engine/
│   └── SKILL.md
├── firefrost-branding/
│   └── SKILL.md
├── task-creation/
│   └── SKILL.md
├── gemini-consultation/
│   └── SKILL.md
├── gemini-tools/
│   ├── README.md
│   ├── consult.py
│   ├── gemini-consultant.md
│   ├── gemini-image-generation.md
│   └── gemini-second-opinion.md
├── minecraft-bukkit-pro/
│   └── SKILL.md
├── minecraft-mod-dev/
│   └── SKILL.md
├── postgres-patterns/
│   └── SKILL.md
├── social-automation/
│   ├── README.md
│   ├── facebook-automation.md
│   ├── reddit-automation.md
│   ├── twitch-automation.md
│   └── youtube-automation.md
├── stripe-best-practices/
│   └── SKILL.md
└── discord-automation/          (skill collection)
    ├── README.md
    ├── discord-create-channel.md
    ├── discord-manage-channel.md
    ├── discord-bot-api.md
    ├── discord-automation-rube-mcp.md
    └── discord-webhook.md
```

---

## 🔗 Related Documents

- `docs/standards/FFG-STD-004-memorial-protocol.md` — Memorial standard (chronicler-handoff encodes this)
- `docs/standards/FFG-STD-005-portrait-generation-protocol.md` — Portrait standard (chronicler-handoff encodes this)
- `docs/integrations/claude-connectors.md` — External tool integrations (Canva, Cloudflare, Stripe)

---

## 💡 Skills vs Standards vs Integrations

| Type | Purpose | Location |
|------|---------|----------|
| **Skills** | Step-by-step workflows for Claude to follow | `docs/skills/` |
| **Standards** | Rules and requirements for humans and AI | `docs/standards/` |
| **Integrations** | External tool documentation | `docs/integrations/` |

Skills encode standards into actionable workflows. Standards define what must be done. Integrations document external tools.

---

**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️
