CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

The canonical home for this skill is earnings-calendar in tradermonty/claude-trading-skills

SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

Highly actionable and workflow-safe: executable commands against real bundled scripts, explicit validation checkpoints, and error-recovery guidance. The main weakness is token efficiency — extensive repetition and an inlined report template that duplicates the assets file keep progressive disclosure and conciseness below their potential.

Suggestions

Replace the ~100-line inlined report template in Step 6 with a pointer to assets/earnings_report_template.md (the file already exists), keeping only a brief structural outline inline.

Consolidate the API key guidance repeated across Prerequisites, Step 3, and Security Notes into a single section, and state the market-cap tiers ($2B/$10B/$200B) only once.

Cut Step 5's manual processing sub-steps (5.1-5.6), since generate_report.py already handles parsing, grouping, sorting, and summary statistics — a one-line note that the script does this suffices.

DimensionReasoningScore

Conciseness

The ~700-line body is noticeably verbose: API key setup and security guidance is repeated across Prerequisites, Step 3, and Security Notes; the market-cap tier definitions (Mega >$200B / Large $10B-$200B / Mid $2B-$10B) are restated at least four times; and a ~100-line report template is inlined wholesale. Explanations like 'Earnings calendars are time-sensitive' and 'Why This Matters' pad text Claude does not need. Fits anchor 2 (several padded sections); not anchor 3, where padding would be incidental rather than structural repetition.

2 / 5

Actionability

Commands are copy-paste ready against real bundled scripts ('python scripts/fetch_earnings_fmp.py 2025-11-03 2025-11-09', 'python scripts/generate_report.py earnings_data.json earnings_calendar_2025-11-02.md'), with a combined one-liner, expected JSON output schema, concrete error handling per HTTP status (401/429/empty/connection), a manual fallback mode, and four worked use cases. Matches anchor 5's fully-executable, common-cases-covered bar.

5 / 5

Workflow Clarity

An explicit 8-step sequence with a dedicated QA checklist step (Step 7: data quality, completeness, and format checks) and feedback loops — Step 4 maps each error to a recovery action ('401 Unauthorized: Invalid API key → Verify key or re-enter') and a Troubleshooting section covers five failure modes. Matches anchor 5 (clear sequence, explicit validation, error-recovery loops, checklists).

5 / 5

Progressive Disclosure

Bundle structure is real and well-signaled (references/fmp_api_guide.md, both scripts, and the asset template all exist, one level deep), but the body inlines content that already lives in those files — most notably the full ~100-line report template duplicating assets/earnings_report_template.md, plus a detailed API guide summary and JSON schema. Fits anchor 3 ('content that should be separate is inline') more than anchor 4, where such duplication would be only a minor gap.

3 / 5

Total

15

/

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 an explicit 'Use this when' trigger clause, concrete capability statements, and a well-defined niche. Minor deductions for light buzzword padding ('significant market impact', 'flexible API key management') and a few missing natural synonyms such as 'earnings reports'.

DimensionReasoningScore

Specificity

Concrete actions include 'retrieves upcoming earnings announcements for US stocks', 'organizing the data by date and timing in a clean markdown table format', and the explicit '>$2B market cap' filter — several specific actions, but padded with vaguer claims like 'significant market impact' and 'flexible API key management'. Fits anchor 4 (several specific actions, minor gaps) rather than 5 (comprehensive coverage) because the filtering/formatting scope stops short of a complete capability list.

4 / 5

Completeness

Clearly answers 'what' ('retrieves upcoming earnings announcements... organizing the data by date and timing in a clean markdown table format') and 'when' with an explicit 'Use this when...' clause listing three concrete trigger scenarios. Matches anchor 5; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural phrases like 'earnings calendar data', 'which companies are reporting earnings in the upcoming week', and 'weekly earnings review' match what users would say. Falls short of anchor 5's comprehensive synonym coverage — missing common variations like 'earnings reports', 'earnings announcements', or 'who reports this week'.

4 / 5

Distinctiveness Conflict Risk

A clear niche — US-stock earnings calendars via the FMP API with a market-cap filter — with distinct trigger phrases unlikely to fire for unrelated skills. Anchor 4 would require notable overlap with closely related skills, but 'earnings calendar' / 'reporting earnings this week' triggers are specific to this domain.

5 / 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

skill_md_line_count

SKILL.md is long (722 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository
tradermonty/claude-trading-skills
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.