CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

earnings-calendar

This skill retrieves upcoming earnings announcements for US stocks using the Financial Modeling Prep (FMP) API. Use this when the user requests earnings calendar data, wants to know which companies are reporting earnings in the upcoming week, or needs a weekly earnings review. The skill focuses on mid-cap and above companies (over $2B market cap) that have significant market impact, organizing the data by date and timing in a clean markdown table format. Supports multiple environments (CLI, Desktop, Web) with flexible API key management.

Quality

84%

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

73%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-structured, highly actionable skill body with an excellent sequenced workflow, explicit validation checklists, and proper offloading of detail to real bundle files. The main costs are redundant overview/summary sections that pad the token budget and one broken file reference (requirements.txt) in the troubleshooting section.

Suggestions

Collapse the Overview, Key Features, and closing Summary sections into a single brief overview — their content is largely duplicative and adds ~30 lines of padding.

Fix or remove the 'pip install -r skills/earnings-calendar/requirements.txt' instruction, since no requirements.txt exists in the bundle; either ship the file or state the dependency inline (e.g., 'pip install requests').

Trim the 'Why This Matters' subsection under Step 1 — the time-sensitivity of earnings calendars is inferable and does not need a dedicated rationale block.

DimensionReasoningScore

Conciseness

The body is mostly operational, but the Overview, Key Features, and closing Summary sections repeat each other, and the 'Why This Matters' block explains that earnings calendars are time-sensitive — something inferable. Several sections could be tightened or merged.

3 / 5

Actionability

Provides copy-paste executable commands for both scripts (e.g., 'python scripts/fetch_earnings_fmp.py 2025-11-03 2025-11-09'), the expected JSON output schema, and HTTP error codes with remedies. Minor gap: the troubleshooting command 'pip install -r skills/earnings-calendar/requirements.txt' points to a file that does not exist in the bundle.

4 / 5

Workflow Clarity

Eight clearly sequenced steps with an explicit QA checklist (Step 7), an error-handling table mapping failures to recovery actions (401 → verify key, 429 → wait/upgrade), and a documented fallback mode — full validation checkpoints and feedback loops.

5 / 5

Progressive Disclosure

All seven referenced reference files exist in the bundle and are clearly signaled with 'Read references/...' plus a description of their contents; API details, data processing, use cases, and best practices are appropriately offloaded one level deep. The dangling requirements.txt path keeps it from the top score.

4 / 5

Total

16

/

20

Passed

Description

87%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 with explicit 'Use this when...' trigger guidance, concrete capability statements, and a well-defined niche. Third-person voice is used throughout, and the only weaknesses are a mildly generic closing clause about environments/API keys and a few missing natural synonyms like 'earnings season'.

DimensionReasoningScore

Specificity

Lists several concrete actions ('retrieves upcoming earnings announcements for US stocks', 'organizing the data by date and timing in a clean markdown table format', market-cap filtering), but the closing 'flexible API key management' is generic, leaving a minor coverage gap.

4 / 5

Completeness

Explicitly answers both what ('retrieves upcoming earnings announcements for US stocks using the Financial Modeling Prep (FMP) API... organizing the data by date and timing') and when ('Use this when the user requests earnings calendar data, wants to know which companies are reporting earnings...'), with concrete trigger phrases matching the top anchor.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'earnings calendar data', 'which companies are reporting earnings in the upcoming week', and 'weekly earnings review' are present, though common variants such as 'earnings season' or 'earnings reports' are missing.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (US earnings calendar via FMP, mid-cap and above, over $2B market cap) with distinct triggers that are unlikely to fire for unrelated skills.

5 / 5

Total

18

/

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

tradermonty/claude-trading-skills

Path

skills/earnings-calendar/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.