agentsclimarketplace

Run3 sec 13f dataset structure

Skill cxcscmu/SkillLearnBench/skills/b3-teacher-feedback-claude-opus-4-6/financial-analysis/run3_sec-13f-dataset-structure

Understanding the structure of SEC 13F filing datasets stored in /root/2025-q2 and /root/2025-q3 folders, including available scripts and data filesFrom its SKILL.md

Install
npx -y skills add cxcscmu/SkillLearnBench --skill run3_sec-13f-dataset-structure

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

2.0 KB, 536 tokens by cl100k_base, as published. Nobody here has run it

SEC 13F Dataset Structure

The datasets are stored in /root/2025-q2 and /root/2025-q3 folders.

Check for Scripts Directory

The dataset likely comes with pre-built Python scripts. Check:

  • /root/2025-q3/scripts/ or /root/2025-q2/scripts/
  • Common scripts: search_fund.py, one_fund_analysis.py, holding_analysis.py, search_stock_cusip.py
# First, explore the directory structure
find /root/2025-q2 -type f | head -40
find /root/2025-q3 -type f | head -40
ls -la /root/2025-q2/scripts/ 2>/dev/null
ls -la /root/2025-q3/scripts/ 2>/dev/null
ls -la /root/2025-q2/*.py 2>/dev/null
ls -la /root/2025-q3/*.py 2>/dev/null

Always check the scripts first and read their source code to understand how they handle data parsing, filtering, and deduplication. These scripts handle edge cases correctly.

Data Files (TSV format)

Key TSV files typically found:

  • COVERPAGE.tsv — Fund cover page info (filing metadata, accession numbers)
  • INFOTABLE.tsv — Holdings data (stocks, CUSIPs, values, shares)
  • SUMMARYPAGE.tsv — Summary info
  • Other supporting files

Key Columns in INFOTABLE.tsv

  • ACCESSION_NUMBER — Links to COVERPAGE
  • NAMEOFISSUER — Company name
  • CUSIP — Stock identifier (9-character)
  • VALUE — Value in thousands of dollars
  • SSHPRNAMT — Number of shares/principal amount
  • SSHPRNAMTTYPE — Type: "SH" for shares, "PRN" for principal
  • PUTCALL — If populated with "PUT" or "CALL", it's an option, not a stock
  • INVESTMENTDISCRETION — Type of discretion

Critical: PUTCALL Column Values

The PUTCALL column may contain unexpected values. Always inspect:

import pandas as pd
info = pd.read_csv('/root/2025-q3/INFOTABLE.tsv', sep='\t')
print(info['PUTCALL'].unique())
print(info['PUTCALL'].value_counts(dropna=False))

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.