CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

earnings-preview

Build a pre-earnings briefing for a stock from Yahoo Finance data (yfinance): the upcoming report date and timing, consensus EPS and revenue estimates with their range, the beat/miss track record, analyst ratings and price targets, and what to watch in the print. Use this skill whenever the user is preparing for an upcoming earnings report or asks what the street expects — consensus or whisper numbers, EPS expectations, whether a company will beat, an earnings setup, or an earnings-season preview — and whenever a ticker comes up in the context of upcoming earnings, even without the word "preview". For results that are already out, use earnings-recap.

75

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 well-engineered content body: executable fetch code, a precise field-extraction table, a clearly specified five-part briefing structure with concrete thresholds, and clean deferral to a single real reference file. The only weaknesses are minor — a duplicated disclaimer, some host-specific probe meta-commentary, and the absence of an explicit error-recovery loop for failed installs or empty API responses.

Suggestions

State the not-financial-advice caveat once (either the intro disclaimer or Step 4) instead of repeating it in both places, and trim the host-specific probe framing to a single short instruction.

Add a brief error-recovery step: what to do if the pip install fails, or if key data sources return empty (e.g., an empty calendar dict), rather than only handling missing fields at briefing time.

Simplify the nested-exec shell probe to a plain `python3 -c "import yfinance; print(yfinance.__version__)"` style check so it is readable and portable across hosts.

DimensionReasoningScore

Conciseness

The body is largely table- and code-driven with almost no padding, but there are trimmable redundancies: the not-financial-advice caveat appears both in the intro disclaimer and again in Step 4, and the "If your host has not already executed the shell probes below (for example, in Codex)" host meta-commentary plus the convoluted nested-exec `!` probe could be simplified. This sits above the 3 anchor (only minor over-explanation) but short of the 5 anchor where every token earns its place.

4 / 5

Actionability

The guidance is fully executable: a copy-paste-ready fetch script, an exact key-fields table per data source, and concrete heuristics such as "a time at or after 16:00 ET means after the close" and "a high/low spread wider than about 20% of consensus signals unusual uncertainty". The `# replace with actual ticker` comment makes the one placeholder explicit, matching the 5 anchor for copy-paste-ready coverage of common cases.

5 / 5

Workflow Clarity

The four steps are clearly sequenced with an install-validation checkpoint (probe → install if missing → skip if present) and missing-data handling ("if the data for one is missing, say so in a line rather than dropping it"), which fits the 4 anchor. It falls short of 5 because there is no error-recovery loop for failed installs or empty fetches — e.g., the empty-`calendar` edge case is only documented in the reference file, not in the workflow.

4 / 5

Progressive Disclosure

The body is an overview that keeps only a key-fields summary inline and pushes detailed method signatures and edge cases to a single, real, one-level-deep reference (references/api_reference.md), clearly signaled with purpose ("Read the reference file when you need exact method signatures or edge case handling"). This matches the 5 anchor for well-signaled, appropriately split content with easy navigation.

5 / 5

Total

18

/

20

Passed

Description

100%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 model description: concrete capability list, explicit and richly varied trigger phrases including synonym coverage and implicit-invocation guidance, and an explicit boundary against the sibling recap skill. Third-person voice throughout with no filler.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete deliverables — "upcoming report date and timing, consensus EPS and revenue estimates with their range, the beat/miss track record, analyst ratings and price targets, and what to watch in the print" — which matches the comprehensive-coverage anchor; the 4 anchor requires coverage gaps and none are present.

5 / 5

Completeness

Both halves are explicit: the "what" is the full briefing component list and the "when" is a concrete "Use this skill whenever the user is preparing for an upcoming earnings report or asks what the street expects" clause with multiple trigger phrases, matching the 5 anchor exactly; the 4 anchor applies when 'when' guidance is less explicit.

5 / 5

Trigger Term Quality

It covers natural user phrasing comprehensively, including synonyms like "what the street expects", "whisper numbers", "EPS expectations", "whether a company will beat", "an earnings setup", and "earnings-season preview", and even addresses implicit invocation ("a ticker comes up in the context of upcoming earnings, even without the word 'preview'"). This is the comprehensive-synonyms anchor, not merely good coverage with a few missing terms.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche (pre-earnings setup for a ticker) and adds an explicit boundary — "For results that are already out, use earnings-recap" — so it is unlikely to trigger for a sibling earnings skill; minimal conflict risk as in the 5 anchor.

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

himself65/finance-skills

Path

plugins/market-analysis/skills/earnings-preview/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.