CtrlK
BlogDocsLog inGet started
Tessl Logo

analyzing-financial-statements

This skill calculates key financial ratios and metrics from financial statement data for investment analysis

48

Quality

51%

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

Fix and improve this skill with Tessl

tessl review fix ./skills_all/analyzing-financial-statements/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 is a well-organized, reasonably lean overview that correctly avoids teaching Claude things it already knows. However, it is a brochure rather than an operational skill: it names scripts that don't exist and provides no invocation examples, input schemas, or worked calculations, leaving Claude with nothing executable. Fixing the script references and adding concrete usage examples is the highest-leverage improvement.

Suggestions

Ship the referenced scripts (scripts/calculate_ratios.py, scripts/interpret_ratios.py) or remove the Scripts section — currently both references point to non-existent files.

Add an executable example, e.g. 'python scripts/calculate_ratios.py --statements financials.json --ratios all' with sample output, so the skill is copy-paste runnable.

Replace the vague Input Format bullets with a concrete example payload (one JSON or CSV snippet showing expected line items) so calculations can start without guesswork.

DimensionReasoningScore

Conciseness

The body is largely a lean catalog of capabilities, input/output formats, and examples with no explanation of concepts Claude already knows (it never explains what ROE or P/E means). Minor trimmable padding exists: the opening sentence restates the frontmatter description, and the 'Limitations' bullets ('Requires accurate financial data', 'Historical data doesn't guarantee future performance') are common knowledge. This fits 'efficient; minor instances of over-explanation' rather than 3, since the padding is incidental, not pervasive.

4 / 5

Actionability

The body describes rather than instructs: it names two scripts ('calculate_ratios.py: Main calculation engine', 'interpret_ratios.py: Provides interpretation and benchmarking') but never shows how to invoke them, and gives no concrete input schemas, commands, or worked examples. It sits above score 1 because it does enumerate concrete ratio names and accepted input formats (CSV, JSON, Excel), but below 3-4 because there is no executable or step-specific guidance anywhere — a user could not run anything from this document.

2 / 5

Workflow Clarity

'How to Use' lists a coherent three-step sequence (input data, select ratios, get interpretation) with a validation nod buried in Best Practices ('Always validate data completeness before calculations'), but no explicit checkpoints or commands in the workflow itself. This matches 'steps listed but validation gaps; checkpoints missing or implicit'; it is not 2 because the sequence is coherent and purposeful, and this read-only calculation task triggers no destructive/batch cap.

3 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, but the two referenced script files (calculate_ratios.py, interpret_ratios.py) do not exist — the working directory contains no scripts/, references/, or assets/ directories, so these are dangling references. Per the guideline to score against the actual bundle structure, 'some structure but references present yet problematic' fits 3; it is not 4 because broken references are more than a minor organization gap, and not 2 because the inlined content itself is appropriately scoped, not bloated.

3 / 5

Total

12

/

20

Passed

Description

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

The description communicates a clear 'what' in a distinct niche, but reads as a capability statement rather than a trigger-optimized description. It lacks any 'when to use' guidance and omits the natural vocabulary (specific ratio names, statement types) users would actually say. Adding an explicit 'Use when...' clause with concrete trigger phrases would lift it substantially.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when the user mentions financial ratios, P/E, balance sheets, or asks to analyze a company's financials.'

Include natural trigger vocabulary users actually say — specific ratio names (ROE, P/E, EPS), statement names (income statement, balance sheet, cash flow), and file types (.xlsx, CSV).

Enumerate 2-3 concrete capabilities (e.g. 'calculates ROE, P/E, and liquidity ratios; benchmarks against industry averages') to sharpen specificity.

DimensionReasoningScore

Specificity

The description names the domain ('financial ratios and metrics from financial statement data') and one concrete action ('calculates'), matching the anchor for 1-2 concrete actions without comprehensive coverage. It is above score 2 because it specifies inputs and purpose rather than a bare generic action, but below 4 because it lists no specific ratios or several discrete actions.

3 / 5

Completeness

The 'what' is clear (calculates financial ratios and metrics from statement data), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 4 because the 'when' is entirely absent rather than present-but-imprecise.

3 / 5

Trigger Term Quality

It contains relevant natural phrases users would say ('financial ratios', 'financial statement data', 'investment analysis'), but misses common variations and synonyms users actually invoke ('P/E ratio', 'balance sheet', 'income statement', 'analyze a company'). This fits the 'some relevant keywords but missing common variations' anchor rather than 4's 'good coverage with a few missing'.

3 / 5

Distinctiveness Conflict Risk

Financial ratio calculation for investment analysis is a mostly distinct niche with minor overlap risk against general spreadsheet/data-analysis skills. It is below 5 because the description lacks concrete distinct trigger phrases that would fully disambiguate it from adjacent financial-analysis skills.

4 / 5

Total

13

/

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
Microck/ordinary-claude-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.