Skip to content

Add Kiro Power support with POWER.md generation and MCP integration#32

Draft
antonbabenko wants to merge 2 commits into
masterfrom
claude/kiro-powers-integration-9MkMl
Draft

Add Kiro Power support with POWER.md generation and MCP integration#32
antonbabenko wants to merge 2 commits into
masterfrom
claude/kiro-powers-integration-9MkMl

Conversation

@antonbabenko
Copy link
Copy Markdown
Owner

Description

This PR adds support for distributing the terraform-skill as a Kiro Power alongside the existing Claude Code plugin. It introduces:

  1. POWER.md generation — A new build script (build-power.js) that generates POWER.md from the single source of truth (SKILL.md), rewriting relative links to resolve from the repo root. The generated file includes frontmatter (name, displayName, keywords, author, version) sourced from SKILL.md and .codex-plugin/plugin.json.

  2. MCP integration — An optional mcp.json that registers the HashiCorp terraform-mcp-server for read-only Terraform Registry and provider/module documentation lookups. The Kiro Power references this server in its documentation.

  3. CI validation — Extended validate.yml to check that POWER.md is in sync with SKILL.md (via build-power.js --check), validate frontmatter structure, and confirm MCP servers referenced in mcp.json are mentioned in POWER.md.

  4. Release automation — Updated pre-commit.js to regenerate POWER.md during the release process, ensuring the release commit and tag carry an in-sync tree (same pattern as the Codex manifest).

  5. Documentation — Updated CLAUDE.md and README.md to explain the Kiro Power distribution channel and how users can install it.

Type of change:

  • New content (Kiro Power distribution)
  • Documentation (README, CLAUDE.md updates)
  • Testing framework improvement (CI validation for POWER.md sync)

Summary:

The terraform-skill now ships as a Kiro Power in addition to the Claude Code plugin. Users can install it via Kiro's "Add power from GitHub" feature. The skill content remains in SKILL.md (single source of truth); POWER.md is generated deterministically and CI-owned, never hand-edited. This mirrors the existing pattern for .codex-plugin/plugin.json.

Testing Evidence

Scenarios Tested

  • POWER.md generation is deterministic and idempotent
  • POWER.md frontmatter is valid YAML with required fields
  • Relative links in SKILL.md are correctly rewritten to resolve from repo root
  • CI validation catches out-of-sync POWER.md
  • Release pre-commit hook regenerates POWER.md
  • MCP server references in mcp.json are validated against POWER.md content

Baseline Behavior (WITHOUT changes)

No POWER.md or MCP support existed. Users could only install via Claude Code plugin or manual symlink.

Compliance Behavior (WITH changes)

1. User visits Kiro Powers panel → "Add power from GitHub"
2. Pastes: https://github.com/antonbabenko/terraform-skill
3. Kiro fetches POWER.md, parses frontmatter, activates on keyword match
4. Optional: Kiro registers terraform-mcp-server from mcp.json
5. Skill content is identical to Claude Code version (shared SKILL.md)

Evidence of Improvement

  • POWER.md is generated from SKILL.md (no content duplication)
  • CI validates sync on every PR touching SKILL.md, POWER.md, or mcp.json
  • Release automation ensures tag carries in-sync artifacts
  • Documentation explains the new distribution channel

Standards Compliance Checklist

Frontmatter (POWER.md)

  • Frontmatter includes name, displayName, description, keywords, author, version
  • Keywords sourced from .codex-plugin/plugin.json
  • Version synced from SKILL.md
  • Description matches SKILL.md

Token Efficiency

  • No new content added to SKILL.md (only link rewrites in generated POWER.md)
  • SKILL.md remains ~299

https://claude.ai/code/session_01R8XutkcqBDWDCEWMJJ8w2f

claude and others added 2 commits May 19, 2026 17:40
Generate a root POWER.md from SKILL.md (single source of truth; references
are not moved, links are rewritten to resolve from repo root) plus an
optional read-only terraform-mcp-server mcp.json. The release pre-commit
hook regenerates and stages POWER.md alongside the SKILL.md/codex version
sync so tags carry an in-sync tree, and validate.yml runs build-power.js
--check to block drift.

https://claude.ai/code/session_01R8XutkcqBDWDCEWMJJ8w2f
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants