Skip to content

fix(deploy-on-aws): add Kiro post-install script for aws-architecture-diagram scripts - #272

Open
iamharshtita wants to merge 1 commit into
awslabs:mainfrom
iamharshtita:fix/kiro-diagram-skill-scripts
Open

iamharshtita wants to merge 1 commit into
awslabs:mainfrom
iamharshtita:fix/kiro-diagram-skill-scripts

Conversation

@iamharshtita

Copy link
Copy Markdown

Summary

When Kiro users install the deploy-on-aws plugin using the documented compound-plugin converter, the aws-architecture-diagram skill is partially installed — SKILL.md and references/ are copied correctly, but the plugin-level scripts/ folder is never included.

This happens because the converter's copySkillDir function only walks skills/<skill-name>/ and has no concept of plugin-level shared assets. The aws-architecture-diagram SKILL.md references these scripts via ${PLUGIN_ROOT}/scripts/lib/, a Claude Code runtime variable that has no equivalent in Kiro. As a result, fix_step_badges.py and drawio_url.py are silently missing after every Kiro install, causing the diagram skill to produce corrupted preview URLs and unvalidated badge positions.

This PR adds install-kiro-scripts.sh — a lightweight post-install script for Kiro users that downloads the missing scripts, installs their Python dependency (defusedxml), and patches the ${PLUGIN_ROOT} path references in SKILL.md to the actual installed location. The README Kiro section is updated with this as a required step after the existing compound-plugin install command.

Related

Changes

  • plugins/deploy-on-aws/scripts/install-kiro-scripts.sh — new post-install script for Kiro that:
    • Downloads fix_step_badges.py, drawio_url.py, fix_icon_colors.py, fix_nesting.py, post_process_drawio.py, validate_drawio.py, and aws4-shapes.json into ~/.kiro/skills/aws-architecture-diagram/scripts/lib/
    • Installs defusedxml via requirements.txt
    • Patches ${PLUGIN_ROOT} → actual skill path in SKILL.md
    • Supports --project flag for project-scoped installs (.kiro/ vs ~/.kiro/)
    • Validates the skill is installed before running and gives clear guidance if not
  • README.md — adds "Install scripts for aws-architecture-diagram (required)" section under the Kiro install instructions with the one-line curl command for both global and project-scoped installs

No changes to Claude Code, Codex, or Cursor install paths. mise build passes locally with no new errors or warnings introduced by these changes.

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.

…-diagram

The compound-plugin converter only copies skills/<name>/ and does not
install the plugin-level scripts/ folder. The aws-architecture-diagram
skill references these via ${PLUGIN_ROOT}/scripts/lib/, which has no
equivalent in Kiro, so fix_step_badges.py and drawio_url.py are never
found after a Kiro install.

Add install-kiro-scripts.sh that:
- Downloads plugin-level scripts into the installed skill directory
- Installs the defusedxml Python dependency via requirements.txt
- Patches ${PLUGIN_ROOT} references in SKILL.md to the actual path
- Supports both global (~/.kiro) and project-scoped (.kiro/) installs

Update README.md Kiro section with the required post-install step.
Zero impact on Claude Code, Codex, or Cursor installs.

By submitting this pull request, I confirm that you can use, modify,
copy, and redistribute this contribution, under the terms of the
project license.
@iamharshtita
iamharshtita requested review from a team as code owners September 11, 2026 18:11
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.

1 participant