SKILL.md

name: k-ecosystem description: > Context for the Mechanic/Fen WoW addon development ecosystem. Covers all components (Mechanic, FenCore, FenUI, MechanicLib), their relationships, and AFD principles. Load this at the start of addon work. Triggers: ecosystem, fen, fencore, fenui, mechanic, addon, context.

Fen Ecosystem

Name: k-ecosystem
Rating: 70
Author: Falkicon

The Mechanic/Fen ecosystem is a unified platform for WoW addon development.

The Reload Loop (MANDATORY)

After ANY addon code change, you MUST verify the changes in-game:

Ask the user to /reload in WoW (or trigger via keybinding CTRL+SHIFT+R)
Wait for the user to confirm the reload is complete
Then use the addon.output MCP tool (agent_mode=true) to get errors, tests, and console logs

CRITICAL: Do NOT call addon.output immediately after changes. The timing between reload and SavedVariables sync is unpredictable. Always wait for user confirmation.

Ecosystem Components

Component	Purpose	Key Tools
Mechanic	Development hub (CLI, MCP, Dashboard)	`env.status`, `addon.output`, `addon.lint`, `addon.test`
FenCore	Pure logic library (no UI dependencies)	`fencore.catalog`, `fencore.search`, `fencore.info`
FenUI	UI widget library (frames, layouts)	`Layout`, `Panel`, `Tabs`, `Grid`, `Buttons`
MechanicLib	Bridge library (addon ↔ Mechanic)	`RegisterAddon`, `Print`, `RegisterTest`

Component Relationships

┌─────────────────────────────────────────────────────┐
│                    Your Addon                        │
├─────────────────────────────────────────────────────┤
│  Core Layer     │  Bridge Layer   │  View Layer     │
│  (Pure Logic)   │  (Events/Data)  │  (UI Frames)    │
│                 │                 │                 │
│  Uses: FenCore  │  Uses: Ace3     │  Uses: FenUI    │
└─────────────────────────────────────────────────────┘
         │                 │                 │
         └────────────┬────┴─────────────────┘
                      │
              ┌───────▼───────┐
              │  MechanicLib  │  (Registers addon with Mechanic)
              └───────┬───────┘
                      │
              ┌───────▼───────┐
              │   Mechanic    │  (Development hub)
              └───────────────┘

Essential MCP Tools

Task	MCP Tool
Get Addon Output	`addon.output(agent_mode=true)`
Lint Code	`addon.lint(addon="MyAddon")`
Run Tests	`addon.test(addon="MyAddon")`
Search APIs	`api.search(query="Spell")`
Search FenCore	`fencore.search(query="clamp")`
Env Status	`env.status()`

AFD Core Principles

Mechanic follows Agent-First Development (AFD) — github.com/Falkicon/afd

Tool-First: All functionality exists as an MCP tool before any UI
Structured Results: Tools return predictable JSON with success, data, error
Agent Mode: Use agent_mode=true for AI-optimized output

k-mechanic - Deep dive into Mechanic tools
k-fencore - FenCore library details
k-fenui - FenUI widget library

Score

Total Score

70/100

Based on repository quality metrics

✓SKILL.md

SKILL.mdファイルが含まれている

+20

✓LICENSE

ライセンスが設定されている

+10

✓説明文

100文字以上の説明がある

+10

○人気

GitHub Stars 100以上

0/15

○最近の活動

3ヶ月以内に更新がある

0/10

○フォーク

10回以上フォークされている

0/5

✓Issue管理

オープンIssueが50未満

+5

✓言語

プログラミング言語が設定されている

+5

○タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon

k-ecosystem