intent-solutions-io/nixtla-anomaly-detector
000-docs/000a-planned-skills/core-forecasting/nixtla-anomaly-detector/SKILL.md
Detects anomalies in time series data using TimeGPT. Identifies outliers, level shifts, and trend breaks without model training. Use when identifying anomalies, outliers, or unusual patterns in time series. Trigger with "detect anomalies", "find outliers", "anomaly detection".
$ install --global
skillsauthnpx skillsauth add intent-solutions-io/plugins-nixtla nixtla-anomaly-detectorInstall 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:12 PM21.4s2 files scanned
SKILL.md
- name:
- nixtla-anomaly-detector
- description:
- |
- allowed-tools:
- Read,Write,Bash,Glob,Grep
- version:
- 1.0.0
Nixtla Anomaly Detector
Automatically detect and flag anomalies in time series data using TimeGPT.
Overview
This skill leverages TimeGPT's anomaly detection capabilities to identify outliers, level shifts, and trend breaks in time series data without requiring model training. It accepts CSV data, runs anomaly detection via the Nixtla API, and produces a detailed report with visualizations.
Prerequisites
Required:
- Python 3.8+
nixtla,pandas,matplotlibpackages
Environment Variables:
NIXTLA_TIMEGPT_API_KEY: Your TimeGPT API key
Installation:
pip install nixtla pandas matplotlib
Instructions
Step 1: Prepare Input Data
Ensure your CSV file has the required Nixtla schema columns:
| Column | Type | Description |
|--------|------|-------------|
| unique_id | string | Series identifier |
| ds | datetime | Timestamp |
| y | numeric | Value to analyze |
Step 2: Set API Key
export NIXTLA_TIMEGPT_API_KEY=your_api_key_here
Step 3: Run Anomaly Detection
Execute the detection script:
python {baseDir}/scripts/detect_anomalies.py --input your_data.csv
Available options:
--input,-i: Input CSV file (required)--output-csv,-o: Anomaly output CSV (default:anomalies.csv)--output-plot,-p: Visualization plot (default:anomalies_plot.png)--output-summary,-s: Summary text file (default:anomaly_summary.txt)
Step 4: Review Results
The script generates three output files:
- anomalies.csv - Detailed anomaly records
- anomalies_plot.png - Visual highlighting of anomalies
- anomaly_summary.txt - Summary counts by type
Output
- anomalies.csv: Contains detected anomalies with timestamps, values, and anomaly types (outlier, level_shift, trend_break)
- anomalies_plot.png: Time series visualization with anomalies highlighted in red
- anomaly_summary.txt: Human-readable summary of detection results
Error Handling
-
Error:
NIXTLA_TIMEGPT_API_KEY not setSolution: Runexport NIXTLA_TIMEGPT_API_KEY=your_key -
Error:
CSV file missing required columnsSolution: Ensure CSV hasunique_id,ds, andycolumns -
Error:
No anomalies detectedSolution: This is valid output - data may have no anomalies -
Error:
Connection error to TimeGPT APISolution: Check network connection and API key validity
Examples
Example 1: Detect outliers in website traffic
Input (traffic.csv):
unique_id,ds,y
website_1,2024-01-01,1000
website_1,2024-01-02,1050
website_1,2024-01-03,300
website_1,2024-01-04,980
Command:
python {baseDir}/scripts/detect_anomalies.py --input traffic.csv
Output (anomalies.csv):
unique_id,ds,y,anomaly_type
website_1,2024-01-03,300,outlier
Example 2: Identify trend break in sales data
Input (sales.csv):
unique_id,ds,y
store_1,2023-12-28,50
store_1,2023-12-29,55
store_1,2023-12-30,60
store_1,2023-12-31,150
store_1,2024-01-01,145
Command:
python {baseDir}/scripts/detect_anomalies.py -i sales.csv -o sales_anomalies.csv
Output: Detects trend break at 2023-12-31
Resources
- Script:
{baseDir}/scripts/detect_anomalies.py - Nixtla Docs: https://nixtla.github.io/
- TimeGPT API: https://docs.nixtla.io/
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