timesfm-forecasting — Claude Code skill: forecasts and setup
This skill runs zero-shot time-series forecasts with Google TimesFM. Use it for regular-grid CSV data, quantile outputs, XReg covariates, and held-out evaluation.
npx skills add K-Dense-AI/scientific-agent-skills --skill timesfm-forecasting -a claude-codeWhat timesfm-forecasting does
The skill prepares temporal data, checks its regular grid, and runs forecasts with TimesFM. Its default local workflow uses the TimesFM 2.5 checkpoint and can produce quantile forecasts, use XReg covariates, and evaluate predictions on held-out data. The CSV helper is scripts/forecast_csv.py; it sorts dates and checks duplicate entries, gaps, and missing values.
Before loading weights, the workflow runs scripts/check_system.py and considers RAM, cache space, and batch size. It requires Python 3.10+, timesfm 3.0.2 with PyTorch, NumPy, and pandas. XReg adds JAX and scikit-learn. Without Python 3.10+, the installation from the skill instructions will not run. TimesFM 3.0 has a separate API, and its downloaded weights are restricted to non-commercial, non-production use.
What it helps with
- prepare a CSV on a regular time grid
- forecast sales from historical observations
- generate quantile prediction intervals
- evaluate forecasts on held-out data
- add XReg covariates to a forecast
Example prompts for the agent
- Forecast sales from
monthly_sales.csvforhorizon12 and write the result toforecasts.csv. - Validate this time series, find internal gaps, and prepare it for TimesFM.
- Compare the TimesFM forecast with a naive baseline across rolling forecast origins.
How to install timesfm-forecasting
1Skills CLI (Vercel)
npx skills add K-Dense-AI/scientific-agent-skills --skill timesfm-forecasting -a claude-code2Manually: put the files in place
~/.claude/skills/timesfm-forecasting/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/timesfm-forecasting/
1Skills CLI (Vercel)
npx skills add K-Dense-AI/scientific-agent-skills --skill timesfm-forecasting -a codex2Manually: put the files in place
.agents/skills/timesfm-forecasting/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add K-Dense-AI/scientific-agent-skills --skill timesfm-forecasting -a cursor2Manually: put the files in place
.cursor/skills/timesfm-forecasting/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install K-Dense-AI/scientific-agent-skills timesfm-forecasting2Manually: put the files in place
.github/skills/timesfm-forecasting/SKILL.md1Skills CLI (Vercel)
npx skills add K-Dense-AI/scientific-agent-skills --skill timesfm-forecasting -a gemini-cli2Platform CLI
gemini skills install https://github.com/K-Dense-AI/scientific-agent-skills --path skills/timesfm-forecastingManually: put the files in place
.devin/skills/timesfm-forecasting/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add K-Dense-AI/scientific-agent-skills --skill timesfm-forecasting -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about timesfm-forecasting
How do I install timesfm-forecasting in Claude Code?
Run npx skills add K-Dense-AI/scientific-agent-skills --skill timesfm-forecasting -a claude-code. The skill will be available at ~/.claude/skills/timesfm-forecasting/SKILL.md. Then install the Python dependencies from the skill instructions.
What does timesfm-forecasting do?
It prepares regular time series and runs zero-shot forecasts with TimesFM. The skill covers quantile forecasts, XReg covariates, and evaluation on held-out data.
What does this skill require?
It requires Python 3.10+, timesfm 3.0.2 with PyTorch, NumPy, and pandas. Initial checkpoint loading needs network access and cache space; XReg requires JAX and scikit-learn.