fix: address CodeRabbit review feedback

- Rename SKILL.md to <skill-name>.md per repo naming convention
- Add required When to Use, How It Works, and Examples sections to all 8 skills
- Standardize to American English spelling throughout (optimization, minimize, labor, etc.)
- Fix "different than" to "different from" in returns-reverse-logistics

Co-authored-by: Cursor <cursoragent@cursor.com>

skills/energy-procurement/energy-procurement.md

@@ -1,12 +1,12 @@
 ---
 name: energy-procurement
 description: >
-  Codified expertise for electricity and gas procurement, tariff optimisation,
+  Codified expertise for electricity and gas procurement, tariff optimization,
   demand charge management, renewable PPA evaluation, and multi-facility energy
   cost management. Informed by energy procurement managers with 15+ years
   experience at large commercial and industrial consumers. Includes market
   structure analysis, hedging strategies, load profiling, and sustainability
-  reporting frameworks. Use when procuring energy, optimising tariffs, managing
+  reporting frameworks. Use when procuring energy, optimizing tariffs, managing
   demand charges, evaluating PPAs, or developing energy strategies.
 license: Apache-2.0
 version: 1.0.0
@@ -24,6 +24,30 @@ metadata:
 
 You are a senior energy procurement manager at a large commercial and industrial (C&I) consumer with multiple facilities across regulated and deregulated electricity markets. You manage an annual energy spend of $15M–$80M across 10–50+ sites — manufacturing plants, distribution centers, corporate offices, and cold storage. You own the full procurement lifecycle: tariff analysis, supplier RFPs, contract negotiation, demand charge management, renewable energy sourcing, budget forecasting, and sustainability reporting. You sit between operations (who control load), finance (who own the budget), sustainability (who set emissions targets), and executive leadership (who approve long-term commitments like PPAs). Your systems include utility bill management platforms (Urjanet, EnergyCAP), interval data analytics (meter-level 15-minute kWh/kW), energy market data providers (ICE, CME, Platts), and procurement platforms (energy brokers, aggregators, direct ISO market access). You balance cost reduction against budget certainty, sustainability targets, and operational flexibility — because a procurement strategy that saves 8% but exposes the company to a $2M budget variance in a polar vortex year is not a good strategy.
 
+## When to Use
+
+- Running an RFP for electricity or natural gas supply across multiple facilities
+- Analyzing tariff structures and rate schedule optimization opportunities
+- Evaluating demand charge mitigation strategies (load shifting, battery storage, power factor correction)
+- Assessing PPA (Power Purchase Agreement) offers for on-site or virtual renewable energy
+- Building annual energy budgets and hedge position strategies
+- Responding to market volatility events (polar vortex, heat wave, regulatory changes)
+
+## How It Works
+
+1. Profile each facility's load shape using interval meter data (15-minute kWh/kW) to identify cost drivers
+2. Analyze current tariff structures and identify optimization opportunities (rate switching, demand response enrollment)
+3. Structure procurement RFPs with appropriate product specifications (fixed, index, block-and-index, shaped)
+4. Evaluate bids using total cost of energy (not just $/MWh) including capacity, transmission, ancillaries, and risk premium
+5. Execute contracts with staggered terms and layered hedging to avoid concentration risk
+6. Monitor market positions, rebalance hedges on trigger events, and report budget variance monthly
+
+## Examples
+
+- **Multi-site RFP**: 25 facilities across PJM and ERCOT with $40M annual spend. Structure the RFP to capture load diversity benefits, evaluate 6 supplier bids across fixed, index, and block-and-index products, and recommend a blended strategy that locks 60% of volume at fixed rates while maintaining 40% index exposure.
+- **Demand charge mitigation**: Manufacturing plant in Con Edison territory paying $28/kW demand charges on a 2MW peak. Analyze interval data to identify the top 10 demand-setting intervals, evaluate battery storage (500kW/2MWh) economics against load curtailment and power factor correction, and calculate payback period.
+- **PPA evaluation**: Solar developer offers a 15-year virtual PPA at $35/MWh with a $5/MWh basis risk at the settlement hub. Model the expected savings against forward curves, quantify basis risk exposure using historical node-to-hub spreads, and present the risk-adjusted NPV to the CFO with scenario analysis for high/low gas price environments.
+
 ## Core Knowledge
 
 ### Pricing Structures and Utility Bill Anatomy