Agent skill

Guidance Tracker

by daloopa in daloopa/investing

Track management guidance accuracy over time for a given company

Apache-2.0Auto-check passedBusiness, Finance & HR

Install Guidance Tracker

skills CLI
$ npx skills add daloopa/investing --skill guidance-tracker -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install daloopa/investing guidance-tracker --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/daloopa/investing.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/guidance-tracker .claude/skills/guidance-tracker && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
guidance-tracker
GitHub stars
489
Token cost
~2.5k tokens
SKILL.md length
1,281 words
Files
1
Skills in repo
22
Repo updated
First seen
Licence
Apache-2.0

At a glance

Track management guidance accuracy over time for a given company

  • Works in 8 steps: Company Lookup → Discover Guidance Series → Pull Guidance Data → …
  • Business, Finance & HR work in your project
  • SKILL.md covers 1. Company Lookup, 2. Discover Guidance Series, 3. Pull Guidance Data and 4. Pull Actual Results, plus 5 more sections
  • Reaches daloopa.com

What it does

Guidance Tracker is an agent skill from daloopa/investing. Track management guidance accuracy over time for a given company

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR. The licence is Apache-2.0.

When your agent uses it

  • Business, Finance & HR work in your project

Example prompts

  • “/guidance-tracker”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Company Lookup
  2. Discover Guidance Series
  3. Pull Guidance Data
  4. Pull Actual Results
  5. Build Guidance vs Actuals Tracker
  6. Pattern Analysis
  7. Commentary from Filings
  8. Save Report

What it can do on your machine

Read from SKILL.md and the folder at commit e2dd01d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • daloopa.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Guidance Tracker loads about 2.5k tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 1,281 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~20
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from daloopa/investing at commit e2dd01d, republished under its Apache-2.0 licence (© daloopa). 1,281 words, ~2,542 tokens.

Download SKILL.mdSave it as .claude/skills/guidance-tracker/SKILL.md (or your agent's skills folder).
name
guidance-tracker
description
Track management guidance accuracy over time for a given company
argument-hint
TICKER

Track management guidance accuracy for the company specified by the user: $ARGUMENTS

Before starting, read ../data-access.md for data access methods and ../design-system.md for formatting conventions. Follow the data access detection logic and design system throughout this skill.

Follow these steps:

1. Company Lookup

Look up the company by ticker using discover_companies. Capture:

  • company_id
  • latest_calendar_quarter — anchor for all period calculations below (see ../data-access.md Section 1.5)
  • latest_fiscal_quarter
  • Firm name for report attribution (default: "Daloopa") — see ../data-access.md Section 4.5

2. Discover Guidance Series

Search for series with keywords like "guidance", "outlook", "estimate", "forecast", "target" to find all available guidance metrics. Common guidance series include:

Financial guidance:

  • Revenue guidance (quarterly and/or annual)
  • EPS guidance
  • Operating income / margin guidance
  • EBITDA guidance
  • Segment-level revenue guidance
  • CapEx guidance
  • Free Cash Flow guidance

Operational KPI guidance — many companies guide on KPIs, and tracking these beats/misses is often more informative than financial guidance:

  • Subscriber / user count guidance (e.g., "we expect to add X million subscribers")
  • Unit shipment guidance (e.g., "iPhone units", "deliveries")
  • ARPU / ASP guidance
  • Same-store sales guidance
  • GMV / bookings guidance
  • Net revenue retention guidance
  • Store openings / closings guidance
  • Production volume / capacity guidance

Search explicitly for KPI-specific guidance series using terms like "subscriber guidance", "unit guidance", "ARPU guidance", "same-store sales outlook", "deliveries forecast", "bookings target". These are separate from financial guidance and often reside in different series.

3. Pull Guidance Data

Calculate 8+ quarters backward from latest_calendar_quarter. Pull all discovered guidance series for those periods.

4. Pull Actual Results

For each guidance metric, pull the corresponding actual result series for the same periods.

5. Build Guidance vs Actuals Tracker

CRITICAL OFFSET RULES:

  • Quarterly guidance: Guidance from Q(N) earnings call applies to Q(N+1) results. Compare Q(N) guidance -> Q(N+1) actual.
  • Annual guidance from Q1/Q2/Q3: Applies to current fiscal year. Compare to FY actual.
  • Annual guidance from Q4: Applies to NEXT fiscal year. Compare to next FY actual.

For each guidance-actual pair, calculate:

  • Guidance value
  • Actual value
  • Delta (Actual - Guidance)
  • Beat/Miss % ((Actual - Guidance) / |Guidance| x 100)
  • Classification: Beat / In-line / Miss (use +/-1% threshold for in-line)

6. Pattern Analysis

Analyze the guidance track record:

  • Overall beat rate (% of quarters where actual > guidance)
  • Average beat/miss magnitude
  • Trend in guidance accuracy (getting tighter? more conservative? less reliable?)
  • Any metrics where management is notably conservative or aggressive
  • Guidance range width trends (if range guidance is given)

Management credibility assessment:

  • If the company consistently beats by a similar margin, call out sandbagging — this suggests management is deliberately setting low bars, which can mask underlying deceleration. A 100% beat rate is not necessarily bullish; it may mean guidance is uninformative.
  • If guidance has been cut or missed, assess whether management acknowledged the miss honestly or buried it in adjusted metrics.
  • Flag any pattern where qualitative language ("strong demand," "robust pipeline") didn't translate to actual results.

7. Commentary from Filings

Search SEC filings/documents across multiple queries to build a complete picture of guidance practices. If any search returns empty, try alternative keywords before giving up.

  • Explicit guidance language: Try "guidance", "outlook"; fallback to "expect", "anticipate", "forecast"
  • Qualitative / directional guidance: Try "similar to", "consistent with", "growth rate"; fallback to "low single digit", "mid single digit", "high single digit", "double digit", "sequential"
    • Many companies provide directional revenue guidance on earnings calls (e.g., "similar to the March quarter" or "low-to-mid-single-digit growth") rather than numeric ranges. Capture these and compare against actual growth rates.
  • Guidance methodology changes: Try "change", "methodology", "no longer providing"; fallback to "withdraw", "suspend", "discontinue"
    • Flag any quarters where the company changed what metrics it guides on, or withdrew guidance entirely
  • Key drivers behind guidance: Try "assumes", "includes", "excludes"; fallback to "headwind", "tailwind", "impact"
    • Capture what management said about the assumptions underpinning their guidance (e.g., FX assumptions, macro assumptions, one-time items included/excluded)

Extract direct management quotes where available and cite the document source.

Show full SKILL.md (679 more words)Show less

7.5. Guidance Read-Throughs to Adjacent Companies

When a company raises, cuts, or materially changes its guidance, the implications often matter more for adjacent names than for the company itself. This section translates guidance signals into actionable read-throughs.

For each major guidance change identified in the tracker, analyze the implications for adjacent companies:

Identify who is affected by this company's guidance:

  • Suppliers: Revenue/CapEx guidance changes directly affect supplier order books. A CapEx guidance raise is a near-term purchase order for equipment/component suppliers. A revenue guide-down signals softer demand flowing upstream.
  • Customers: If this company supplies critical inputs, pricing or capacity guidance affects customer margins. Guiding for price increases = margin headwind for customers. Guiding for capacity expansion = supply relief.
  • Competitors: Guidance on market growth, pricing environment, or demand trends is often the most honest signal about the competitive landscape. If Company A guides for share gains, that's a direct share loss for Company B.
  • Channel partners / distributors: Volume guidance changes affect channel inventory and distributor revenue.

For each read-through (aim for 4-6), state:

  1. The guidance data point — which metric changed, by how much, and in which quarter's call
  2. The affected company (ticker + name)
  3. The implication — bullish or bearish, with specific logic
  4. Timing — is this a next-quarter impact or a multi-quarter trend?

Focus on the highest-signal guidance changes:

  • Guidance raises after a period of conservatism → strong signal that the underlying business is inflecting
  • Guidance cuts or "reaffirmed" when the market expected a raise → often more bearish than an explicit cut
  • New metrics being guided on (or old metrics withdrawn) → management is redirecting attention, which itself is a signal
  • Segment-level guidance changes → more specific read-throughs than consolidated figures
  • KPI guidance (subscriber adds, unit volumes, ARPU) → often the most direct read-through to suppliers and competitors

Example:

  • "NFLX raised Q2 subscriber guidance from +5M to +8M → Negative for DIS+, WBD: attention economy is zero-sum; NFLX's accelerating growth likely pressures competing streamers' subscriber adds. Positive for cloud/CDN names (AMZN/AWS, NET): more streaming = more infrastructure demand."
  • "TSMC raised full-year CapEx guidance by $4B (from $32B to $36B) → Positive for ASML: TSMC is ASML's largest customer; incremental CapEx skews toward EUV tools. Positive for AMAT, LRCX, KLAC: broader equipment spend benefits all semicap names."

Web research for validation: Run 1 targeted search: "{TICKER} guidance change implications read through {year}" — analyst commentary on cross-company signals from guidance moves.

Source quality (MANDATORY): Follow ../data-access.md Section 2.5 — cite only primary sources (SEC filings, IR pages, press releases, transcripts) and Tier-1 financial press (Reuters, Bloomberg, WSJ, FT). Never use or cite Yahoo Finance editorial, Benzinga, Seeking Alpha, Motley Fool, Zacks, TipRanks, StockTwits, Reddit, or similar aggregators/blogs.

Present as a structured section in the report after the Pattern Analysis, grouped by guidance change (each major guide raise/cut gets its own sub-block with the read-throughs beneath it).

8. Save Report

Save to reports/{TICKER}_guidance_tracker.html using the HTML report template from ../design-system.md. Write the full analysis as styled HTML with the design system CSS inlined. This is the final deliverable — no intermediate markdown step needed.

The report should include:

  • Summary header with company name, ticker, and period covered
  • Quarter mapping reference table showing the +1 offset explicitly:
    | Guidance Source Quarter | Guidance Applies To | Actual Result Quarter |
    | CQ1 2024               | CQ2 2024            | CQ2 2024              |
    | CQ2 2024               | CQ3 2024            | CQ3 2024              |
    This makes the offset rule visible and auditable for every row in the tracker.
  • Main tracker table with columns: Guidance Source, Metric, Guidance, Actual Period, Actual, Delta, Beat/Miss (with Daloopa citations on all values)
  • Summary statistics (beat rate, avg beat/miss by metric)
  • Pattern analysis narrative
  • Guidance read-throughs to adjacent companies (grouped by guidance change, with affected tickers and implications)
  • Key guidance quotes from filings with document citations

All financial figures must use Daloopa citation format: <a href="https://daloopa.com/src/{fundamental_id}">$X.XX million</a>

Tell the user where the HTML report was saved.

Highlight the key patterns (e.g., "Management has beat revenue guidance 7 of the last 8 quarters by an average of 2.3%"). Include an honest credibility verdict: Is management's guidance informative or performative? Should investors trust the forward guidance, and if not, what should they anchor to instead?

© daloopa, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/guidance-tracker of daloopa/investing.

Open the folder on GitHubat commit e2dd01d

Compare with similar skills

Guidance Tracker next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Guidance Tracker compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Guidance Tracker this skilldaloopa/investing489—~2.5kAutomated safety check: PassApache-2.0
Technical Analysttradermonty/claude-trading-skills3k5 repos~4.6kAutomated safety check: PassMIT
Creating Financial ModelsChen-zexi/open-ptc-agent7294 repos~1.3kAutomated safety check: PassMIT
Stock APIzhangxiangliang/stock-api2k—~507Automated safety check: PassMIT
Theme Detectortradermonty/claude-trading-skills3k2 repos~4.9kAutomated safety check: PassMIT
Itr Walakaranb192/itr-wala871—~3.6kAutomated safety check: PassMIT

Similar skills

  • Technical Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing weekly price charts for stocks, stock indices, cryptocurrencies, or forex pairs.

    3k GitHub starsUsed in 5 repos~4.6k tokens
    Business, Finance & HRAuto-check passed
  • Creating Financial Models

    Chen-zexi/open-ptc-agent

    This skill provides an advanced financial modeling suite with DCF analysis, sensitivity testing, Monte Carlo simulations, and scenario planning for investment decisions

    729 GitHub starsUsed in 4 repos~1.3k tokens
    Business, Finance & HRAuto-check passed
  • Stock API

    zhangxiangliang/stock-api

    Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets.

    2k GitHub stars~507 tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Theme Detector

    tradermonty/claude-trading-skills

    Detect and analyze trending market themes across sectors. An agent skill from tradermonty/claude-trading-skills.

    3k GitHub starsUsed in 2 repos~4.9k tokens
    Business, Finance & HRAuto-check passed
  • Itr Wala

    karanb192/itr-wala

    File Indian income tax returns (ITR) for FY 2025-26 / AY 2026-27.

    871 GitHub stars~3.6k tokensUpdated 4 days ago
    Business, Finance & HRAuto-check passed
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    319 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed

More from daloopa/investing

All 22 skills in this repo
  • Capital Allocation

    daloopa/investing

    Deep dive into capital deployment, buybacks, dividends, and shareholder yield

    489 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed
  • Comp Sheet

    daloopa/investing

    Build an industry comp sheet Excel model with deep operational KPIs

    489 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Comps

    daloopa/investing

    Trading comparables analysis with peer multiples and implied valuation

    489 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Dcf

    daloopa/investing

    Discounted cash flow valuation with sensitivity analysis. An agent skill from daloopa/investing.

    489 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Earnings Flash

    daloopa/investing

    Rapid first-read earnings flash for a given company. An agent skill from daloopa/investing.

    489 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Inflection

    daloopa/investing

    Auto-detect biggest acceleration/deceleration inflections across all metrics

    489 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed

Questions about Guidance Tracker

What does Guidance Tracker do?

Track management guidance accuracy over time for a given company. Guidance Tracker is an agent skill from daloopa/investing.

When should I use Guidance Tracker?

Guidance Tracker fits situations like: business, Finance & HR work in your project.

How do I install Guidance Tracker in Claude Code?

Run `npx skills add daloopa/investing --skill guidance-tracker -a claude-code`. Or copy the skill folder (.claude/skills/guidance-tracker in daloopa/investing) into .claude/skills/guidance-tracker in your project. Claude Code loads it when a task matches its description.

How do I install Guidance Tracker in Codex?

Run `npx skills add daloopa/investing --skill guidance-tracker -a codex`. Or copy the skill folder (.claude/skills/guidance-tracker in daloopa/investing) into .agents/skills/guidance-tracker in your project. Codex loads it when a task matches its description.

Can I use Guidance Tracker in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add daloopa/investing --skill guidance-tracker -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/guidance-tracker, .gemini/skills/guidance-tracker, .github/skills/guidance-tracker and .opencode/skills/guidance-tracker in your project.

What does Guidance Tracker need to run?

SKILL.md names no scripts, command-line tools or credentials: Guidance Tracker is instructions for the agent only.

Does Guidance Tracker access the network?

SKILL.md names 1 domain. In commands or code: daloopa.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Guidance Tracker safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Guidance Tracker use?

Guidance Tracker is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Guidance Tracker use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Guidance Tracker?

Skills that share tags, products or a category with Guidance Tracker: Technical Analyst (tradermonty/claude-trading-skills, 3k stars), Creating Financial Models (Chen-zexi/open-ptc-agent, 729 stars), Stock API (zhangxiangliang/stock-api, 2k stars) and Theme Detector (tradermonty/claude-trading-skills, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Guidance Tracker?

daloopa (a GitHub organization) maintains it in daloopa/investing, which has 489 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 7, 2026.

Source: daloopa/investing on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.