forecasting-readout

forecasting-readout is a skill for Claude Code from thuong-nc/perlytics-skill. It costs 29 tokens per session (1,275 once invoked), scanned A, original, Apache-2.0.

A forecasting method that projects a business measure such as revenue, users, or orders and explains the trend, assumptions, and uncertainty around the projection. It is intended to support planning and decisions rather than provide an unsupported single number.

In plain words
What is it for?
Use it for planning, budgeting, setting targets, or checking whether a current trend is likely to reach a future goal.
Why use it?
It reduces the risk of treating an estimate as certain and makes clear what past pattern the projection relies on. It also identifies when there is not enough comparable history to forecast responsibly.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: positional $N argument.

Part of the perlytics-skill plugin — 16 skills shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/thuong-nc/perlytics-skill/forecasting-readout
Any agent
npx skills add thuong-nc/perlytics-skill --skill forecasting-readout
Clone the repo
git clone --depth 1 https://github.com/thuong-nc/perlytics-skill

Made for: Claude Code.

Or install perlytics-skill, the plugin that ships this one along with the rest of its 16 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for forecasting-readout

README.md
[![agentmods](https://agentmods.dev/badge/skills/thuong-nc/perlytics-skill/forecasting-readout.svg)](https://agentmods.dev/skills/thuong-nc/perlytics-skill/forecasting-readout)
Your own site
<a href="https://agentmods.dev/skills/thuong-nc/perlytics-skill/forecasting-readout"><img src="https://agentmods.dev/badge/skills/thuong-nc/perlytics-skill/forecasting-readout.svg" alt="Measured on agentmods" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,275 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00029 $0.01275
Opus 5 $0.00015 $0.00638
Sonnet 5 $0.00006 $0.00255
Haiku 4.5 $0.00003 $0.00128

Measured 6d ago against content hash 8ff92f6c95ae, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

forecasting-readout scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/forecasting-readout/SKILL.md · 109 lines

How it starts

The opening of the file, as written. The whole thing — 109 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Forecasting Readout

Purpose

Turn a metric projection into a decision-ready forecast with explicit trend basis, assumptions, and uncertainty bounds - not just a point estimate.

When to use

Use this skill when:

  • asked "what will revenue/users/orders be next quarter/month/year?"
  • projecting a metric for planning, budgeting, or target-setting
  • presenting a forecast to a stakeholder who will use it to make a decision
  • evaluating whether a current trend leads to hitting or missing a target

When not to use

Do not use this skill when:

  • there is insufficient history to support any projection (fewer than 3-4 comparable periods)
  • the metric is driven primarily by an upcoming event or decision with no historical analog
  • the question is why a metric changed, not where it is going (use root-cause-analysis)

Required thinking discipline

  • Never produce a point estimate alone. A single number without a range implies false precision and misleads decision-makers.
  • State the basis for the projection explicitly - what pattern does the forecast extrapolate?
  • Distinguish extrapolation from causally grounded projection. Trend extrapolation assumes "what has been true will continue." That assumption needs to be named.
  • Separate trend from seasonality. Projecting November revenue in July requires handling the seasonal pattern explicitly.
  • A forecast is a decision input, not a commitment. State what would need to change for the forecast to be wrong.
  • Evidence constraint: Every conclusion must cite specific data — a number, a rate, a segment, or a timeframe. Do not speculate without evidential basis. If data is insufficient, state what is missing rather than asserting an unsupported inference.

Workflow

  1. Define the metric, entity, and forecast horizon (e.g., net revenue, all markets, next 90 days).
  2. Characterize the historical trend basis:
    • Flat (no directional trend)
    • Linear growth or decline
    • Accelerating or decelerating growth
    • Mean-reverting or cyclical
    • Event-driven (spikes around campaigns, holidays, product launches)
  3. Identify and separate seasonality: does the metric have known weekly, monthly, or annual periodic patterns? State how seasonality is handled (carried forward, averaged, ignored).
  4. List key assumptions the forecast depends on:
    • No major product, pricing, or acquisition strategy changes
    • External environment remains consistent
    • Seasonality pattern from prior years applies
    • Any specific operational assumptions (new market launch, campaign planned)
  5. Produce the point estimate plus a scenario range:
    • Base case: continuation of recent trend with normal seasonality
    • Upside case: trend continues at the favorable end of recent variance
    • Downside case: trend continues at the unfavorable end, or a known risk materializes
  6. State conditions that would invalidate the forecast - what event or change would require revisiting the projection?

Read the full file on GitHub · 109 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 109 lines · 29 tokens per session scan A 8ff92f6c95ae

Subscribe to this mod's changes

forecasting-readout is a skill published in the GitHub repository thuong-nc/perlytics-skill (5 stars, last pushed 4mo ago), licensed Apache-2.0. It adds 29 tokens to every session and 1,275 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

happiness-skill

当用户问「怎么才能更幸福/为什么得到了还不满足/怎么减少焦虑」时调用。 核心理念: 幸福是缺憾感清空的默认状态, 是可训练的技能; 欲望是与自己的契约(得到前不快乐), 同时只留一个重大欲望; 活在当下。 不适用于: 临床抑郁等需要专业治疗的场景(本书方法不能替代医疗)。 Triggers: 幸福/不快乐/欲望/焦虑/知足/活在当下/happiness/desire/anxiety.

kangarooking/cangjie-skill · 136 tokens

docx-comment-reply

Reply to comments (批注) in Word .docx/.doc files: extract comment context, draft replies, write threaded replies back, and validate OOXML.

foryourhealth111-pixel/Vibe-Skills · 39 tokens

sn-image-imitate

Generates a new image that imitates the style of a reference image while updating content based on user intent. Uses a three-stage pipeline: image annotation (long caption), caption rewriting, and image generation. Use when user asks to "imitate style", "保持这个风格重画", "按这张图风格生成", or "style transfer with new content".

OpenSenseNova/SenseNova-Skills · 82 tokens

asc-subscription-localization

Bulk-localize subscription, subscription-group, and in-app purchase display names across App Store locales using asc, including API 4.4.1 version-scoped v2 resources. Use when filling or updating subscription/IAP names and descriptions without App Store Connect UI work.

rorkai/app-store-connect-cli-skills · 60 tokens

pcbway

PCBWay PCB fabrication and assembly — turnkey/consigned assembly, design rules, ordering workflow. Alternative to JLCPCB for manufacturing. Use with KiCad. Use this skill when the user mentions PCBWay, needs turnkey assembly (PCBWay sources parts by MPN), has parts not available on LCSC, needs assembled boards with…

aklofas/kicad-happy · 119 tokens

explaining-machine-learning-models

Explain trained machine learning models through feature attribution, local explanations, and behavior summaries. Use as an explicit/manual helper once a model already exists, not for training ownership, leakage auditing, or general ML strategy selection.

foryourhealth111-pixel/Vibe-Skills · 49 tokens