CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

73%

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 knowledge-rich, largely actionable reference with genuine domain expertise (filing item codes, signal rules, data lags) and a clear output contract. Weaker on process structure: no explicit end-to-end workflow and no progressive disclosure — everything lives in one long inline file.

Suggestions

Add an explicit numbered workflow (e.g., 1) fetch latest filings via EDGAR/yfinance, 2) run financial deep dive, 3) diff risk factors vs prior filing, 4) score the six composite dimensions, 5) render the output template) so the implied sequence becomes executable.

Move the 8-K item catalog, insider pattern table, 13F tier lists, and composite scoring rubric into references/ files (e.g., references/signal-rules.md) and keep SKILL.md as a concise overview with clearly signaled links.

Fix incomplete code: give analyze_13f_changes an explicit neutral default return for signal, and turn the tone word lists into an actual counting/scoring snippet like score_insider_activity.

DimensionReasoningScore

Conciseness

The body is dense with domain-specific value Claude does not reliably know (8-K item codes, 13F 45-day lag, 10b5-1 signal weighting, insider cluster thresholds), with only minor over-explanation such as "The MD&A section is the most qualitative and forward-looking part of the filing" and parentheticals like "liquidity health".

4 / 5

Actionability

Mostly executable guidance: concrete yfinance accessor code, a runnable score_insider_activity function, explicit 8-K item signal rules, and a complete output format template. Gaps keep it below 5: analyze_13f_changes can return an unbound signal variable, the tone-scoring block is word lists with no counting logic, and EDGAR URLs appear only as comments.

4 / 5

Workflow Clarity

Framework sections imply an end-to-end flow (financials → MD&A → risk factors → 8-K → insider → 13F → composite → output), but the sequence is never made explicit and checkpoints like "compare vs prior filing" are only implicit. Read-only analysis, so the destructive/batch validation cap does not apply.

3 / 5

Progressive Disclosure

A single 294-line file with well-organized headers but no bundle files or references; reference-style catalogs (8-K item table, insider pattern table, 13F tier lists, composite scoring template) that belong in references/ files are all inlined. The under-50-line simple-skill exception does not apply at this length.

3 / 5

Total

14

/

20

Passed

Description

70%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-targeted description with strong natural trigger terms and a distinct niche. Its main weakness is the missing explicit "Use when..." trigger clause, which caps completeness, plus slightly incomplete action coverage relative to the skill body.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks about SEC filings, 10-K/10-Q reports, 8-K events, insider transactions, or wants fundamental analysis of a US public company."

Mention 13F institutional holdings and SC 13D/G activist stakes in the description since they are covered capabilities, broadening both completeness and trigger coverage.

DimensionReasoningScore

Specificity

"Extract key financials, risk factors, management discussion, and generate investment signals" lists several concrete actions, but coverage has minor gaps — 13F/13D/G holdings analysis and insider-transaction analysis appear in the body yet not in the description.

4 / 5

Completeness

The "what" is clear (extract financials, risk factors, MD&A; generate investment signals), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guideline.

3 / 5

Trigger Term Quality

Strong natural terms ("SEC EDGAR", "10-K, 10-Q, 8-K", "proxy statements", "insider Form 4", "US public company filings") that users would actually say; a few common variations like "annual report", "quarterly earnings", or "insider trading" are missing.

4 / 5

Distinctiveness Conflict Risk

"SEC EDGAR filing analysis" with filing-specific triggers (10-K, 10-Q, 8-K, DEF 14A, Form 4) carves out a clear niche with minimal conflict risk against generic financial-analysis skills.

5 / 5

Total

16

/

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

Path

agent/src/skills/edgar-sec-filings/SKILL.md

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.