edgartools

Python library for accessing, analyzing, and extracting data from SEC EDGAR filings. Use when working with SEC filings, financial statements (income statement, balance sheet, cash flow), XBRL financial data, insider trading (Form 4), institutional holdings (13F), company financials, annual/quarterly reports (10-K, 10-Q), proxy statements (DEF 14A), 8-K current events, company screening by ticker/CIK/industry, multi-period financial analysis, or any SEC regulatory filings.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

93%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-structured, token-efficient overview that leads with executable code, surfaces key pitfalls, and cleanly delegates depth to seven real reference files. It avoids over-explaining concepts Claude already knows and provides copy-paste-ready guidance for the common workflow.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence: it jumps straight into authentication, installation, and executable code blocks with no preamble explaining what SEC EDGAR is or how Python libraries work; every section earns its tokens.	5 / 5
Actionability	Provides fully executable, copy-paste-ready code covering the common cases (Company lookup, get_filings, obj(), financials, xbrl, content access) plus concrete property examples and a Form→Object mapping table; minimal ambiguity.	5 / 5
Workflow Clarity	Core Workflow is clearly sequenced (find company → get filings → extract structured data → access content) and the Common Pitfalls section acts as an implicit error-avoidance checkpoint, but there are no explicit validation/retry feedback loops; this is acceptable since the operations are read-only queries rather than destructive or batch writes.	4 / 5
Progressive Disclosure	SKILL.md is a concise overview with a dedicated Reference Files section pointing one level deep to seven real, clearly-signaled reference files (companies.md, filings.md, financial-data.md, xbrl.md, data-objects.md, entity-facts.md, ai-integration.md), each with a one-line description; content is appropriately split and easy to navigate.	5 / 5
	Total	19 / 20 Passed

Description

95%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 strong description that clearly states the library's purpose and gives concrete, comprehensive trigger guidance using natural user terminology and specific SEC form types. Third-person voice is maintained throughout and it avoids vague fluff or over-claims.

Dimension	Reasoning	Score
Specificity	Description lists concrete actions like 'accessing, analyzing, and extracting data from SEC EDGAR filings' and enumerates specific filings/objects (10-K, 10-Q, Form 4, 13F, DEF 14A, XBRL), covering multiple concrete actions with minor gaps in the full breadth of library capabilities.	4 / 5
Completeness	Explicitly answers 'what' ('accessing, analyzing, and extracting data from SEC EDGAR filings') and 'when' with a concrete 'Use when working with...' clause listing specific trigger conditions, hitting the top anchor for both what and when.	5 / 5
Trigger Term Quality	Comprehensive natural trigger coverage including synonyms and concrete file/form types: 'SEC filings', 'financial statements', 'income statement, balance sheet, cash flow', '10-K, 10-Q', 'Form 4', '13F', 'DEF 14A', '8-K', 'ticker/CIK/industry', matching how users naturally phrase EDGAR requests.	5 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (SEC EDGAR regulatory filings and financial-statement data) with distinct triggers unlikely to fire for unrelated skills; minimal conflict risk given the specialized domain and form-specific terminology.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning

	Total	15 / 16 Passed

Repository: foryourhealth111-pixel/Vibe-Skills
Path: bundled/skills/edgartools/SKILL.md
Commit: d5ae560

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.