npuzsy/simulink-power-electronics

# Simulink Power Electronics

Use this skill for Simulink/Simscape Electrical power-electronics work:
model inspection, waveform/control debugging, schematic layout, validation, and
user-approved corpus self-improvement. Keep conclusions grounded in inspected
block paths, logged signals, simulations, and numeric checks.

## Core Workflow

1. At the start of a session, look for and use the local `superpowers`
   skill or other skill which has a likely name when it is installed. It is valuable process guidance for selecting
   and sequencing other skills; user instructions still take precedence.
2. Classify by domain, topology, and control objective.
3. Load only the narrow context needed: usually `references/workflow.md`, one

# Batteries And BMS

## Status

Stub. Use this file only to recognize battery/BMS scope and choose evidence to collect. Apply the root workflow; do not infer battery, charger, or BMS rules from inverter diagnostics.

## Scope

- battery packs and charger power stages
- BMS-linked converter behavior
- cell balancing and protection events
- SOC/SOH-linked control behavior
- bidirectional charging and storage converter interfaces

# DC-DC Converters

## Status

Developing subskill. Use this file to recognize DC-DC converter scope and choose evidence to collect. Apply the root workflow; do not reuse inverter waveform-balance rules for regulation or ripple problems.

Read `references/inspection.md` for corpus-derived inspection notes before diagnosing DC-DC examples. Treat those notes as developing guidance, not a complete methodology.

For generated or repaired Simscape Electrical schematics, also read
`../../references/simscape-layout.md`. DC-DC converters are sensitive to
schematic readability because the return node, switch node, and output node are
high-degree physical networks that generic automatic layout often routes poorly.

## Scope

# HVDC And FACTS

## Status

Stub. Use this file only to recognize HVDC/FACTS scope and choose evidence to collect. Apply the root workflow; this repository does not yet provide HVDC/FACTS-specific validation rules.

## Scope

- VSC-HVDC and LCC-HVDC systems
- STATCOM, SVC, UPFC, and related FACTS devices
- transmission-level power-flow and voltage regulation
- grid disturbance, protection, and recovery studies
- converter station control and measurement paths

# Motor Drives

## Status

Developing subskill. Use this file to recognize motor-drive scope and choose evidence to collect. Apply the root `simulink-power-electronics` workflow; do not reuse grid-inverter assumptions unless the inspected model path is genuinely shared.

Read `references/inspection.md` for corpus-derived inspection notes before diagnosing motor-drive examples. Treat those notes as developing guidance, not a complete methodology.

## Scope

- PMSM, BLDC, and induction motor drives
- field-oriented control, direct torque control, six-step control, and current/torque/speed loops
- inverter-fed machine gate, phase-current, torque, and speed validation
- encoder, resolver, Hall, or sensorless feedback paths

# Multilevel And MMC

## Status

Stub. Use this file only to recognize broader multilevel/MMC scope and choose evidence to collect. The active inverter subskill covers only its populated T-type/NPC three-level SVPWM notes.

## Scope

- modular multilevel converters
- cascaded H-bridge and flying-capacitor converters
- capacitor voltage balancing
- arm energy and circulating-current control
- multilevel modulation and switching-state validation beyond the existing three-level inverter table

# Rectifiers And Active Front Ends

## Status

Stub. Use this file only to recognize rectifier/AFE scope and choose evidence to collect. Apply the root workflow; this is not yet a populated rectifier or PFC methodology.

## Scope

- diode, thyristor, and controlled rectifiers
- PWM rectifiers and active front ends
- PFC stages and line-current quality
- DC-link voltage regulation and regenerative power flow
- input filter and grid-side measurement validation

# Renewable And Grid Systems

## Status

Stub. Use this file only to recognize renewable/grid-system scope and choose evidence to collect. Apply the root workflow and any active converter subskill that matches the plant; grid-code and PLL checks are not yet fully specified here.

## Scope

- photovoltaic and wind power conversion systems
- storage-coupled inverters and hybrid plants
- microgrids and grid-forming/grid-following studies
- MPPT, PLL, synchronization, islanding, and ride-through behavior
- grid-code-oriented validation evidence

# Three-Phase Grid Inverter

## Overview

Use this active subskill for three-phase grid-connected inverter work. It contains the populated knowledge in this repository: T-type/NPC three-level SVPWM, state-vector table checks, gate mapping, From/Goto routing risks, and simulation-backed waveform validation.

Use the root `simulink-power-electronics` workflow first, then load this subskill when the model is in scope.

## Resource Map

- Read `references/svpwm-three-level.md` for T-type or NPC three-level SVPWM logic, sector handling, and gate mapping.
- Read `references/table7-state-vectors.md` when auditing or rebuilding the 36 small-sector state-vector table.
- Read `references/vsg-control-notes.md` for VSG (Virtual Synchronous Generator) control implementation, PI tuning experience, power calculation verification, and feedforward formulas specific to grid-connected inverters.
- Use `scripts/svpwm_diagnostics.m` when MATLAB/Simulink can run and the model exposes state, gate, and voltage signals.

# Wireless Power And Resonant Converters

## Status

Stub. Use this file only to recognize resonant or wireless-power scope and choose evidence to collect. Apply the root workflow; this repository does not yet provide resonant-converter or wireless-power-specific checks.

## Scope

- resonant DC-DC converters
- inductive wireless power transfer systems
- compensation networks and coupled coils
- frequency-control and soft-switching behavior
- resonant-tank voltage/current validation