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.

66

Quality

83%

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

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.

The body delivers excellent actionability and a well-validated workflow — every step has runnable commands, expected outputs, and error-recovery paths. Its weakness is token efficiency: 721 lines with a fully inlined report template duplicating an existing asset file and API-key guidance repeated across four sections.

Suggestions

Replace the ~100-line inlined report structure in Step 6 with a brief sample and a pointer to assets/earnings_report_template.md (and to generate_report.py, which already produces it automatically).

Consolidate API-key setup into one section — it currently appears in Prerequisites, Step 3.2.1, Security Notes, and Best Practices with overlapping content.

Remove the closing Summary section and the 'Why This Matters' explanations, which restate the Overview and assume Claude cannot reason about obvious date-sensitivity.

DimensionReasoningScore

Conciseness

At 721 lines the body is noticeably verbose: the full ~100-line report template is inlined despite assets/earnings_report_template.md existing, API-key instructions appear in four places (Prerequisites, Step 3.2.1, Security Notes, Best Practices), and the closing Summary restates the Overview. Not score 1 because most material is domain-specific rather than re-explaining concepts Claude already knows; not score 3 because the duplication and padding are extensive, not incidental.

2 / 5

Actionability

Fully executable throughout: exact commands with real date examples ('python scripts/fetch_earnings_fmp.py 2025-11-03 2025-11-09'), real script paths, expected JSON output shape, per-error-code handling (401/429/empty/connection), a working one-liner, and a concrete manual fallback with URLs. Copy-paste ready and covers the common cases — a direct match to the top anchor.

5 / 5

Workflow Clarity

An 8-step clearly sequenced workflow with explicit validation (Step 7 QA checklist of data/completeness/format checks), feedback loops for error recovery (401 → verify/re-enter key, 429 → wait, empty → widen range), and a fallback mode with its own sub-workflow. Not score 4 because checkpoints are explicit and checklist-based, matching the top anchor; the operation is read-only retrieval plus report generation, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

References are well signaled and one level deep (Step 2 'Read: references/fmp_api_guide.md', script locations, 'Report Template: assets/earnings_report_template.md'), and all referenced bundle files exist. Not score 5 because the ~100-line report template and much of the API guidance summary are inlined in SKILL.md even though a separate template file and a 609-line reference already hold that content — content that should live in the bundle is duplicated in the body. Not score 3 because most content is appropriately placed and navigation is easy.

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 that clearly and explicitly states both capability and trigger conditions in third-person voice with a well-defined niche. The main gap is moderate action coverage and a few missing natural trigger synonyms, plus a slightly padded back half describing scope rather than capabilities.

Suggestions

Trim the scope description ('The skill focuses on mid-cap and above companies... Supports multiple environments') to free budget for one more concrete action such as 'includes EPS and revenue estimates'.

Add a natural trigger synonym such as 'earnings this week' or 'who reports earnings' to broaden trigger coverage.

DimensionReasoningScore

Specificity

Concrete actions are named ('retrieves upcoming earnings announcements for US stocks using the Financial Modeling Prep (FMP) API', 'organizing the data by date and timing in a clean markdown table format') but coverage is not comprehensive — the latter half describes scope (mid-cap and above, over $2B) and environments rather than listing additional actions. Not score 5 because it lists only two real actions; not score 3 because those actions are specific and supplemented by concrete detail (markdown table format, API source).

4 / 5

Completeness

Explicitly answers both what ('retrieves upcoming earnings announcements for US stocks using the FMP API... organizing the data by date and timing in a clean markdown table format') and when ('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') with concrete trigger phrases — a direct match to the top anchor.

5 / 5

Trigger Term Quality

Natural phrases users would say are present ('requests earnings calendar data', 'which companies are reporting earnings in the upcoming week', 'needs a weekly earnings review'). Not score 5 because common synonyms like 'earnings this week', 'who reports earnings', or 'earnings report' are missing; not score 3 because multiple natural trigger phrases are already covered.

4 / 5

Distinctiveness Conflict Risk

A clear niche (US stock earnings calendars, mid-cap+ via FMP API) with distinct trigger terms that are unlikely to fire for unrelated skills. Neither the score-4 anchor (minor overlap with closely related skills) nor below applies.

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.