intent-solutions-io/nixtla-exogenous-integrator
003-skills/.claude/skills/nixtla-exogenous-integrator/SKILL.md
Incorporates external variables (holidays, weather, events) into TimeGPT forecasts to improve accuracy. Use when forecasts require external data, holidays impact sales, or weather affects demand. Trigger with 'include holidays', 'add weather data', 'integrate events'.
$ install --global
skillsauthnpx skillsauth add intent-solutions-io/plugins-nixtla nixtla-exogenous-integratorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 5, 2026, 11:13 PM9.3s4 files scanned
SKILL.md
- name:
- nixtla-exogenous-integrator
- description:
- Incorporates external variables (holidays, weather, events) into TimeGPT forecasts to improve accuracy. Use when forecasts require external data, holidays impact sales, or weather affects demand. Trigger with 'include holidays', 'add weather data', 'integrate events'.
- version:
- 1.0.0
- author:
- Jeremy Longshore <[email protected]>
- license:
- MIT
- allowed-tools:
- Read,Write,Bash(python:*),Glob,Grep
Nixtla Exogenous Integrator
Augments TimeGPT forecasts with exogenous variables for increased accuracy.
Purpose
Enhances time series predictions by integrating external data sources like holidays, weather, and events.
Overview
This skill enriches TimeGPT forecasts by considering external factors influencing time series data. It reads exogenous data from CSV files, aligns it with the historical data, and passes both to the TimeGPT API. This integration improves forecast accuracy, especially when events or external conditions affect the time series. The skill outputs an augmented forecast incorporating the impact of these exogenous variables.
Prerequisites
Tools: Read, Write, Bash, Glob, Grep
Environment: NIXTLA_TIMEGPT_API_KEY
Packages:
pip install nixtla pandas matplotlib
Instructions
Step 1: Prepare data
Read historical time series CSV and exogenous variables CSVs. Ensure they have a common date ('ds') column.
Script: {baseDir}/scripts/load_data.py
Usage:
python {baseDir}/scripts/load_data.py data.csv holidays.csv
The loader expects:
- Historical data:
unique_id,ds,ycolumns - Exogenous data:
dscolumn plus feature columns
Step 2: Align data
Merge historical and exogenous dataframes based on the 'ds' column using the alignment script.
Script: {baseDir}/scripts/align_data.py
The script validates that both datasets share a 'ds' column and checks for column name conflicts. It performs a left join to preserve all historical timestamps.
Step 3: Generate forecast
Run the integration script with your data files and forecast parameters.
Script: {baseDir}/scripts/integrate_exogenous.py
Usage:
python {baseDir}/scripts/integrate_exogenous.py \
--input data.csv \
--exogenous holidays.csv \
--horizon 14 \
--freq D
Parameters:
--input: Historical time series CSV file--exogenous: Exogenous variables CSV file (optional)--horizon: Number of periods to forecast--freq: Time series frequency (D=daily, H=hourly, M=monthly, etc.)
The script automatically:
- Loads and validates both datasets
- Aligns data on the 'ds' column
- Prepares exogenous variables (converts to numeric, fills missing values)
- Calls TimeGPT API with exogenous features
- Saves forecast and generates visualization
Output
- forecast_exogenous.csv: Predictions with integrated exogenous variables.
- forecast_plot.png: Visualization of the forecast with historical data and exogenous variables.
Error Handling
-
Error:
Exogenous data missing 'ds' columnSolution: Rename the date column in the exogenous data to 'ds'. -
Error:
Mismatch in date range between historical and exogenous dataSolution: Ensure the exogenous data covers the entire historical and forecast period. -
Error:
Exogenous variables have NaN values in the forecast horizonSolution: Provide future values for exogenous variables for the entire forecast horizon. -
Error:
TimeGPT API rejected exogenous variablesSolution: Ensure exogenous variables are numeric and compatible with the TimeGPT API schema. -
Error:
NIXTLA_TIMEGPT_API_KEY environment variable not setSolution: Set your TimeGPT API key as an environment variable before running the script.
Examples
Example 1: Holiday impact on sales
Input (data.csv):
unique_id,ds,y
store_1,2024-01-01,100
store_1,2024-01-02,120
store_1,2024-01-03,115
Input (holidays.csv):
ds,holiday
2024-01-01,1
2024-01-02,0
2024-01-03,0
2024-01-04,0
Command:
python {baseDir}/scripts/integrate_exogenous.py \
--input data.csv \
--exogenous holidays.csv \
--horizon 7 \
--freq D
Output (forecast_exogenous.csv):
unique_id,ds,TimeGPT,TimeGPT-lo-90,TimeGPT-hi-90
store_1,2024-01-04,125,110,140
store_1,2024-01-05,128,113,143
Example 2: Weather affecting demand
Input (data.csv):
unique_id,ds,y
grid_1,2024-01-01 00:00,5000
grid_1,2024-01-01 01:00,5100
Input (weather.csv):
ds,temperature
2024-01-01 00:00,10
2024-01-01 01:00,8
2024-01-01 02:00,7
Command:
python {baseDir}/scripts/integrate_exogenous.py \
--input data.csv \
--exogenous weather.csv \
--horizon 24 \
--freq H
Output: Hourly forecast incorporating temperature trends.
Resources
- TimeGPT exogenous variables guide: https://docs.nixtla.io/
- Holiday calendar generation: https://github.com/dr-prodigy/python-holidays
- Weather API integration: https://openweathermap.org/api
- Scripts:
{baseDir}/scripts/directory contains all executable code
Related Skills
intent-solutions-io/managing-test-environments
testing
VerifiedTrustedCommunity
This skill enables Claude to manage isolated test environments using Docker Compose, Testcontainers, and environment variables. It is used to create consistent, reproducible testing environments for software projects. Claude should use this skill when the user needs to set up a test environment with specific configurations, manage Docker Compose files for test infrastructure, set up programmatic container management with Testcontainers, manage environment variables for tests, or ensure cleanup after tests. Trigger terms include "test environment", "docker compose", "testcontainers", "environment variables", "isolated environment", "env-setup", and "test setup".
6SKILL.mdUpdated Jun 5, 2026
intent-solutions-io/generating-test-doubles
tools
VerifiedTrustedCommunity
This skill uses the test-doubles-generator plugin to automatically create mocks, stubs, spies, and fakes for unit testing. It analyzes dependencies in the code and generates appropriate test doubles based on the chosen testing framework, such as Jest, Sinon, or others. Use this skill when you need to generate test doubles, mocks, stubs, spies, or fakes to isolate units of code during testing. Trigger this skill by requesting test double generation or using the `/gen-doubles` or `/gd` command.
6SKILL.mdUpdated Jun 5, 2026
intent-solutions-io/generating-test-data
tools
VerifiedTrustedCommunity
This skill enables Claude to generate realistic test data for software development. It uses the test-data-generator plugin to create users, products, orders, and custom schemas for comprehensive testing. Use this skill when you need to populate databases, simulate user behavior, or create fixtures for automated tests. Trigger phrases include "generate test data", "create fake users", "populate database", "generate product data", "create test orders", or "generate data based on schema". This skill is especially useful for populating testing environments or creating sample data for demonstrations.
6SKILL.mdUpdated Jun 5, 2026
intent-solutions-io/analyzing-test-coverage
development
VerifiedTrustedCommunity
This skill analyzes code coverage metrics to identify untested code and generate comprehensive coverage reports. It is triggered when the user requests analysis of code coverage, identification of coverage gaps, or generation of coverage reports. The skill is best used to improve code quality by ensuring adequate test coverage and identifying areas for improvement. Use trigger terms like "analyze coverage", "code coverage report", "untested code", or the shortcut "cov".
6SKILL.mdUpdated Jun 5, 2026