Heady Code Generation Skill

Use this skill whenever a task requires generating, transforming, documenting, or refactoring code through Heady's specialized code agents.

Tools Overview

Tool Details

HeadyCoder — mcp_Heady_heady_coder

Use orchestrate when the task involves creating or modifying multiple interdependent files. Use scaffold when setting up a new project structure.

HeadyCodex — mcp_Heady_heady_codex

Use transform to convert code between patterns (e.g., callbacks → async/await). Use document to auto-generate JSDoc, docstrings, or inline comments.

HeadyCopilot — mcp_Heady_heady_copilot

HeadyRefactor — mcp_Heady_heady_refactor

Decision Matrix

Need new code from scratch?           → heady_coder (action: generate)
Need to scaffold a project?           → heady_coder (action: scaffold)
Need multi-file coordinated changes?  → heady_coder (action: orchestrate)
Need to transform existing code?      → heady_codex (action: transform)
Need to add documentation to code?    → heady_codex (action: document)
Need quick inline suggestions?        → heady_copilot
Need to improve code quality?         → heady_refactor

Chaining Patterns

Generate → Refactor → Document

1. mcp_Heady_heady_coder(prompt="build X", language="javascript")
2. mcp_Heady_heady_refactor(code="{result}", goals=["performance", "readability"])
3. mcp_Heady_heady_codex(code="{refactored}", action="document")

Generate → Battle Validate

For critical code, validate quality through competitive evaluation:

1. mcp_Heady_heady_coder(prompt="implement Y")
2. mcp_Heady_heady_battle(action="evaluate", code="{result}", criteria="production-readiness")

Tips

• Always specify language — it dramatically improves output quality
• Include framework when generating web code — framework-specific idioms matter
• Use heady_refactor with specific goals — don't just say "refactor", specify what you're optimizing for
• Chain with heady_patterns before refactoring to understand the existing architecture