# Power Builder

> Complete guide for building and testing new Kiro Powers with templates, best practices, and validation. Use when mentioning power builder, create power, build power, or Kiro power development.

- Skill: `whchoi98/power-builder` (Agent Skill)
- Install (CLI): `npx skillmds@latest add whchoi98/power-builder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/whchoi98/power-builder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: whchoi98 (https://skillmd.com/u/whchoi98)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/whchoi98/power-builder

---


# Power Builder

## Overview
Guide for building Kiro Powers. Two types:
- **Guided MCP Power** — MCP server config + documentation (has mcp.json)
- **Knowledge Base Power** — Pure documentation (no mcp.json)

## Power Structure
```
my-power/
├── POWER.md       # Required: metadata + documentation
├── mcp.json       # Required for Guided MCP Powers only
└── steering/      # Optional: workflow guides
```

## POWER.md Frontmatter (5 fields only)
```yaml
---
name: "power-name"
displayName: "Human Readable Name"
description: "Clear description (max 3 sentences)"
keywords: ["keyword1", "keyword2"]
author: "Your Name"
---
```

## Best Practices
- Default to single power (only split with strong conviction)
- Use kebab-case for power names
- Include 5-7 keywords
- Document exact MCP tool names
- Create steering/ only when POWER.md >500 lines
- No MCP server needed for Knowledge Base Powers