Skip to content
Back to search

skforecast

MarketplaceWorks with Claude CodeGitHub

Agent Skills for time series forecasting with skforecast.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 12 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/skforecast/skforecast with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/skforecast/skforecast'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/skforecast--skforecast/badge.svg)](/listings/skforecast--skforecast)

HTML

<a href="/listings/skforecast--skforecast"><img src="/api/listings/skforecast--skforecast/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

pip install skforecast

Also available on conda-forge (`conda install -c conda-forge skforecast`). Optional dependencies for statistical models, plotting and deep learning are listed in the [installation guide](https://skforecast.org/latest/quick-start/how-to-install.html).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 26 lines
  1. {
  2. "name": "skforecast",
  3. "owner": {
  4. "name": "skforecast",
  5. "url": "https://github.com/skforecast"
  6. },
  7. "description": "Agent Skills for time series forecasting with skforecast.",
  8. "plugins": [
  9. {
  10. "name": "skforecast",
  11. "source": "./skills",
  12. "strict": false,
  13. "skills": ".",
  14. "description": "Workflow skills for time series forecasting with skforecast: choosing a forecaster, single and multiple series, foundation models, backtesting, hyperparameter search, prediction intervals and troubleshooting.",
  15. "version": "0.27.0",
  16. "author": {
  17. "name": "skforecast",
  18. "url": "https://skforecast.org"
  19. },
  20. "homepage": "https://skforecast.org/latest/quick-start/ai-assisted-forecasting.html",
  21. "repository": "https://github.com/skforecast/skforecast",
  22. "license": "BSD-3-Clause",
  23. "keywords": ["forecasting", "time-series", "machine-learning", "scikit-learn", "python"]
  24. }
  25. ]
  26. }
README.md · README · 231 lines
  1. <h1 align="left">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="https://github.com/skforecast/skforecast/blob/main/images/banner-landing-page-skforecast-dark.png?raw=true">
  4. <img src="https://github.com/skforecast/skforecast/blob/main/images/banner-landing-page-skforecast.png?raw=true" alt="skforecast">
  5. </picture>
  6. </h1>
  7. | | |
  8. | --- | --- |
  9. | Package | ![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue) [![PyPI](https://img.shields.io/pypi/v/skforecast)](https://pypi.org/project/skforecast/) [![Conda](https://img.shields.io/conda/v/conda-forge/skforecast?logo=Anaconda)](https://anaconda.org/conda-forge/skforecast) [![Total downloads](https://static.pepy.tech/personalized-badge/skforecast?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=total%20downloads)](https://pepy.tech/projects/skforecast) [![PyPI monthly downloads](https://img.shields.io/pypi/dm/skforecast?color=blue&label=pypi%20downloads)](https://pypistats.org/packages/skforecast) |
  10. | Meta | [![License](https://img.shields.io/github/license/skforecast/skforecast)](https://github.com/skforecast/skforecast/blob/main/LICENSE) [![DOI](https://zenodo.org/badge/337705968.svg)](https://zenodo.org/doi/10.5281/zenodo.8382787) [![NumFOCUS Affiliated](https://img.shields.io/badge/NumFOCUS-Affiliated%20Project-orange.svg?style=flat&colorA=E1523D&colorB=007D8A)](https://numfocus.org/sponsored-projects/affiliated-projects) [![GC.OS Affiliated](https://img.shields.io/badge/GC.OS-Affiliated%20Project-orange.svg?style=flat&colorA=0eac92&colorB=2077b4)](https://gc-os-ai.github.io/) |
  11. | Testing | [![Build status](https://github.com/skforecast/skforecast/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/skforecast/skforecast/actions/workflows/unit-tests.yml) [![codecov](https://codecov.io/gh/skforecast/skforecast/branch/main/graph/badge.svg)](https://codecov.io/gh/skforecast/skforecast) |
  12. | Community | [![!discord](https://img.shields.io/static/v1?logo=discord&label=discord&message=chat&color=lightgreen)](https://discord.gg/3V52qpNkuj) [![!linkedin](https://img.shields.io/static/v1?logo=linkedin&label=LinkedIn&message=news&color=lightblue)](https://www.linkedin.com/company/skforecast/) [![Forecasting Python](https://img.shields.io/static/v1?logo=readme&logoColor=white&label=Blog&labelColor=%23333333&message=Forecasting%20Python&color=%23ffab40)](https://cienciadedatos.net/en/forecasting-python) |
  13. ## About skforecast
  14. **Time series forecasting, from prototype to production.** Skforecast is a Python library for time series forecasting using scikit-learn compatible models, statistical methods, and foundation models. It works with any estimator compatible with the scikit-learn API, such as LightGBM, XGBoost, CatBoost or Keras.
  15. <p align="center">
  16. <img src="https://github.com/skforecast/skforecast/blob/main/images/skforecast-backtesting-comparison.png?raw=true" alt="Backtesting of LightGBM, Chronos-2 and ARIMA with skforecast on daily electricity demand" width="100%">
  17. </p>
  18. <sub>Backtesting of LightGBM, Chronos-2 and ARIMA on daily electricity demand, with temperature and holidays as exogenous variables. Real skforecast outputs, from the animation on [skforecast.org](https://skforecast.org).</sub>
  19. ## Installation
  20. ```bash
  21. pip install skforecast
  22. ```
  23. Also available on conda-forge (`conda install -c conda-forge skforecast`). Optional dependencies for statistical models, plotting and deep learning are listed in the [installation guide](https://skforecast.org/latest/quick-start/how-to-install.html).
  24. ## Quick example
  25. ```python
  26. from lightgbm import LGBMRegressor
  27. from skforecast.recursive import ForecasterRecursive
  28. from skforecast.datasets import load_demo_dataset
  29. # Download demo dataset
  30. y = load_demo_dataset()
  31. # Create and fit the forecaster using the last 15 observations as features
  32. forecaster = ForecasterRecursive(
  33. estimator = LGBMRegressor(random_state=123, verbose=-1),
  34. lags = 15
  35. )
  36. forecaster.fit(y=y)
  37. # Predict the next 12 months
  38. predictions = forecaster.predict(steps=12)
  39. predictions.head()
  40. # 2008-07-01 0.976355
  41. # 2008-08-01 1.038296
  42. # 2008-09-01 1.108676
  43. # 2008-10-01 1.163778
  44. # 2008-11-01 1.169646
  45. # Freq: MS, Name: pred, dtype: float64
  46. ```
  47. <details>
  48. <summary><b>Same workflow with a foundation model (Chronos-2, zero-shot)</b></summary>
  49. ```python
  50. # pip install chronos-forecasting
  51. from skforecast.foundation import FoundationModel, ForecasterFoundation
  52. from skforecast.datasets import load_demo_dataset
  53. # Download demo dataset
  54. y = load_demo_dataset()
  55. # Create the forecaster: fit only stores the context, there is no training
  56. forecaster = ForecasterFoundation(
  57. estimator = FoundationModel("autogluon/chronos-2-small")
  58. )
  59. forecaster.fit(series=y)
  60. # Predict the next 12 months
  61. predictions = forecaster.predict(steps=12)
  62. predictions.head()
  63. # level pred
  64. # 2008-07-01 y 1.002536
  65. # 2008-08-01 y 1.030961
  66. # 2008-09-01 y 1.083664
  67. # 2008-10-01 y 1.184066
  68. # 2008-11-01 y 1.170530
  69. ```
  70. </details>
  71. ## Features
  72. ### One API for every kind of model
  73. - **[Machine learning](https://skforecast.org/latest/user_guides/autoregressive-forecaster.html)**: any scikit-learn compatible regressor, such as LightGBM, XGBoost or CatBoost, with lags, rolling and calendar features. Recursive or direct strategies, for one series or thousands.
  74. - **[Foundation models](https://skforecast.org/latest/user_guides/foundation-forecasting-models.html)**: zero-shot forecasting with pre-trained models such as Chronos-2, TimesFM, Moirai-2 or TabPFN-TS, without training them.
  75. - **[Statistical models](https://skforecast.org/latest/user_guides/forecasting-statistical-models.html)**: ARIMA, SARIMAX, ETS and ARAR, with automatic model selection.
  76. - **[Deep learning](https://skforecast.org/latest/user_guides/forecasting-with-deep-learning-rnn-lstm.html)**: recurrent neural networks (RNN, LSTM) built with Keras.
  77. Train, predict, tune and backtest the same way, whatever the model: see them [compared on three datasets](https://skforecast.org/latest/user_guides/comparing-forecasting-models.html).
  78. ### Built for production
  79. - **[Backtesting](https://skforecast.org/latest/user_guides/backtesting.html)** that reproduces how the model will be used: refits, gaps, fold strides, fixed or expanding windows.
  80. - **[Probabilistic forecasting](https://skforecast.org/latest/user_guides/probabilistic-forecasting-overview.html)** with bootstrapping, conformal prediction and quantiles, evaluated with CRPS and coverage.
  81. - **[Hyperparameter tuning](https://skforecast.org/latest/user_guides/hyperparameter-tuning-and-lags-selection.html)** with grid, random and Bayesian search (Optuna), including the number of lags.
  82. - **[Feature engineering](https://skforecast.org/latest/user_guides/window-features-and-custom-features.html)**: rolling statistics, calendar features, exogenous and categorical variables, and differentiation.
  83. - **[Global models](https://skforecast.org/latest/user_guides/global-forecasting-overview.html)** that forecast many series with one model, even with different lengths, exogenous variables and missing values.
  84. - **[Explainability](https://skforecast.org/latest/user_guides/explainability.html) and [monitoring](https://skforecast.org/latest/user_guides/drift-detection.html)**: feature importances and SHAP values, feature selection and drift detection.
  85. ## Forecasters
  86. All forecasters share the same API for training, prediction, backtesting and probabilistic forecasting.
  87. | Forecaster | Estimator | Series | Strategy | Exog | Window features | Differentiation |
  88. |:--|:--|:--:|:--:|:--:|:--:|:--:|
  89. |[ForecasterRecursive]| scikit-learn regressor | single | recursive | ✓ | ✓ | ✓ |
  90. |[ForecasterDirect]| scikit-learn regressor | single | direct | ✓ | ✓ | ✓ |
  91. |[ForecasterRecursiveMultiSeries]| scikit-learn regressor | multiple | recursive | ✓ | ✓ | ✓ |
  92. |[ForecasterDirectMultiVariate]| scikit-learn regressor | multiple | direct | ✓ | ✓ | ✓ |
  93. |[ForecasterFoundation]| pre-trained, zero-shot | single or multiple | multi-output | ✓ | | |
  94. |[ForecasterStats]| Arima, Sarimax, Ets, Arar | single | recursive | ✓ | | |
  95. |[ForecasterRnn]| Keras model (RNN/LSTM) | single or multiple | multi-output | ✓ | | |
  96. |[ForecasterRecursiveClassifier]| scikit-learn classifier | single | recursive | ✓ | ✓ | |
  97. |[ForecasterEquivalentDate]| Rule-based (baseline) | single | recursive | | | |
  98. [ForecasterRecursive]: https://skforecast.org/latest/user_guides/autoregressive-forecaster.html
  99. [ForecasterDirect]: https://skforecast.org/latest/user_guides/direct-multi-step-forecasting.html
  100. [ForecasterRecursiveMultiSeries]: https://skforecast.org/latest/user_guides/independent-multi-time-series-forecasting.html
  101. [ForecasterDirectMultiVariate]: https://skforecast.org/latest/user_guides/dependent-multi-series-multivariate-forecasting.html
  102. [ForecasterFoundation]: https://skforecast.org/latest/user_guides/foundation-forecasting-models.html
  103. [ForecasterStats]: https://skforecast.org/latest/user_guides/forecasting-statistical-models.html
  104. [ForecasterRnn]: https://skforecast.org/latest/user_guides/forecasting-with-deep-learning-rnn-lstm.html
  105. [ForecasterRecursiveClassifier]: https://skforecast.org/latest/user_guides/autoregressive-classification-forecasting.html
  106. [ForecasterEquivalentDate]: https://skforecast.org/latest/user_guides/forecasting-baseline.html
  107. ## Documentation
  108. The full documentation is available at **https://skforecast.org**.
  109. | Documentation | |
  110. |:----------------------------------------|:----|
  111. | :book: [Introduction to forecasting] | Forecasting concepts and how to choose a forecaster |
  112. | :rocket: [Quick start] | Install skforecast and train your first model |
  113. | :hammer_and_wrench: [User guides] | Detailed guides on every feature |
  114. | :mortar_board: [Examples and tutorials] | Practical examples, in English, Spanish and Chinese |
  115. | :question: [FAQ and tips] | Answers and tips about forecasting |
  116. | :books: [API Reference] | Reference for all functions and classes |
  117. | :memo: [Releases] | What changed in each version |
  118. [Introduction to forecasting]: https://skforecast.org/latest/introduction-forecasting/introduction-forecasting.html
  119. [Quick start]: https://skforecast.org/latest/quick-start/quick-start-skforecast.html
  120. [User guides]: https://skforecast.org/latest/user_guides/table-of-contents.html
  121. [Examples and tutorials]: https://skforecast.org/latest/examples/examples_english.html
  122. [FAQ and tips]: https://skforecast.org/latest/faq/table-of-contents.html
  123. [API Reference]: https://skforecast.org/latest/api/forecasterrecursive.html
  124. [Releases]: https://skforecast.org/latest/releases/releases.html
  125. ## AI and tools
  126. [![Skforecast AI](https://img.shields.io/badge/Skforecast%20AI-Documentation-f79939?logo=readthedocs)](https://ai.skforecast.org/) [![PyPI](https://img.shields.io/pypi/v/skforecast-ai)](https://pypi.org/project/skforecast-ai/) [![GitHub](https://img.shields.io/badge/GitHub-skforecast--ai-181717?logo=github)](https://github.com/skforecast/skforecast-ai) [![MCP server](https://img.shields.io/badge/MCP-server-blue?logo=modelcontextprotocol&logoColor=white)](https://ai.skforecast.org/stable/user-guides/mcp-server.html) [![Skforecast Studio](https://img.shields.io/badge/Skforecast%20Studio-Launch%20App-f79939?logo=rocket)](https://studio.skforecast.org/) [![llms.txt](https://img.shields.io/badge/llms.txt-available-blue)](https://skforecast.org/latest/llms-full.txt) [![Claude Code plugin](https://img.shields.io/badge/Claude_Code-plugin-d97757)](https://skforecast.org/latest/quick-start/ai-assisted-forecasting.html#install-skforecast-context-in-your-agent)
  127. - **AI-assisted coding**: skforecast publishes machine-readable context files so AI assistants (ChatGPT, Claude, Copilot and others) generate accurate code. Paste `https://skforecast.org/latest/llms-full.txt` into any LLM, or install the workflow skills in your coding agent: as a Claude Code plugin (`/plugin marketplace add skforecast/skforecast`) or with `npx skills add skforecast/skforecast/skills` for Cursor, Copilot, Codex and others. Learn more in [AI-assisted forecasting](https://skforecast.org/latest/quick-start/ai-assisted-forecasting.html).
  128. - **[skforecast-ai](https://ai.skforecast.org/)**: an AI forecasting assistant that pairs a deterministic engine, powered by skforecast, with an LLM reasoning layer. Install it with `pip install skforecast-ai`. It also brings skforecast to coding agents such as Claude Code or VS Code through an [MCP server](https://ai.skforecast.org/stable/user-guides/mcp-server.html): ask in plain language and get the forecast, its backtesting metrics and the skforecast script that produced them.
  129. - **[Skforecast Studio](https://studio.skforecast.org/)**: a no-code application to build forecasting models visually, which generates production-ready Python code.
  130. ## Contributing
  131. Bug reports, feature requests, code, tests, documentation and examples are all welcome. Open an issue on [GitHub Issues](https://github.com/skforecast/skforecast/issues) or read the [Contribution Guide](https://github.com/skforecast/skforecast/blob/main/CONTRIBUTING.md) to get started.
  132. skforecast is created and maintained by [Joaquín Amat Rodrigo](https://github.com/JoaquinAmatRodrigo) and [Javier Escobar Ortiz](https://github.com/JavierEscobarOrtiz), together with everyone who has contributed to it ([about the project](https://skforecast.org/latest/more/about-skforecast.html)).
  133. <a href="https://github.com/skforecast/skforecast/graphs/contributors">
  134. <img src="https://contrib.rocks/image?repo=skforecast/skforecast" alt="skforecast contributors">
  135. </a>
  136. ## Citation
  137. If you use skforecast in a scientific publication, please cite the version you used: each version has its own DOI and ready-made citations on [Zenodo](https://doi.org/10.5281/zenodo.8382787). To cite skforecast in general, use the DOI that always resolves to the latest release.
  138. **APA**:
  139. ```
  140. Amat Rodrigo, J., & Escobar Ortiz, J. skforecast [Computer software]. https://doi.org/10.5281/zenodo.8382787
  141. ```
  142. **BibTeX**:
  143. ```bibtex
  144. @software{skforecast,
  145. author = {Amat Rodrigo, Joaquin and Escobar Ortiz, Javier},
  146. title = {skforecast},
  147. license = {BSD-3-Clause},
  148. url = {https://skforecast.org/},
  149. doi = {10.5281/zenodo.8382787}
  150. }
  151. ```
  152. The citation metadata is also in [CITATION.cff](https://github.com/skforecast/skforecast/blob/main/CITATION.cff) (GitHub's "Cite this repository" button). skforecast is used in 70+ scientific publications: [see them on Google Scholar](https://scholar.google.com/scholar?q=%22skforecast%22).
  153. ## Sponsorship and funding
  154. skforecast is free, open-source software supported by the [Sovereign Tech Fund](https://www.sovereign.tech/tech/skforecast) and by the organizations that sponsor it. If your company relies on skforecast, see **[Sponsorship and funding](https://skforecast.org/latest/more/funding.html)** for sponsorship tiers, support agreements, feature sponsorship and training.
  155. Individuals can support the project through Open Collective, Buy Me a Coffee, GitHub Sponsors ([Joaquín Amat Rodrigo](https://github.com/sponsors/JoaquinAmatRodrigo), [Javier Escobar Ortiz](https://github.com/sponsors/JavierEscobarOrtiz)) or [PayPal](https://www.paypal.com/donate/?hosted_button_id=D2JZSWRLTZDL6).
  156. <p>
  157. <a href="https://opencollective.com/skforecast"><img src="https://github.com/skforecast/skforecast/blob/main/images/opencollective_button.png?raw=true" alt="Support skforecast on Open Collective" height="40"></a>&nbsp;
  158. <a href="https://www.buymeacoffee.com/skforecast"><img src="https://github.com/skforecast/skforecast/blob/main/images/buymeacoffee_button.png?raw=true" alt="Buy Me a Coffee" height="40"></a>&nbsp;
  159. <a href="https://skforecast.org/latest/more/funding.html"><img src="https://github.com/skforecast/skforecast/blob/main/images/github_sponsor_button.png?raw=true" alt="Sponsor skforecast on GitHub" height="40"></a>
  160. </p>
  161. ## License
  162. **Skforecast software**: [BSD-3-Clause License](https://github.com/skforecast/skforecast/blob/main/LICENSE)
  163. **Skforecast documentation**: [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)
  164. **Trademark**: The trademark skforecast is registered with the European Union Intellectual Property Office (EUIPO) under the application number 019109684. Unauthorized use of this trademark, its logo, or any associated visual identity elements is strictly prohibited without the express consent of the owner.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.