CtrlK
BlogDocsLog inGet started
Tessl Logo

sec-edgar

U.S. SEC EDGAR fetch interface — resolve a ticker to its CIK, list recent filings (10-K / 10-Q / 8-K and friends) with primary-document URLs, and pull XBRL companyfacts financial series. Free, no API key; rate-limited by IP so every request is throttled and carries a contact User-Agent. United States only.

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

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 well-built overview body: copy-paste-ready examples, tight parameter semantics, and a properly split reference bundle one level deep with accurate per-file descriptions. The main improvement opportunities are trimming the infrastructural meta-commentary and adding a short error-recovery loop for failed lookups.

DimensionReasoningScore

Conciseness

The body is efficient — quick-start examples, terse parameter notes, no explaining of concepts Claude already knows — but a few passages could be trimmed, notably the four-line 'Link convention' blockquote about path resolution mechanics and the routing rules for non-U.S. markets. Fits 'efficient; minor instances of over-explanation that could be trimmed', not level 5 where every token earns its place.

4 / 5

Actionability

Fully executable guidance: copy-paste JSON tool-call examples with realistic parameter values, an importable Python snippet showing actual return values in comments, and a pointer to a runnable end-to-end script (verified to exist). The parameter notes give concrete formats like the zero-padded CIK ('320193' → "0000320193") and exact case-sensitive us-gaap concept names, covering the common cases completely.

5 / 5

Workflow Clarity

The sequence ticker → CIK → filing index → XBRL metric is clear across two well-differentiated paths (tool vs. client), with error behavior documented ('an unlisted ticker returns an error envelope (tool) or None (cik_for)'). Not level 5: there is no explicit validate-and-retry checkpoint — e.g. guidance on handling a failed ticker resolution or empty filing result — though as a read-only fetch skill it needs less error scaffolding than a destructive workflow.

4 / 5

Progressive Disclosure

A clean ~70-line overview that keeps only quick-start and parameter essentials inline, with four clearly-labeled one-level-deep references (all verified present: sec_edgar_client.md, get_sec_filings_tool.md, endpoints_and_limits.md, forms_and_concepts.md) and one runnable script, each annotated with what it contains. The one nit — Quick Start cites 'sec-edgar/references/get_sec_filings_tool.md' with a skill prefix while the Reference Docs section uses the 'references/...' form — is cosmetic and doesn't impair navigation.

5 / 5

Total

18

/

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 highly specific, well-differentiated description that names the full capability surface with excellent trigger vocabulary. Its one real weakness is the absence of an explicit 'when to use' clause, which caps completeness and slightly weakens triggerability for users who describe their goal rather than the data source.

Suggestions

Add an explicit trigger clause, e.g. 'Use when fetching SEC filings, XBRL financial data, or ticker-to-CIK lookups for U.S.-listed companies.'

Include natural synonyms users say for these documents — 'annual report', 'quarterly report', 'financial statements', 'earnings' — alongside the form-type codes.

Optionally name the two access paths (agent tool vs. Python client) so the description distinguishes this fetch skill from the 'edgar-sec-filings' methodology skill it references.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with comprehensive coverage: 'resolve a ticker to its CIK, list recent filings (10-K / 10-Q / 8-K and friends) with primary-document URLs, and pull XBRL companyfacts financial series.' Every capability of the fetch interface is named, matching the level-5 anchor rather than the 'several specific actions; minor gaps' of level 4.

5 / 5

Completeness

The 'what' is clear and detailed, but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. Not level 4: that anchor requires an explicit, if imperfect, 'when' statement.

3 / 5

Trigger Term Quality

Strong natural keywords — 'SEC EDGAR', 'ticker', 'filings', '10-K / 10-Q / 8-K', 'XBRL', 'financial series' — that users would actually say, but a few natural synonyms are missing ('annual report', 'quarterly report', 'financial statements', 'insider trades'). Fits the 'good keyword coverage; a few natural terms missing' anchor, not level 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche ('U.S. SEC EDGAR fetch interface... United States only') with distinct, domain-specific triggers unlikely to fire for other skills. Not level 4: there is no meaningful overlap — even adjacent capabilities (rate limiting, no API key) are unique to this skill.

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.