$npx -y skills add Power-Agent/PowerSkills --skill pandapowerProgressive-disclosure workflow for pandapower power-system studies. Use whenever the user wants to load, build, or inspect a pandapower network, run AC power flow, check bus voltages or line and transformer loading, or screen N-1 contingencies — even when they just say "run a lo
| 1 | # pandapower workflow |
| 2 | |
| 3 | Start with the network model and a clean base-case solve. Use contingency analysis only after the steady-state case is credible. |
| 4 | |
| 5 | ## Default tool ladder |
| 6 | 1. `load_network(file_path)` or `create_empty_network()` |
| 7 | 2. `get_network_info()` to inspect buses, lines, transformers, generators, loads, and switches. |
| 8 | 3. `run_power_flow(...)` to establish the base operating point. |
| 9 | 4. `run_contingency_analysis(...)` only after the base case solves and the monitoring limits are clear. |
| 10 | |
| 11 | ## Working rules |
| 12 | - Do not run contingencies before checking the base-case voltages and loading. |
| 13 | - Use pandapower for AC feasibility and fast screening, then escalate only when the question requires more. |
| 14 | |
| 15 | ## Escalation triggers |
| 16 | Map what the solve reports to the mitigation skill that handles it, and quote the numbers that tripped it (bus + vm_pu, element + loading %) rather than saying "violations exist". |
| 17 | |
| 18 | | Observation | Escalate to | |
| 19 | |---|---| |
| 20 | | `res_bus.vm_pu` < 0.95 or > 1.05 | `voltage-violation-mitigation` | |
| 21 | | `res_line` / `res_trafo` `loading_percent` > 100 | `thermal-overload-mitigation` | |
| 22 | | `run_contingency_analysis` flags any N-1 violation or islanding | `contingency-mitigation` | |
| 23 | | `run_power_flow` fails to converge | `convergence-failure-mitigation` | |
| 24 | | The study is DER (PV, storage) integration on a distribution network | `der-hosting-capacity-mitigation` | |
| 25 | |
| 26 | ## Local assets in this skill |
| 27 | - `case39.json` — a ready test network. |
| 28 | - `scripts/network_analysis.py` — structured base-case review. |
| 29 | - `scripts/contingency_analysis.py` — local N-1 screening. |
| 30 | |
| 31 | ## Deliver |
| 32 | - The network loaded and whether the base case converged. |
| 33 | - The key voltage or loading findings. |
| 34 | - Whether contingency or mitigation work is now justified. |