Agent skill

Sec Data

SEC EDGAR financial data: secfi library + structured JSON income statements, balance sheets, cash flow from XBRL facts.

MITAuto-check passedBusiness, Finance & HR

Install Sec Data

skills CLI

$ npx skills add gauss314/skills --skill sec-data -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install gauss314/skills sec-data --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/gauss314/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sec-data .claude/skills/sec-data && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "sec-data" agent skill from https://github.com/gauss314/skills/tree/main/skills/sec-data into .claude/skills/sec-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-data", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/gauss314/skills/tree/main/skills/sec-data

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add gauss314/skills --skill sec-data -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install gauss314/skills sec-data --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gauss314/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/sec-data .agents/skills/sec-data && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "sec-data" agent skill from https://github.com/gauss314/skills/tree/main/skills/sec-data into .agents/skills/sec-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-data", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add gauss314/skills --skill sec-data -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install gauss314/skills sec-data --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gauss314/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/sec-data .cursor/skills/sec-data && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "sec-data" agent skill from https://github.com/gauss314/skills/tree/main/skills/sec-data into .cursor/skills/sec-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-data", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/gauss314/skills.git --path skills/sec-data

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add gauss314/skills --skill sec-data -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install gauss314/skills sec-data --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gauss314/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/sec-data .gemini/skills/sec-data && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "sec-data" agent skill from https://github.com/gauss314/skills/tree/main/skills/sec-data into .gemini/skills/sec-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-data", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install gauss314/skills sec-data

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add gauss314/skills --skill sec-data -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/gauss314/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/sec-data .github/skills/sec-data && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "sec-data" agent skill from https://github.com/gauss314/skills/tree/main/skills/sec-data into .github/skills/sec-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-data", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add gauss314/skills --skill sec-data -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install gauss314/skills sec-data --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gauss314/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/sec-data .opencode/skills/sec-data && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "sec-data" agent skill from https://github.com/gauss314/skills/tree/main/skills/sec-data into .opencode/skills/sec-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-data", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: sec-data
GitHub stars: 245
Token cost: ~1.4k tokens
SKILL.md length: 376 words
Files: 3 (incl. scripts, references)
Skills in repo: 32
Repo updated: Jun 14, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

SEC EDGAR financial data: secfi library + structured JSON income statements, balance sheets, cash flow from XBRL facts.

Works in 3 steps: secfi.getCiks() → obtiene el CIK del… → Fetch companyfacts/CIK{cik}.json →… → El script mapea automáticamente…
Tasks that involve Financial analysis
SKILL.md covers Dependencia, Cómo funciona, Autenticación and Script principal:…, plus 4 more sections
Runs Python scripts from its folder; calls python and pip; reaches data.sec.gov

What it does

Sec Data is an agent skill from gauss314/skills. SEC EDGAR financial data: secfi library + structured JSON income statements, balance sheets, cash flow from XBRL facts.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and reference files (for example `references/FINANCIALS_REFERENCE.md` and `scripts/fetch_financials.py`).

It sits in Business, Finance & HR, covering Financial analysis. It works with SEC EDGAR. The repository describes itself as: Financial market data consumption skills for claude code and AI agents. The licence is MIT.

When your agent uses it

Tasks that involve Financial analysis

Example prompts

“/sec-data”

Requirements

Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

secfi.getCiks() → obtiene el CIK del ticker
Fetch companyfacts/CIK{cik}.json → obtiene todos los datos financieros estructurados
El script mapea automáticamente conceptos US-GAAP ↔ IFRS según la taxonomía

What it can do on your machine

Read from SKILL.md and the folder at commit 5156f81. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
- python
- pip
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- data.sec.gov
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sec Data loads about 1.4k tokens when it runs, and up to ~9k if it reads all its reference files. Until then it costs about 32 tokens; SKILL.md has 376 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~32
When it runs · the whole SKILL.md, loaded when a task matches: ~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from gauss314/skills at commit 5156f81, republished under its MIT licence (© gauss314). 376 words, ~1,423 tokens.

Download SKILL.mdSave it as .claude/skills/sec-data/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.

name: sec-data
description: SEC EDGAR financial data: secfi library + structured JSON income statements, balance sheets, cash flow from XBRL facts.
license: MIT

SEC Data — Financial Statements from SEC EDGAR

Acceso a datos financieros estructurados de la SEC EDGAR mediante la librería secfi + la API JSON de XBRL facts de la SEC.

Obtiene income statements, balance sheets, cash flow statements en formato JSON/CSV estructurado directamente de los filings XBRL.

Soporta US-GAAP (empresas US) e IFRS (empresas extranjeras) con mapping automático de conceptos.

Dependencia

bash

pip install secfi

Requiere pandas y requests (vienen con secfi).

Cómo funciona

La SEC expone datos financieros estructurados via dos endpoints JSON:

Endpoint	Descripción
Company Facts	`https://data.sec.gov/api/xbrl/companyfacts/CIK{CIK}.json` — Todos los datos XBRL
Company Concept	`https://data.sec.gov/api/xbrl/companyconcept/CIK{CIK}/us-gaap/{concept}.json` — Histórico de un concepto

El flujo típico:

secfi.getCiks() → obtiene el CIK del ticker
Fetch companyfacts/CIK{cik}.json → obtiene todos los datos financieros estructurados
El script mapea automáticamente conceptos US-GAAP ↔ IFRS según la taxonomía

Taxonomías soportadas

Taxonomía	Empresas	Formularios	Ejemplos
`us-gaap`	Empresas US	10-K, 10-Q	AAPL, MSFT, NVDA
`ifrs-full`	Empresas extranjeras (Foreign Private Issuers)	20-F, 6-K	GGAL, BABA, SAP, SPOT

El script detecta automáticamente la taxonomía y resuelve los conceptos usando un mapping US-GAAP ↔ IFRS.

Autenticación

python

HEADERS = {"User-Agent": "osojuanferpity@xmail.com"}

La SEC bloquea requests sin User-Agent válido (403 Forbidden). Usar el mismo email que secfi usa internamente.

Script principal: `fetch_financials.py`

bash

# AAPL (US-GAAP) — todo
python scripts/fetch_financials.py --ticker AAPL --all

# GGAL (IFRS) — todo
python scripts/fetch_financials.py --ticker GGAL --all

# Solo income statement
python scripts/fetch_financials.py --ticker MSFT --income

# Solo balance + cash flow
python scripts/fetch_financials.py --ticker NVDA --balance --cashflow

# Todos los conceptos disponibles (no solo core)
python scripts/fetch_financials.py --ticker AAPL --all --all-concepts

# Output personalizado
python scripts/fetch_financials.py --ticker AAPL --all --output data/aapl

# Solo anual (default)
python scripts/fetch_financials.py --ticker AAPL --all

# Incluir trimestral también
python scripts/fetch_financials.py --ticker AAPL --all --quarterly

Flags disponibles

Flag	Descripción
`--ticker`, `-t`	Ticker a consultar (requerido)
`--all`	Fetch de income + balance + cashflow
`--income`	Solo income statement
`--balance`	Solo balance sheet
`--cashflow`	Solo cash flow statement
`--all-concepts`	Todos los conceptos disponibles en la taxonomía (default: solo core)
`--annual`	Solo datos anuales (default)
`--quarterly`	Incluir datos trimestrales
`--output`, `-o`	Prefijo de archivos de salida
`--quiet`, `-q`	Sin salida detallada

Show full SKILL.md (128 more words)Show less

Output generado

{ticker}_financials.json          → JSON completo con todos los conceptos
{ticker}_financials.csv           → CSV tabular aplanado (concepto x entry)
{ticker}_financials_income_annual.csv  → Matriz concepto x año (income)
{ticker}_financials_balance_annual.csv → Matriz concepto x año (balance)
{ticker}_financials_cashflow_annual.csv → Matriz concepto x año (cash flow)

Mapping IFRS automático

El script incluye un diccionario IFRS_MAP con 33+ conceptos US-GAAP mapeados a sus equivalentes IFRS. Por ejemplo:

US-GAAP	IFRS (ifrs-full)
`Revenues`	`RevenueAndOperatingIncome`
`OperatingIncomeLoss`	`ProfitLossFromOperatingActivities`
`NetIncomeLoss`	`ProfitLoss`
`StockholdersEquity`	`Equity`
`NetCashProvidedByUsedInOperatingActivities`	`CashFlowsFromUsedInOperatingActivities`

Free Cash Flow (FCF)

El script calcula automáticamente el FCF:

FCF = Operating CF - CAPEX

Tanto para US-GAAP como IFRS.

Testeado con

AAPL (US-GAAP) — 55 conceptos extraídos ✅

>> Company facts: 4053 KB
>> Income: 13 conceptos x 17 años
>> Balance: 24 conceptos x 17 años
>> Cash flow: 18 conceptos x 17 años
>> FCF 2025: $98.7B

GGAL (IFRS) — 40 conceptos extraídos ✅

>> Company facts: 724 KB
>> Revenue: $7.72B (2024) · Net Income: $1.76B (2024)
>> Balance: Assets $35.3B · Equity $6.58B
>> Cash flow: Operating $3.80B · FCF $3.57B

Rate Limits

Límite	Comportamiento
~10 req/s	Límite SEC
Sin API key	Público, requiere User-Agent con email
Datos históricos	No cambian — cachear respuestas

Errores comunes

Error	Causa	Solución
`403 Forbidden`	User-Agent inválido	Usar `osojuanferpity@xmail.com`
`404 Not Found`	CIK incorrecto	Verificar con `secfi.getCiks()`
`Ticker not found`	No está en SEC	Solo empresas que reportan a SEC
`KeyError: us-gaap`	Usa IFRS	El script lo resuelve automáticamente

Estructura del skill

skills/sec-data/
├── SKILL.md                           # Este archivo
├── references/
│   └── FINANCIALS_REFERENCE.md        # Referencia completa: todos los conceptos + mapping IFRS
└── scripts/
    └── fetch_financials.py            # Script principal con mapping IFRS automático

Files

SKILL.md and 2 other files (scripts, references) in skills/sec-data of gauss314/skills.

SKILL.md
references/FINANCIALS_REFERENCE.md
scripts/fetch_financials.py

Open the folder on GitHubat commit 5156f81

Compare with similar skills

Sec Data next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sec Data compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Sec Data this skillgauss314/skills	245	—	~1.4k	Automated safety check: Pass	MIT	3 mo ago
Edgartoolsagent-skills-hub/agent-skills-hub	111	2 repos	~1.4k	Automated safety check: Pass	MIT	5 days ago
Sec Filing PullerOneWave-AI/claude-skills	322	—	~2.1k	Automated safety check: Pass	MIT	5 days ago
Datapack Builderw95/awesome-claude-corporate-skills	235	1 repos	~6k	Automated safety check: Pass	MIT	7 mo ago
Fmp APImajiayu000/claude-skill-registry	666	1 repos	~3.3k	Automated safety check: Notes	MIT	today
Dextermajiayu000/claude-skill-registry	666	1 repos	~2.4k	Automated safety check: Notes	MIT	today

Similar skills

Edgartools
agent-skills-hub/agent-skills-hub
Python library for accessing, analyzing, and extracting data from SEC EDGAR filings.
111 GitHub starsUsed in 2 repos~1.4k tokens
Business, Finance & HRAuto-check passed
Sec Filing Puller
OneWave-AI/claude-skills
Pulls financial statement numbers for US public companies straight from SEC EDGAR's free official XBRL APIs (companyfacts, companyconcept, frames, submissions) into a cited table.
322 GitHub stars~2.1k tokensUpdated 5 days ago
Business, Finance & HRAuto-check passed
Datapack Builder
w95/awesome-claude-corporate-skills
Build professional financial services data packs from various sources including CIMs, offering memorandums, SEC filings, web search, or MCP servers.
235 GitHub starsUsed in 1 repo~6k tokens
Business, Finance & HRAuto-check passed
Fmp API
majiayu000/claude-skill-registry
Financial Modeling Prep API for stocks, fundamentals, SEC filings, institutional holdings (13F), and congressional trading.
666 GitHub starsUsed in 1 repo~3.3k tokens
Business, Finance & HRAuto-check: notes
Dexter
majiayu000/claude-skill-registry
Autonomous financial research agent for stock analysis, financial statements, metrics, prices, SEC filings, and crypto data.
666 GitHub starsUsed in 1 repo~2.4k tokens
Business, Finance & HRAuto-check: notes
Financial Research
firecrawl/web-agent
Pulls a public company's latest 10-K or 10-Q figures and analyst consensus from SEC EDGAR and Yahoo Finance, then cross-checks the two sources.
1.2k GitHub stars~1.1k tokensUpdated 5 mo ago
Business, Finance & HRAuto-check passed

Questions about Sec Data

What does Sec Data do?

SEC EDGAR financial data: secfi library + structured JSON income statements, balance sheets, cash flow from XBRL facts. Sec Data is an agent skill from gauss314/skills. SEC EDGAR financial data: secfi library + structured JSON income statements, balance sheets, cash flow from XBRL facts.

When should I use Sec Data?

Sec Data fits situations like: tasks that involve Financial analysis.

How do I install Sec Data in Claude Code?

Run `npx skills add gauss314/skills --skill sec-data -a claude-code`. Or copy the skill folder (skills/sec-data in gauss314/skills) into .claude/skills/sec-data in your project. Claude Code loads it when a task matches its description.

How do I install Sec Data in Codex?

Run `npx skills add gauss314/skills --skill sec-data -a codex`. Or copy the skill folder (skills/sec-data in gauss314/skills) into .agents/skills/sec-data in your project. Codex loads it when a task matches its description.

Can I use Sec Data in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gauss314/skills --skill sec-data -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sec-data, .gemini/skills/sec-data, .github/skills/sec-data and .opencode/skills/sec-data in your project.

What does Sec Data need to run?

Going by SKILL.md and its folder, Sec Data needs Python for the scripts in its folder and the command-line tools its instructions call (python and pip). Our summary lists: Python 3.

Does Sec Data access the network?

SKILL.md names 1 domain. In commands or code: data.sec.gov; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Sec Data safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Sec Data use?

Sec Data is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sec Data use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.6k tokens, read only when the agent opens those files.

What are the alternatives to Sec Data?

Skills that share tags, products or a category with Sec Data: Edgartools (agent-skills-hub/agent-skills-hub, 111 stars), Sec Filing Puller (OneWave-AI/claude-skills, 322 stars), Datapack Builder (w95/awesome-claude-corporate-skills, 235 stars) and Fmp API (majiayu000/claude-skill-registry, 666 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sec Data?

gauss314 (a GitHub user) maintains it in gauss314/skills, which has 245 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on June 14, 2026.

Source: gauss314/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Sec Data

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

SEC Data — Financial Statements from SEC EDGAR

Dependencia

Cómo funciona

Taxonomías soportadas

Autenticación

Script principal: fetch_financials.py

Flags disponibles

Output generado

Mapping IFRS automático

Free Cash Flow (FCF)

Testeado con

AAPL (US-GAAP) — 55 conceptos extraídos ✅

GGAL (IFRS) — 40 conceptos extraídos ✅

Rate Limits

Errores comunes

Estructura del skill

Files

Compare with similar skills

Similar skills

More from gauss314/skills

Related

Questions about Sec Data

Script principal: `fetch_financials.py`