From a6f3cde9996cb835c11bc4ded29f468c82412aca Mon Sep 17 00:00:00 2001
From: Toru Makabe <993850+torumakabe@users.noreply.github.com>
Date: Mon, 2 Feb 2026 08:58:51 +0900
Subject: [PATCH] docs: add prerequisites and troubleshooting to SKILL.md

---
 skills/terraform-azurerm-set-diff-analyzer/SKILL.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/skills/terraform-azurerm-set-diff-analyzer/SKILL.md b/skills/terraform-azurerm-set-diff-analyzer/SKILL.md
index bfae51ff..2d366793 100644
--- a/skills/terraform-azurerm-set-diff-analyzer/SKILL.md
+++ b/skills/terraform-azurerm-set-diff-analyzer/SKILL.md
@@ -20,6 +20,12 @@ Terraform's Set type compares by position rather than by key, so when adding or
 
 These "false-positive diffs" don't actually affect the resources, but they make reviewing terraform plan output difficult.
 
+## Prerequisites
+
+- Python 3.8+
+
+If Python is unavailable, install via your package manager (e.g., `apt install python3`, `brew install python3`) or from [python.org](https://www.python.org/downloads/).
+
 ## Basic Usage
 
 ```bash
@@ -31,6 +37,11 @@ terraform show -json plan.tfplan > plan.json
 python scripts/analyze_plan.py plan.json
 ```
 
+## Troubleshooting
+
+- **`python: command not found`**: Use `python3` instead, or install Python
+- **`ModuleNotFoundError`**: Script uses only standard library; ensure Python 3.8+
+
 ## Detailed Documentation
 
 - [scripts/README.md](scripts/README.md) - All options, output formats, exit codes, CI/CD examples