@nomad-e/bluma-cli 0.6.9 → 0.8.0

package/dist/config/skills/pdf/SKILL.md

@@ -18,6 +18,13 @@ license: Proprietary. LICENSE.txt has complete terms
 > design agency, not a script. Typography, spacing, color, and hierarchy are
 > not optional — they are the foundation of a credible document.
 
+## Prerequisites
+
+- **Python 3.10+** installed and available in PATH
+- Install dependencies: `pip install reportlab pypdf`
+- If any script fails with `command not found` or `ModuleNotFoundError`, Python or its
+  packages are missing — install them before proceeding
+
 ## MANDATORY workflow — new multi-page reports (read first)
 
 Ad-hoc 30-line ReportLab scripts are the #1 cause of “cheap PDF” output (no

package/dist/config/skills/pdf/scripts/create_report.py

@@ -46,8 +46,24 @@ from pathlib import Path
 from typing import Any
 from xml.sax.saxutils import escape
 
-from reportlab.lib.pagesizes import A4
-from reportlab.lib.units import cm
+MIN_PYTHON = (3, 10)
+if sys.version_info < MIN_PYTHON:
+    print(
+        f"Error: Python {'.'.join(map(str, MIN_PYTHON))}+ is required "
+        f"(found {'.'.join(map(str, sys.version_info[:3]))})",
+        file=sys.stderr,
+    )
+    sys.exit(1)
+
+try:
+    from reportlab.lib.pagesizes import A4
+    from reportlab.lib.units import cm
+except ImportError:
+    print(
+        "Error: reportlab is required. Install with: pip install reportlab",
+        file=sys.stderr,
+    )
+    sys.exit(1)
 from reportlab.lib.colors import HexColor
 from reportlab.lib.styles import ParagraphStyle
 from reportlab.lib.enums import TA_CENTER, TA_JUSTIFY

package/dist/config/skills/pdf/scripts/merge_pdfs.py

@@ -8,6 +8,15 @@ Usage:
 import argparse
 import sys
 
+MIN_PYTHON = (3, 10)
+if sys.version_info < MIN_PYTHON:
+    print(
+        f"Error: Python {'.'.join(map(str, MIN_PYTHON))}+ is required "
+        f"(found {'.'.join(map(str, sys.version_info[:3]))})",
+        file=sys.stderr,
+    )
+    sys.exit(1)
+
 def merge_pdfs(input_files: list[str], output_path: str) -> None:
     try:
         from pypdf import PdfWriter, PdfReader

package/dist/config/skills/xlsx/SKILL.md

@@ -16,6 +16,14 @@ license: Proprietary. LICENSE.txt has complete terms
 
 # XLSX — Spreadsheet Creation, Editing & Analysis
 
+## Prerequisites
+
+- **Python 3.10+** installed and available in PATH
+- Install dependencies: `pip install openpyxl pandas`
+- **LibreOffice** installed (required by `recalc.py` for formula recalculation)
+- If any script fails with `command not found` or `ModuleNotFoundError`, Python or its
+  packages are missing — install them before proceeding
+
 ## Core Principle
 
 > **Formulas, not hardcodes.** Every calculated value MUST be an Excel

package/dist/config/skills/xlsx/scripts/recalc.py

@@ -19,6 +19,15 @@ import os
 import sys
 import time
 
+MIN_PYTHON = (3, 10)
+if sys.version_info < MIN_PYTHON:
+    print(
+        f"Error: Python {'.'.join(map(str, MIN_PYTHON))}+ is required "
+        f"(found {'.'.join(map(str, sys.version_info[:3]))})",
+        file=sys.stderr,
+    )
+    sys.exit(1)
+
 SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
 sys.path.insert(0, SCRIPT_DIR)