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.

72

Quality

88%

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

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with a clear, validated multi-step workflow and real bundle scripts, but it is verbose: the report template is duplicated inline despite an existing asset file, and guidance is repeated across Best-Practices, Do's/Don'ts, and Security sections.

Suggestions

Remove the ~100-line inlined report template (lines 336-436) and point to assets/earnings_report_template.md instead, since the asset already contains it.

Merge the overlapping Best Practices, Do's/Don'ts, and Security Notes sections into a single concise checklist to cut repeated guidance.

Trim the 'Why This Matters' and verbose step explanations where the intent is already obvious from the script's documented behavior.

DimensionReasoningScore

Conciseness

The body is mostly actionable but padded: the full ~100-line markdown report template is inlined (lines 336-436) even though assets/earnings_report_template.md already holds it, and Security/Best-Practices/Do's-and-Don'ts sections repeat the same guidance multiple times. It is not level 3 because material is duplicated and could be tightened, but not level 1 because the core guidance is concrete rather than explaining concepts Claude already knows.

2 / 3

Actionability

Provides fully executable commands backed by real scripts: 'python scripts/fetch_earnings_fmp.py 2025-11-03 2025-11-09', 'python scripts/generate_report.py earnings_data.json', and a chained one-liner, plus a concrete JSON output schema. Matches the level-3 copy-paste-ready anchor; not level 2 because the code/commands are complete and executable rather than pseudocode.

3 / 3

Workflow Clarity

A clear Step 1–8 sequence with explicit checkpoints: date calculation, API-key detection, fetch with enumerated error handling (401/429/empty/connection), and a dedicated Step 7 Quality Assurance with data/completeness/format checklists. Matches the level-3 anchor of explicit validation and feedback loops; not level 2 because validation checkpoints are explicit rather than implicit.

3 / 3

Progressive Disclosure

Bundle files exist and are clearly signaled (Step 2 'Read: references/fmp_api_guide.md'; Resources lists scripts/ and assets/ paths), all one level deep. However the full report template is inlined in the body while also existing as assets/earnings_report_template.md, fitting the level-2 anchor 'content that should be separate is inline'; not level 3 because of this duplication, not level 1 because references are well signaled and only one level deep.

2 / 3

Total

10

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is third-person, concise, and covers what the skill does and when to use it with natural trigger terms and a distinctive niche. It is among the strongest description examples, with no vague fluff or over-claims.

DimensionReasoningScore

Specificity

Lists multiple concrete actions and details: 'retrieves upcoming earnings announcements for US stocks', 'focuses on mid-cap and above companies (over $2B market cap)', 'organizing the data by date and timing in a clean markdown table format', and 'Supports multiple environments (CLI, Desktop, Web) with flexible API key management'. This matches the level-3 anchor of multiple specific concrete actions, and is not level 2 because the action set is comprehensive rather than partial.

3 / 3

Completeness

Explicitly answers both 'what' (retrieves upcoming US earnings via FMP API, mid-cap+ filter, markdown table output) and 'when' via an explicit 'Use this when the user requests earnings calendar data...' trigger clause. This is the level-3 anchor for clearly answering both what AND when with explicit triggers; not level 2 because the 'when' is explicit, not merely implied.

3 / 3

Trigger Term Quality

Natural user phrasing is well covered: 'earnings calendar data', 'which companies are reporting earnings in the upcoming week', and 'weekly earnings review'. These are terms a user would naturally say, matching the level-3 anchor; not level 2 because common variations are present rather than missing.

3 / 3

Distinctiveness Conflict Risk

Clear niche — weekly US earnings calendar via FMP API with a >$2B market-cap filter and date/timing grouping — with distinct triggers unlikely to fire for unrelated skills. Matches the level-3 clear-niche anchor; not level 2 because the scope is narrowly scoped and unlikely to overlap with general finance or document skills.

3 / 3

Total

12

/

12

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.

Validation15 / 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.