shortcutxl 0.2.0

package/skills/integrations/ice-fixed-income.md

@@ -0,0 +1,344 @@
+**ICE Fixed Income Excel Formula Guide**
+
+**Intro**
+You have full access to ICE fixed income data through the ICE XL Excel Add-in, but you should only pull ICE data **when the user explicitly tells you to**. ICE (Intercontinental Exchange) provides comprehensive pricing, analytics, and reference data for bonds, derivatives, and other fixed income instruments. You can retrieve any data point by writing RTD formulas directly in Excel cells.
+
+**IMPORTANT:** Before completing a task involving ICE, you must verify:
+1. Your RTD formulas do not return errors.
+2. All values should seem reasonable and make intuitive sense based on your general knowledge of fixed income markets.
+3. Use cell references for symbols and fields when possible as opposed to hardcoded values.
+4. Be aware of symbol conventions - different instrument types have different formats.
+5. Real-time data requires active market connection; historical data uses different request types.
+
+You should essentially gut check every value that shows up. If there are any errors or the values seem wrong, you likely wrote the formula syntax incorrectly or are using invalid symbol formats. Please correct the formula until it outputs the proper value.
+
+**Note:** ICE XL is a Pattern B integration. Standard pricing and analytics work directly, but some advanced features or custom fields may require reference to ICE platform documentation.
+
+---
+
+**ICE XL Excel Functions Overview**
+
+ICE XL uses Excel's RTD (Real-Time Data) function:
+
+| Function | Purpose | Use Case |
+|----------|---------|----------|
+| RTD (ice.xl) | Real-time/historical data | All ICE data retrieval |
+
+**Request Types:**
+| Type | Description |
+|------|-------------|
+| `*Q` | Real-time quote |
+| `*H` | Historical data |
+| `*R` | Reference data |
+| `*A` | Analytics |
+
+---
+
+**1. RTD Formula Syntax**
+
+**Real-Time Quote:**
+=RTD("ice.xl",,"*Q","Symbol","Field")
+
+**Historical Data:**
+=RTD("ice.xl",,"*H","Symbol","Field","Granularity","Date")
+
+**Reference Data:**
+=RTD("ice.xl",,"*R","Symbol","Field")
+
+**Parameters:**
+| Parameter | Description | Required |
+|-----------|-------------|----------|
+| "ice.xl" | ICE XL server name | Yes |
+| (blank) | Server parameter (leave empty) | Yes |
+| Request Type | *Q, *H, *R, or *A | Yes |
+| Symbol | Instrument identifier | Yes |
+| Field | Data field name | Yes |
+| Granularity | Time frequency (for *H) | For historical |
+| Date | Point-in-time date (for *H) | For historical |
+
+---
+
+**2. Real-Time Quotes (*Q)**
+
+Returns live market data for tradeable instruments.
+
+**Syntax:** =RTD("ice.xl",,"*Q","Symbol","Field")
+
+**Examples:**
+=RTD("ice.xl",,"*Q","BRN 1!-ICE","Last")
+-> Brent crude front month last price.
+
+=RTD("ice.xl",,"*Q","UST10Y","Yield")
+-> 10-year US Treasury yield.
+
+=RTD("ice.xl",,"*Q","EUR=","Bid")
+-> EUR/USD bid price.
+
+=RTD("ice.xl",,"*Q","ES 1!-CME","Last")
+-> S&P 500 E-mini front month.
+
+---
+
+**3. Historical Data (*H)**
+
+Returns historical time series data.
+
+**Syntax:** =RTD("ice.xl",,"*H","Symbol","Field","Granularity","Date")
+
+**Granularity Codes:**
+| Code | Description |
+|------|-------------|
+| D | Daily |
+| W | Weekly |
+| M | Monthly |
+| I1 | 1-minute bars |
+| I5 | 5-minute bars |
+| I15 | 15-minute bars |
+| I60 | 60-minute bars |
+
+**Examples:**
+=RTD("ice.xl",,"*H","BRN 1!-ICE","Last","D",DATE(2024,9,10))
+-> Brent crude price on Sep 10, 2024.
+
+=RTD("ice.xl",,"*H","UST10Y","Yield","D",DATE(2024,1,1))
+-> 10Y Treasury yield on Jan 1, 2024.
+
+=RTD("ice.xl",,"*H","GC 1!-CMX","Last","W",DATE(2024,6,1))
+-> Gold weekly price as of June 1, 2024.
+
+---
+
+**4. Symbol Formats**
+
+**Futures:**
+| Market | Format | Example |
+|--------|--------|---------|
+| ICE Brent | `BRN {month}!-ICE` | `BRN 1!-ICE` (front month) |
+| ICE WTI | `WTI {month}!-ICE` | `WTI 1!-ICE` |
+| ICE Gas Oil | `GAS {month}!-ICE` | `GAS 1!-ICE` |
+| CME Gold | `GC {month}!-CMX` | `GC 1!-CMX` |
+| CME S&P 500 | `ES {month}!-CME` | `ES 1!-CME` |
+| CME Eurodollar | `ED {month}!-CME` | `ED 1!-CME` |
+
+**Month Codes:** 1! = front month, 2! = second month, etc.
+
+**Government Bonds:**
+| Instrument | Symbol |
+|------------|--------|
+| US 10Y Treasury | `UST10Y` |
+| US 2Y Treasury | `UST2Y` |
+| US 5Y Treasury | `UST5Y` |
+| US 30Y Treasury | `UST30Y` |
+| German 10Y Bund | `DE10Y` |
+| UK 10Y Gilt | `UK10Y` |
+| Japan 10Y JGB | `JP10Y` |
+
+**Corporate Bonds (by identifier):**
+| Format | Example |
+|--------|---------|
+| CUSIP | `037833100` |
+| ISIN | `US037833100` |
+| SEDOL | `2046251` |
+
+**FX:**
+| Pair | Symbol |
+|------|--------|
+| EUR/USD | `EUR=` |
+| GBP/USD | `GBP=` |
+| USD/JPY | `JPY=` |
+| USD/CHF | `CHF=` |
+
+**Indices:**
+| Index | Symbol |
+|-------|--------|
+| ICE US Dollar Index | `DXY` |
+| VIX | `VIX` |
+
+---
+
+**5. Common Fields Reference**
+
+**Pricing Fields:**
+| Field | Description |
+|-------|-------------|
+| `Last` | Last traded price |
+| `Bid` | Bid price |
+| `Ask` | Ask price |
+| `Mid` | Mid price ((Bid+Ask)/2) |
+| `Open` | Opening price |
+| `High` | Session high |
+| `Low` | Session low |
+| `Close` | Previous close |
+| `Settlement` | Settlement price |
+| `Volume` | Trading volume |
+
+**Yield/Spread Fields:**
+| Field | Description |
+|-------|-------------|
+| `Yield` | Yield to maturity |
+| `YieldChange` | Daily yield change |
+| `Spread` | Credit spread |
+| `OAS` | Option-adjusted spread |
+| `ZSpread` | Z-spread |
+| `GSpread` | G-spread (vs govt) |
+
+**Bond Analytics:**
+| Field | Description |
+|-------|-------------|
+| `Duration` | Modified duration |
+| `EffDuration` | Effective duration |
+| `Convexity` | Convexity |
+| `DV01` | Dollar value of 01 |
+| `AccruedInterest` | Accrued interest |
+| `CleanPrice` | Clean price |
+| `DirtyPrice` | Dirty price (full) |
+
+**Reference Data:**
+| Field | Description |
+|-------|-------------|
+| `Coupon` | Coupon rate |
+| `Maturity` | Maturity date |
+| `IssueDate` | Issue date |
+| `Issuer` | Issuer name |
+| `Currency` | Currency code |
+| `Rating` | Credit rating |
+| `Sector` | Industry sector |
+| `Country` | Country of risk |
+
+**Futures-Specific:**
+| Field | Description |
+|-------|-------------|
+| `OpenInterest` | Open interest |
+| `ExpiryDate` | Contract expiry |
+| `ContractSize` | Contract size |
+| `TickSize` | Minimum price move |
+
+---
+
+**6. Example Formulas by Use Case**
+
+**Energy Futures:**
+=RTD("ice.xl",,"*Q","BRN 1!-ICE","Last")
+-> Brent crude front month.
+
+=RTD("ice.xl",,"*Q","BRN 1!-ICE","Bid")
+-> Brent crude bid price.
+
+=RTD("ice.xl",,"*Q","WTI 1!-ICE","Last")
+-> WTI crude front month.
+
+=RTD("ice.xl",,"*Q","GAS 1!-ICE","Settlement")
+-> ICE Gas Oil settlement.
+
+**Treasury Yields:**
+=RTD("ice.xl",,"*Q","UST10Y","Yield")
+-> 10Y Treasury yield.
+
+=RTD("ice.xl",,"*Q","UST2Y","Yield")
+-> 2Y Treasury yield.
+
+=RTD("ice.xl",,"*Q","UST10Y","Yield") - RTD("ice.xl",,"*Q","UST2Y","Yield")
+-> 10Y-2Y spread (yield curve).
+
+**Historical Prices:**
+=RTD("ice.xl",,"*H","BRN 1!-ICE","Last","D",DATE(2024,9,10))
+-> Brent on specific date.
+
+=RTD("ice.xl",,"*H","UST10Y","Yield","D",DATE(2024,1,1))
+-> 10Y yield on specific date.
+
+=RTD("ice.xl",,"*H","UST10Y","Yield","M",DATE(2024,6,1))
+-> 10Y yield monthly (June 2024).
+
+**Corporate Bonds:**
+=RTD("ice.xl",,"*Q","912828ZQ6","Last")
+-> Treasury bond by CUSIP.
+
+=RTD("ice.xl",,"*Q","US037833100","Yield")
+-> Corporate bond yield by ISIN.
+
+=RTD("ice.xl",,"*R","US037833100","Coupon")
+-> Bond coupon rate.
+
+=RTD("ice.xl",,"*R","US037833100","Maturity")
+-> Bond maturity date.
+
+**Bond Analytics:**
+=RTD("ice.xl",,"*A","US037833100","Duration")
+-> Bond modified duration.
+
+=RTD("ice.xl",,"*A","US037833100","OAS")
+-> Option-adjusted spread.
+
+**FX Rates:**
+=RTD("ice.xl",,"*Q","EUR=","Mid")
+-> EUR/USD mid rate.
+
+=RTD("ice.xl",,"*Q","DXY","Last")
+-> US Dollar Index.
+
+**Metals:**
+=RTD("ice.xl",,"*Q","GC 1!-CMX","Last")
+-> Gold front month.
+
+=RTD("ice.xl",,"*Q","SI 1!-CMX","Last")
+-> Silver front month.
+
+---
+
+**7. Session Limits and Notes**
+
+**Data Limits:**
+- Maximum 250 symbols per session
+- Real-time data requires active connection
+- Historical depth varies by instrument
+
+**Refresh Behavior:**
+- Real-time quotes update automatically
+- Use F9 or Ctrl+Alt+F5 to force refresh
+- Historical data does not auto-refresh
+
+**Time Zones:**
+- Prices typically in exchange local time
+- Treasury yields in US Eastern time
+- Check instrument specifications for details
+
+---
+
+**8. Error Handling**
+
+**Common Errors:**
+| Error | Cause | Solution |
+|-------|-------|----------|
+| #N/A | Invalid symbol | Check symbol format for instrument type |
+| #VALUE! | Wrong field name | Verify field name spelling |
+| #REF! | Connection issue | Check ICE XL connection status |
+| Stale data | Market closed | Normal for non-trading hours |
+| 0 or blank | No data | Symbol may not be active |
+
+**Debugging Tips:**
+1. Verify symbol format matches instrument type
+2. For futures, use correct exchange suffix (-ICE, -CME, -CMX)
+3. Check ICE XL connection in Excel add-in ribbon
+4. For bonds, try multiple identifier types (CUSIP, ISIN)
+5. Historical dates must be valid trading days
+6. Some fields only available for certain instrument types
+
+---
+
+**Final Checklist:**
+- What instrument type? (Futures, bonds, FX, indices)
+- What symbol format? (Check section 4 for conventions)
+- Is this real-time (*Q) or historical (*H)?
+- What field is needed? (Price, yield, analytics, reference)
+- For historical, what granularity and date?
+- Is the ICE XL add-in connected?
+- Is the symbol within session limits?
+
+---
+
+**Additional Resources:**
+- ICE Data Services: https://www.ice.com/market-data
+- ICE XL Documentation: https://download.dataservices.theice.com/products/iceexcel/help/
+- Symbol Guide: Available within ICE XL add-in
+- ICE Connect Portal: https://connect.theice.com/

package/skills/integrations/moodys-analytics.md

@@ -0,0 +1,313 @@
+**Moody's Analytics Excel Formula Guide**
+
+**Intro**
+You have full access to Moody's Analytics credit data through the Moody's Analytics Excel Add-in, but you should only pull Moody's data **when the user explicitly tells you to**. Moody's Analytics specializes in credit risk metrics including Expected Default Frequencies (EDF), credit ratings, loss given default estimates, and fair value spreads for public companies worldwide. You can retrieve any data point by writing MA formulas directly in Excel cells.
+
+**IMPORTANT:** Before completing a task involving Moody's Analytics, you must verify:
+1. Your MADS and MADR formulas do not return errors.
+2. All values should seem reasonable and make intuitive sense based on your general knowledge of credit risk.
+3. Use cell references for identifiers and metrics when possible as opposed to hardcoded values.
+4. Be aware that EDF values are expressed as percentages (e.g., 0.25 = 0.25% probability of default).
+5. Coverage includes ~40,000+ public companies globally with varying data depth.
+
+You should essentially gut check every value that shows up. If there are any errors or the values seem wrong, you likely wrote the formula syntax incorrectly or are using invalid metric codes. Please correct the formula until it outputs the proper value.
+
+**Note:** Moody's Analytics is a Pattern B integration. Standard credit metrics work directly, but some advanced features may require familiarity with Moody's platform for full utilization.
+
+---
+
+**Moody's Analytics Excel Functions Overview**
+
+Moody's Analytics provides these main Excel functions:
+
+| Function | Purpose | Use Case |
+|----------|---------|----------|
+| MADS | Moody's Analytics Data Static | Current/point-in-time data |
+| MADR | Moody's Analytics Data Range | Historical time series data |
+| MAINFO | Company information | Metadata and identifiers |
+| MALIST | Security lists | Portfolio screening |
+
+---
+
+**1. MADS - Static Data (Single Value)**
+
+Returns current or point-in-time credit metrics.
+
+**Syntax:** =MADS("Identifier", "Metric")
+
+**Parameters:**
+| Parameter | Description | Required |
+|-----------|-------------|----------|
+| Identifier | Ticker, CUSIP, or ISIN | Yes |
+| Metric | Credit metric name | Yes |
+
+**Examples:**
+=MADS("AAPL", "EDF1Y")
+-> Apple's 1-year probability of default.
+
+=MADS("MSFT", "ImpliedRating")
+-> Microsoft's EDF-implied credit rating.
+
+=MADS("037833100", "DistanceToDefault")
+-> Apple's distance to default (using CUSIP).
+
+**Using Cell References:**
+=MADS(A1, "EDF1Y")
+-> EDF for identifier in cell A1.
+
+=MADS("AAPL", B1)
+-> Metric specified in cell B1 for Apple.
+
+---
+
+**2. MADR - Range Data (Time Series)**
+
+Returns historical credit metrics over a date range.
+
+**Syntax:** =MADR("Identifier", "Metric", "StartDate", "EndDate")
+
+**Parameters:**
+| Parameter | Description | Required |
+|-----------|-------------|----------|
+| Identifier | Ticker, CUSIP, or ISIN | Yes |
+| Metric | Credit metric name | Yes |
+| StartDate | Start date (MM/DD/YYYY) | Yes |
+| EndDate | End date (MM/DD/YYYY) | Yes |
+
+**Examples:**
+=MADR("AAPL", "EDF1Y", "01/01/2024", "12/31/2024")
+-> Apple's daily EDF history for 2024.
+
+=MADR("JPM", "ImpliedRating", "01/01/2020", "12/31/2024")
+-> JPMorgan's implied rating history.
+
+=MADR("GE", "DistanceToDefault", "01/01/2023", "12/31/2023")
+-> GE's distance to default for 2023.
+
+---
+
+**3. Identifier Formats**
+
+Moody's Analytics accepts multiple identifier types:
+
+| Type | Format | Example |
+|------|--------|---------|
+| Ticker | Standard ticker | `AAPL`, `MSFT`, `JPM` |
+| CUSIP | 9-character CUSIP | `037833100` (Apple) |
+| ISIN | 12-character ISIN | `US0378331005` (Apple) |
+| Moody's ID | Internal ID | Provided by platform |
+
+**Notes:**
+- US tickers work without suffix
+- International companies may require ISIN or CUSIP
+- For subsidiaries, use specific entity identifier
+
+---
+
+**4. Credit Metrics Reference**
+
+**Expected Default Frequency (EDF):**
+| Metric | Description |
+|--------|-------------|
+| `EDF1Y` | 1-year probability of default (%) |
+| `EDF5Y` | 5-year cumulative probability of default (%) |
+| `EDF10Y` | 10-year cumulative probability of default (%) |
+| `EDFTerm` | EDF term structure (array) |
+
+**Distance to Default:**
+| Metric | Description |
+|--------|-------------|
+| `DistanceToDefault` | Standard deviations from default point |
+| `DD` | Alias for DistanceToDefault |
+| `DDVol` | Volatility of distance to default |
+
+**Credit Ratings:**
+| Metric | Description |
+|--------|-------------|
+| `ImpliedRating` | EDF-derived credit rating (Aaa, Aa1, etc.) |
+| `MIR` | Market Implied Rating |
+| `AgencyRating` | Actual agency rating (if available) |
+| `RatingNotch` | Numeric rating (1=Aaa, 21=C) |
+
+**Loss Given Default:**
+| Metric | Description |
+|--------|-------------|
+| `LGD` | Loss given default (%) |
+| `LGDSenior` | Senior unsecured LGD |
+| `LGDSubordinated` | Subordinated LGD |
+| `RecoveryRate` | Expected recovery rate (1 - LGD) |
+
+**Fair Value Spreads:**
+| Metric | Description |
+|--------|-------------|
+| `FVS` | Fair value spread (bps) |
+| `FVS1Y` | 1-year fair value spread |
+| `FVS5Y` | 5-year fair value spread |
+| `CreditSpread` | Current credit spread |
+
+**Market Data:**
+| Metric | Description |
+|--------|-------------|
+| `MarketCap` | Market capitalization |
+| `AssetValue` | Estimated asset value |
+| `AssetVol` | Asset volatility |
+| `EquityVol` | Equity volatility |
+| `DebtValue` | Total debt value |
+
+**Financial Ratios (Credit):**
+| Metric | Description |
+|--------|-------------|
+| `Leverage` | Debt/Assets ratio |
+| `InterestCoverage` | EBIT/Interest expense |
+| `DebtToEBITDA` | Debt/EBITDA ratio |
+| `CashToDebt` | Cash/Total debt |
+
+---
+
+**5. Rating Scale Reference**
+
+Moody's uses a 21-notch rating scale:
+
+| Rating | Notch | Description |
+|--------|-------|-------------|
+| Aaa | 1 | Prime, minimal credit risk |
+| Aa1 | 2 | High grade |
+| Aa2 | 3 | High grade |
+| Aa3 | 4 | High grade |
+| A1 | 5 | Upper medium grade |
+| A2 | 6 | Upper medium grade |
+| A3 | 7 | Upper medium grade |
+| Baa1 | 8 | Lower medium grade |
+| Baa2 | 9 | Lower medium grade |
+| Baa3 | 10 | Lower medium grade |
+| Ba1 | 11 | Non-investment grade |
+| Ba2 | 12 | Non-investment grade |
+| Ba3 | 13 | Non-investment grade |
+| B1 | 14 | Highly speculative |
+| B2 | 15 | Highly speculative |
+| B3 | 16 | Highly speculative |
+| Caa1 | 17 | Substantial risk |
+| Caa2 | 18 | Substantial risk |
+| Caa3 | 19 | Substantial risk |
+| Ca | 20 | Extremely speculative |
+| C | 21 | Default imminent |
+
+**Investment Grade:** Baa3 (notch 10) and above
+**High Yield:** Ba1 (notch 11) and below
+
+---
+
+**6. Example Formulas by Use Case**
+
+**Credit Risk Assessment:**
+=MADS("AAPL", "EDF1Y")
+-> Apple 1-year default probability.
+
+=MADS("TSLA", "DistanceToDefault")
+-> Tesla distance to default.
+
+=MADS("JPM", "ImpliedRating")
+-> JPMorgan implied credit rating.
+
+**Credit Comparison:**
+=MADS("AAPL", "EDF1Y") vs =MADS("MSFT", "EDF1Y")
+-> Compare Apple vs Microsoft default risk.
+
+**Portfolio Screening:**
+=MADS(A2, "EDF1Y") for each ticker in column A
+-> Drag down for portfolio EDF screening.
+
+**Historical Credit Trends:**
+=MADR("GE", "EDF1Y", "01/01/2015", "12/31/2024")
+-> GE's 10-year EDF history.
+
+=MADR("F", "ImpliedRating", "01/01/2020", "12/31/2024")
+-> Ford's rating history through COVID.
+
+**Loss Analysis:**
+=MADS("HYG", "LGD")
+-> High yield bond LGD estimate.
+
+=MADS("XYZ", "RecoveryRate")
+-> Expected recovery in default scenario.
+
+**Spread Analysis:**
+=MADS("IBM", "FVS5Y")
+-> IBM 5-year fair value spread.
+
+=MADS("T", "CreditSpread")
+-> AT&T current credit spread.
+
+**Leverage Metrics:**
+=MADS("NFLX", "Leverage")
+-> Netflix debt/assets ratio.
+
+=MADS("BA", "DebtToEBITDA")
+-> Boeing debt/EBITDA.
+
+**Volatility Analysis:**
+=MADS("TSLA", "EquityVol")
+-> Tesla equity volatility.
+
+=MADS("NVDA", "AssetVol")
+-> NVIDIA asset volatility.
+
+---
+
+**7. EDF Interpretation Guide**
+
+**EDF Ranges and Risk Levels:**
+| EDF Range | Risk Level | Approximate Rating |
+|-----------|------------|-------------------|
+| 0.01% - 0.05% | Very Low | Aaa - Aa |
+| 0.05% - 0.20% | Low | A |
+| 0.20% - 0.75% | Moderate | Baa |
+| 0.75% - 2.00% | Elevated | Ba |
+| 2.00% - 5.00% | High | B |
+| 5.00% - 15.00% | Very High | Caa |
+| 15.00%+ | Distressed | Ca - C |
+
+**Key Insights:**
+- EDF is forward-looking (market-based)
+- Ratings are often lagging indicators
+- EDF can signal deterioration before rating changes
+- Compare EDF to peers for relative credit risk
+
+---
+
+**8. Error Handling**
+
+**Common Errors:**
+| Error | Cause | Solution |
+|-------|-------|----------|
+| #VALUE! | Invalid identifier | Verify ticker, CUSIP, or ISIN |
+| #N/A | No coverage | Company may not be in database |
+| #REF! | Invalid metric | Check metric name spelling |
+| 0 or blank | No data | Metric may not be available for entity |
+| Old date | Stale data | Check company is still public/active |
+
+**Debugging Tips:**
+1. Verify company is publicly traded
+2. Try alternate identifier (CUSIP vs ticker)
+3. Check metric name is exact match
+4. For historical data, verify date format (MM/DD/YYYY)
+5. Some metrics only available for certain entity types
+
+---
+
+**Final Checklist:**
+- Is the company publicly traded and covered?
+- What identifier format? (Ticker, CUSIP, ISIN)
+- What credit metric? (EDF, rating, LGD, spread)
+- Is this current data (MADS) or historical (MADR)?
+- For time series, are dates in MM/DD/YYYY format?
+- Is the Moody's Analytics add-in connected?
+- Do you have appropriate subscription access?
+
+---
+
+**Additional Resources:**
+- Moody's Analytics Platform: https://www.moodysanalytics.com/
+- CreditEdge Documentation: https://www.moodysanalytics.com/product-list/creditedge
+- EDF Methodology: https://www.moodysanalytics.com/product-list/edf-expected-default-frequency
+- Excel Add-in Support: Contact Moody's Analytics support