CtrlK
BlogDocsLog inGet started
Tessl Logo

edgar-sec-filings

SEC EDGAR filing analysis — 10-K, 10-Q, 8-K, proxy statements, insider Form 4. Extract key financials, risk factors, management discussion, and generate investment signals from US public company filings.

60

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./agent/src/skills/edgar-sec-filings/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 signal-dense, domain-expert body with genuinely useful heuristics, tables, and a clear output template, hindered mainly by a lack of explicit end-to-end workflow with validation checkpoints and by a monolithic ~290-line structure that inlines material better suited to one-level-deep reference files.

Suggestions

Add an explicit numbered workflow (retrieve filing via EDGAR URL or yfinance → verify period/data completeness → apply per-filing-type analysis → compute composite score → emit output template) with validation checkpoints, including handling EDGAR rate limits (10 req/s with User-Agent) and retry on failed retrieval.

Split per-filing-type deep dives into one-level-deep references (e.g., references/8k-events.md, references/insider-form4.md, references/13f-analysis.md) and keep SKILL.md as a lean overview with clearly signaled links, reducing the inline body substantially.

Make the pseudocode blocks executable or explicitly label them as heuristics: complete the tone-scoring snippet with actual word-count logic, fix 'analyze_13f_changes' (undefined 'signal' path, set subtraction on holder records), and present the composite 'filing_score' as a concrete function rather than a commented dictionary.

DimensionReasoningScore

Conciseness

The body is dense with domain-specific heuristics Claude would not know (FCF conversion thresholds, 8-K item classification, insider signal rules, 45-day 13F lag) and does not pad with basics like 'what a 10-K is'. However, a few lines over-explain the obvious ('The MD&A section is the most qualitative and forward-looking part of the filing', 'Restatements destroy trust'), fitting anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

Mostly executable guidance: working yfinance snippets, an EDGAR company-search URL, a complete 'score_insider_activity' function, and a concrete output-format template. But several blocks are not executable — the tone-scoring block is just word lists with comments, 'analyze_13f_changes' references undefined behavior ('signal' may be unassigned, set subtraction on holder objects), the composite 'filing_score' is a commented template, and the EDGAR URL examples are commented out. This matches anchor 4 ('mostly executable guidance; concrete code or commands with minor gaps'), not anchor 5's copy-paste-ready coverage of common cases.

4 / 5

Workflow Clarity

The body is organized by analysis dimension (data access → statement analysis → MD&A → risk factors → 8-K → insider → 13F → composite score → output template), giving an implicit sequence, but there is no explicit ordered workflow and no validation checkpoints (e.g., how to verify a filing was retrieved correctly, how to sanity-check computed ratios, or what to do when EDGAR requests fail/rate-limit). This fits anchor 3 ('sequence present but checkpoints missing or implicit'); score 4 would require 'most checkpoints present'.

3 / 5

Progressive Disclosure

The single SKILL.md runs ~290 lines with everything inlined — per-filing-type deep dives (8-K item tables, insider scoring, 13F tiers) that would sit naturally in one-level-deep reference files. Section headers and tables make it navigable, and no bundle files exist to score against, but the monolithic structure matches anchor 3 ('some structure but could be better organized; content that should be separate is inline') rather than anchor 4, which expects most content appropriately split across files.

3 / 5

Total

14

/

20

Passed

Description

75%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 specific, well-scoped description with concrete actions, strong domain keywords, and minimal conflict risk. Its main weakness is the absence of any explicit 'when to use' trigger guidance, which caps completeness at 3 and leaves the skill relying on users naming filing types directly.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user mentions SEC filings, EDGAR, 10-K/10-Q/8-K, proxy statements, insider transactions, or fundamental analysis of US public companies.'

Include common synonyms users naturally say — 'annual report', 'quarterly earnings', 'insider trading' — alongside the filing-type codes to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ('SEC EDGAR filing analysis') and lists multiple concrete actions: 'Extract key financials, risk factors, management discussion, and generate investment signals from US public company filings.' It enumerates specific filing types (10-K, 10-Q, 8-K, proxy statements, insider Form 4), matching the anchor 'lists multiple specific concrete actions; comprehensive coverage' — not score 4, which requires 'minor gaps in coverage', and the action list here covers extraction, qualitative analysis, and signal generation.

5 / 5

Completeness

The 'what' is clearly and explicitly stated (analyze filings, extract financials/risk factors/MD&A, generate investment signals), but there is no 'Use when...' clause or equivalent explicit trigger guidance. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3, matching anchor 3 ('has a clear what but when is missing or only weakly implied'); it cannot be 4 because that requires both what and when present.

3 / 5

Trigger Term Quality

Strong natural keywords users would say: 'SEC EDGAR', '10-K', '10-Q', '8-K', 'proxy statements', 'Form 4', 'financials', 'risk factors', 'investment signals'. However, common synonyms such as 'annual report', 'quarterly report', 'earnings', or 'insider trading' are missing, which fits anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's 'comprehensive coverage of natural terms including synonyms and file extensions'.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — SEC EDGAR filing analysis for US public companies — and the trigger terms (10-K, 10-Q, 8-K, DEF 14A, Form 4) are filing-type codes that no other plausible skill would claim. This matches anchor 5 ('clear niche with distinct triggers; minimal conflict risk'); score 4 would require acknowledged 'minor overlap risk with closely related skills', which is not the case here.

5 / 5

Total

17

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
HKUDS/Vibe-Trading
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.