CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

timesfm-forecasting

Zero-shot time series forecasting with Google's TimesFM foundation model. Use for any univariate time series (sales, sensors, energy, vitals, weather) without training a custom model. Supports CSV/DataFrame/array inputs with point forecasts and prediction intervals. Includes a preflight system checker script to verify RAM/GPU before first use.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is timesfm-forecasting in K-Dense-AI/scientific-agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-gated body: executable code for every common case and a validated preflight-to-forecast sequence with real feedback loops. The main deductions are duplicated content (a repeated covariates code block, thrice-repeated system-check instructions, split reference listings) and two referenced `examples/` directories that do not exist in the bundle.

Suggestions

Remove the duplicate `forecast_with_covariates` code block that appears after the anomaly-detection snippet (SKILL.md lines ~267-276), and consolidate the three separate `check_system.py` instructions and the two reference-file listings into single sections.

Create the referenced `examples/anomaly-detection/` and `examples/covariates-forecasting/` directories, or drop the three pointers to them so no reference dead-ends.

Merge the Hardware Requirements table and the Model Versions table (both restate params/context/status for TimesFM 1.0/2.0/2.5) into one version-comparison section.

DimensionReasoningScore

Conciseness

Mostly efficient but with real tightening opportunities: the `forecast_with_covariates` code block appears twice (once in the covariates section and again, misplaced, after the anomaly-detection snippet), the `check_system.py` instructions are repeated across three sections ("Mandatory Preflight", "Installation Step 1", "Available Scripts"), the reference files are listed in two separate sections, and model-version info is duplicated in the hardware table and the Model Versions table. This matches the 'mostly efficient but could be tightened' anchor rather than the 'minor instances' level of 4.

3 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: a runnable 5-line minimal example, CSV forecasting code, covariate and anomaly-detection snippets, hardware-specific install commands (CUDA/CPU/MPS index URLs), a verification snippet, and a concrete CLI invocation with flags for `forecast_csv.py`. Common cases are covered with real code, matching the top anchor.

5 / 5

Workflow Clarity

The multi-step process is clearly sequenced with explicit validation gates: a mandatory preflight checker that warns or blocks on RAM/VRAM/disk thresholds (rendered as a decision flowchart), a verify-installation step, NaN-in-output checking guidance in Common Pitfalls, and backtesting with interval coverage in `references/workflows.md`; `forecast_csv.py` even re-runs the system check automatically. Feedback loops (warn → smaller batches, fail → blocked before download) are present for the risky batch/model-load operations.

5 / 5

Progressive Disclosure

The body functions as an overview with clearly signaled, one-level-deep references, and all 7 `references/` files and both `scripts/` files referenced in the body actually exist in the bundle. It falls short of 5 because `examples/anomaly-detection/` and `examples/covariates-forecasting/` are referenced three times but do not exist in the bundle (dead-end navigation), and reference navigation is split across two separate sections ("Output, Configuration, Workflows, and Tuning" and "Reference Documentation").

4 / 5

Total

17

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that explicitly answers what the skill does and when to use it, with concrete actions and natural trigger terms. Minor gaps: a few missing user-side synonyms and no boundary cue to distinguish it from classical statistical forecasting approaches.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Zero-shot time series forecasting", "Supports CSV/DataFrame/array inputs with point forecasts and prediction intervals", "preflight system checker script to verify RAM/GPU" — with comprehensive coverage of what the skill does, matching the 'multiple specific concrete actions' anchor. It is not a 4 because no meaningful capability is left unstated: inputs, outputs, model, and the operational safeguard are all named.

5 / 5

Completeness

Both questions are explicitly answered: what ("Zero-shot time series forecasting with Google's TimesFM foundation model... point forecasts and prediction intervals") and when ("Use for any univariate time series (sales, sensors, energy, vitals, weather) without training a custom model") with concrete trigger domains, matching the top anchor. It is not lower because the 'Use for' clause is explicit and enumerates real trigger scenarios.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "time series forecasting", "sales, sensors, energy, vitals, weather", "zero-shot", "prediction intervals", and the CSV input format — terms users would naturally say. It falls short of the 5 anchor because common user phrasings like "forecast demand", "predict future values", or a .csv extension mention are absent, and "univariate" leans technical.

4 / 5

Distinctiveness Conflict Risk

The TimesFM foundation-model niche and zero-shot framing make it mostly distinct with clear triggers. It does not reach 5 because "Use for any univariate time series... without training a custom model" could route requests that are better served by classical forecasting skills (ARIMA/statsmodels), and the description gives no boundary guidance to disambiguate.

4 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/coding/timesfm-forecasting/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.