复制安装命令
用 Codex 或 Claude 安装复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它先审查 Skill 页面再帮你安装。
复制前请先查看来源、License 和安全提示。
Security audit: baseline 52/52 CLEAN
用 Codex 或 Claude 安装复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它先审查 Skill 页面再帮你安装。
复制前请先查看来源、License 和安全提示。
来源文件:README.md
📌 文档结构(2026-07-22 起): 本文件是中文默认入口 —— banner + badges + 信任面 + 9 阶段流水线速览 + 76 行合集总表。 每个合集的完整描述、按用途分组、精确数字、验证方法在
docs/CONTENT_ZH.md(扩展正文,总表行内的→直接跳转到对应锚点)。English version:
README-en.md· 中文扩展正文:docs/CONTENT_ZH.md·README-zh-CN.md已弃用(重定向占位)
🌐 语言: English | 简体中文(默认) | 繁體中文 | 日本語 | 한국어
|
|
Stanford REAP × CoPaper.AI · 实证研究 AI 工具的学术工业级产品
由斯坦福实证研究方法论团队打造,覆盖从数据清洗到顶刊投稿的完整工作流
🚀 New here? Open the Skill Search → to filter all 1,096 skills by method, stage, language, and license. The 5-minute tour (
make quickstart) prints the same picture in your terminal.🇨🇳 中文用户从本文件开始(流水线速览 + 76 行总表),每个合集的完整描述见
docs/CONTENT_ZH.md。📖 English readers: seeREADME-en.md.
| Rigor lane | Count | Where |
|---|---|---|
| Numeric benchmark tasks — gold values recomputed from real data each run | 17 | benchmark/ |
| Behavioral eval scenarios / rubric items | 37 / 183 | eval-harness/ |
Full trust overview:
docs/TRUST.md·docs/RIGOR_COVERAGE.md
中文内容分两级维护,各司其职:
docs/CONTENT_ZH.md(扩展正文):每个合集的完整描述(#skill-NN 锚点)、按用途分组、精确数字、2 分钟验证、三层信任、旗舰流水线详解、贡献与引用。总表行内的 → 直接跳到对应锚点。README-en.md · README-zh-TW.md · README-ja.md · README-ko.md[!NOTE] 维护规则: 改合集总表 → 本文件与 CONTENT_ZH.md 的锚点表两处同步;改合集详情 / 分组 / 数字 → 只改
docs/CONTENT_ZH.md。统计数字(合集数 / skill 数)以catalog/skills.json为准,由make validate的 readme-stats 检查器守护。贡献者(Contributors): 提交前请在本地跑通完整门禁
make check(catalog 校验 + 链接 + 单元测试 + eval-harness + benchmark)。详见CONTRIBUTING.md。旧版归档:
README-zh-CN.md已弃用,仅作向后兼容的重定向占位。
AERS 不只是 76 个散装 skill —— 它能陪你走完一篇论文。 从模糊 idea → 选题精炼 → 文献综述 → 数据获取 → 识别策略 → 估计建模 → 稳健性审计 → 出版级表格 / 图形 → 写作与同行评审 → 降 AIGC → 投稿。端到端、全自动、每一步都可被人介入(中间任何一步你都可以接过去手工改方法、补变量、加稳健性,再让流水线自动接上跑)。
Paper-WorkFlow 是 AERS 的"指挥棒",它把上面 9 个阶段的 skill 串成 一条按键即运行的端到端流水线。
你在 IDE 入口给它一句自然语言:
"开一个新论文项目:空气污染与中国劳动力市场,CS 设计 + 省级面板"
它会自动按顺序调:
sp.csdid(...) 给出 CS-DID 估计草案 + 写出估计方程与识别假设sp.feols(...) + sp.honest_did(...)任何阶段你都可以手动介入 —— 上一阶段的产物全部落盘(产物-幂等 pipeline),你接过去改方法、补控制、加稳健性,再让流水线自动接下去跑。这就是"全自动 + 可介入"。
| ⭐ Skill | 在流水线里的角色 |
|---|---|
| 00 StatsPAI 🔥 | 因果引擎:900+ 函数,sp.causal(...) 一行跑闭环(DID / RD / IV / SCM / DML / matching) |
| 00.1 Full Empirical · Python 📘 | 显式 Python 栈(pandas / statsmodels / linearmodels / pyfixest) |
| 00.2 Full Empirical · Stata 📊 | 显式 Stata 栈(reghdfe / ivreg2 / csdid / sdid / rdrobust) |
| 00.3 Full Empirical · R 📗 | 显式 R 栈(tidyverse / fixest / did / HonestDiD)+ Quarto 渲染 |
| 48 de-AIGC-skills 🇨🇳🇬🇧 | 中英双语学术降 AIGC(Turnitin AI / GPTZero / 知网 / 万方) |
| 50 AER-skills 📕 | Top-5 经济学投稿套件:识别 → 稳健性 → R&R |
| 69 Paper-WorkFlow 🧭 | 元编排器,把上面 9 个阶段串成一键流水线 |
为什么挑这 7 个?因为它们的行为都被基准钉死了 —— 不是营销口径,是对着已知答案反复跑过验证过的(17 项数值 benchmark + 37 项行为评测 ↗)。
↴ 直跳到下方 76 行总表(每个合集带 #skill-NN 锚点)。如果你更关心"这些 skill 怎么用"而不是"有哪些 skill",看 📘 中文唯一权威正文 里的「按用途分组」与「旗舰流水线」两节。
00 → 72,编号连续无空缺)打开仓库 → 看见整座库。 全部 76 个合集 · 1,096 个 skill,每一个都已 vendor 进本仓库,由
catalog/skills.json跟踪。⭐ = Stanford REAP × CoPaper.AI 团队自研的 skill;其余为精选、经安全审计的社区作品。主题图例 — 🚀 全流程与编排器 · 🎯 因果推断与计量经济学 · 📚 文献与研究设计 · ✍️ 写作 / 编辑 / 去 AIGC · 📑 引用 / 复现 / 同行评审 · 🛠️ 数据 / 工具 / 基础设施
点击【→】 跳转到
docs/CONTENT_ZH.md中该合集的完整描述;点击合集名 直接打开其目录。
| # | 合集 | 一句话 | 详情 |
|---|---|---|---|
| ⭐ 00 | StatsPAI 🔥 | 因果引擎 · Agent-native Python DSL:sp.causal(...) 一行跑闭环(DID/RD/IV/SCM/DML,900+ 函数) | → |
| ⭐ 00.1 | Full Empirical · Python 📘 | 显式栈:pandas · statsmodels · linearmodels · pyfixest | → |
| ⭐ 00.2 | Full Empirical · Stata 📊 | reghdfe · ivreg2 · csdid · sdid · rdrobust 复现包 | → |
| ⭐ 00.3 | Full Empirical · R 📗 | tidyverse · fixest · did · HonestDiD + Quarto 渲染 | → |
| 01 | academic-paper-skills | 大纲 → 手稿写作 + 7 维审稿人模拟 | → |
| 02 | research-skills | 医学影像综述、提案、论文转幻灯片 | → |
| 03 | scientific-skills | 假设生成 + 28 个科学数据库 | → |
| 04 | scientific-writer | 引用管理 + 科学写作 | → |
| 05 | research-superpower | 系统化检索、筛选与引文溯源 | → |
| 06 | stats-paper-writing | 端到端 LaTeX 统计论文写作 | → |
| 07 | AI-Research-SKILLs | 发表级 ML 图表、LaTeX、引文核验 | → |
| 08 | latex-document-skill | 创建 / 编译任意 LaTeX 文档为 PDF | → |
| 09 | awesome-econ-ai | Python 面板数据分析(linearmodels) | → |
| 10 | causal-inference-mixtape | DID / IV / RDD / SCM 模板(Cunningham) | → |
| 11 | compound-science | 面向定量社会科学的贝叶斯估计 | → |
| 12 | claude-code-my-workflow | 提交 → PR → 合并的研究工作流(Emory) | → |
| 13 | MixtapeTools | Cunningham 的因果推断工具集与讲义 | → |
| 14 | research-starter | R 中的 IV / DiD / RDD,含完整诊断 | → |
| 15 | social-science-research | R 或 Python 端到端数据分析 | → |
| 16 | clo-author | 多代理数据分析(R / Stata / Python) | → |
| 17 | DAAF | 安全意识代理框架(32 条 deny rule) | → |
| 18 | stata-accounting | 来自 126 篇 JAR 论文的实测 Stata 范式 | → |
| 19 | vera-economic-intelligence | 经济情报 / 政策研究情报工作流 | → |
| 20 | python-econ-skill | DSGE / HANK 与定量经济计算 | → |
| 21 | AI-research-feedback | 用 AI 同行评审生成结构化反馈 | → |
| 22 | christopherkenny-skills | 面向 Quarto(.qmd)的 APSA 风格检查器 | → |
| 23 | baygent | 带护栏的 PyMC / Arviz 贝叶斯工作流 | → |
| 24 | academic-research-skills | 5 审稿人多视角论文评审 | → |
| 25 | Diverga | 研究问题精炼器(抗模式坍缩) | → |
| 26 | scholar | 统计算法设计与文档 | → |
| 27 | my_claude_skills | 经济学摘要写作指南 | → |
| 28 | paper-replicate-agent | 论文复现代理演示 | → |
| 29 | project20XXy | 可复现手稿 + notebook 项目 | → |
| 30 | zirui-song-claude-skills | Zirui Song 的研究辅助 Claude 技能集 | → |
| 31 | claude-code-skills | Python 面板数据分析 | → |
| 32 | stata-skill | 高性能 Stata C/C++ 插件 | → |
| 33 | claude-scholar | 研究全生命周期:选题 → 综述 → 实验 → 审稿回复 | → |
| 34 | research-companion | 头脑风暴、评估并决策研究方向 | → |
| 35 | academic-writing-skills | 面向投稿场所的工业 AI 文献研究 | → |
| 36 | literature-review-skill | 完整文献综述工作流(中文) | → |
| 37 | IlanStrauss-ai-skills | Ilan Strauss 经济学研究 AI 工作流 | → |
| 38 | academic-proofreader | 学术校对 | → |
| 39 | marginaleffects | 预测、斜率与比较(R / Python) | → |
| 40 | pyfixest | Python 中的快速固定效应估计 | → |
| 41 | sewage-econometrics-check | 10 项复现包审计 | → |
| 42 | ARIS | 自主「research-in-sleep」代理,端到端 | → |
| 43 | research-plugins | 478 个研究插件:数据可视化、领域、基础设施 | → |
| 44 | humanizer_academic | 为医学/学术手稿去 AI 味(23 类模式) | → |
| 45 | deslop | 去除 AI 写作痕迹(5 维评分) | → |
| 46 | stop-slop | 三层 AI 痕迹检测与改写 | → |
| 47 | avoid-ai-writing | 审计 → 改写 → 二次审计 AI 味(留痕) | → |
| ⭐ 48 | de-AIGC-skills 🇨🇳🇬🇧 | 中英双语学术降 AIGC(Turnitin AI / GPTZero / 知网 / 万方) | → |
| 49 | humanize-chinese | 检测并人性化 AI 生成的中文文本 | → |
| ⭐ 50 | AER-skills 📕 | Top-5 经济学投稿套件:识别 → 稳健性 → R&R | → |
| 51 | CausalPy | 贝叶斯准实验(PyMC Labs) | → |
| 52 | slr-prisma | 系统文献综述,PRISMA 2020 | → |
| 53 | thematic-analysis | Braun & Clarke 六阶段定性主题分析 | → |
| 54 | open-science-skills | 引用一致性、DOI 与论据支撑审计 | → |
| 55 | r-skills | R 中用 brms 做贝叶斯推断 | → |
| 56 | econ-writing-skill | 综合 50+ 顶级指南的经济学写作 | → |
| 57 | edgartools | 查询与分析 SEC 文件 | → |
| 58 | econstack | 政策简报(UK GES / AU Treasury) | → |
| 59 | openalex-skill | 通过 OpenAlex 查询 2.4 亿+ 学术作品 | → |
| 60 | superpapers | 综合性实证研究支持套件 | → |
| 61 | research-methods | 与预注册匹配的验证性检验 | → |
| 62 | citation-checker | 对照 CrossRef / S2 / OpenAlex 核验引用 | → |
| 63 | scientific-agent-skills | DoWhy 识别–估计–反驳框架 | → |
| 64 | mcp-stata | 20 个 Stata 因果推断与复现 skill | → |
| 65 | game-theory-paper-writer | 生成并压力测试博弈论论文 | → |
| 66 | empirical-research-skills | 面向大型面板的 R 性能优化 | → |
| 67 | econfin-workflow-toolkit | 中国公司金融实证工作流,从提案到论文 | → |
| 68 | research-productivity-skills | 论文检索、SSRN、DOI 查询、下载 | → |
| ⭐ 69 | Paper-WorkFlow 🧭 | 元编排器,串起整个社会科学论文流水线 | → |
| 70 | ssci-polish ✍️ | SSCI / SCI 英文论文语言润色(语法、可读性、学术语气) | → |
| ⭐ 71 | lit-review-agent-tools 🔍 | 文献综述工具选型 + 一键安装运行(MinerU / PaperQA2 / ASReview / STORM / MCP 服务器) | → |
| ⭐ 72 | Kaggle Research 🧪 | 通过官方 CLI 安全检索 Kaggle 资源、限界下载公开数据并保留审计证据 | → |
想看更详细的描述(主题分类、字段、统计)? 见
docs/CONTENT_ZH.md中标注#skill-NN锚点的同一张表 —— 它是每个合集的完整描述所在的扩展正文。
自 2026-04 首次发布以来的主干里程碑(完整提交记录见 Commits 与 CHANGELOG.md):
---
config:
gitGraph:
rotateCommitLabel: false
---
gitGraph TB:
commit id: "2026-04 首次发布"
branch community
commit id: "2026-05 首个社区 PR"
checkout main
merge community
commit id: "2026-05 更名 AERS"
commit id: "2026-06 插件市场"
commit id: "2026-06 全库路由器"
commit id: "2026-07 首个 tag" tag: "v2026.07"
branch kaggle
commit id: "2026-07 Kaggle 集成"
checkout main
merge kaggle
commit id: "2026-08 de-AIGC 双语"
Star 增长曲线(非提交数)· 由 scripts/build-star-history.py 从 GitHub API 生成并提交入库
如果 AERS 对你的工作有帮助,请引用它(CITATION.cff)并点个 Star,让更多研究者看到。
AI 是放大器,不是替代品。它替你做最耗时的"搬砖",你保留最核心的"判断"。
|
|
Stanford REAP × CoPaper.AI · 实证研究 AI 工具的学术工业级产品
![]() 扫码访问 copaper.ai |
![]() 关注公众号「CoPaper.AI」 |
内置 20 个方法论 skill · 20 分钟完成实证论文 · 自研 StatsPAI(900+ 函数 / MIT 开源)
name: education-data-source-nccs
description: >-
NCCS — Form 990 data for private nonprofit colleges (Portal: IPEDS-matched, 1993-2016). Revenue, expenses, assets, endowment, governance beyond IPEDS. Use when IRS financial depth needed. Portal ends 2016; public institutions excluded (no Form 990).
metadata:
audience: any-agent
domain: data-source
skill-authored: "2026-02-09"
skill-last-updated: "2026-02-09"National Center for Charitable Statistics (NCCS) Form 990 data for private nonprofit colleges and universities (Portal mirror: IPEDS-matched institutions, 1993-2016). Use when IRS-based financial data — revenue, expenses, assets, endowment details — or governance information (board composition, executive compensation) is needed beyond what IPEDS provides. Portal data ends at 2016; for current filings use full NCCS directly. Public institutions do not file Form 990 and are excluded.
The NCCS (National Center for Charitable Statistics) is the principal U.S. repository for empirical data on the nonprofit sector, derived from IRS Form 990 filings. It provides financial depth, governance detail, and historical coverage for private nonprofit colleges and universities that goes well beyond what IPEDS collects.
CRITICAL: Value Encoding
The Education Data Portal encodes ALL categorical variables as integers, not strings. Variable names are lowercase in Portal data. Always verify codes against codebooks.
Context fipsmult_ein_flagPortal integer 6(California)1(Yes)Original NCCS "06"or stringN/A See
./references/variable-definitions.mdfor complete encoding tables.
| File | Purpose | When to Read |
|---|---|---|
nonprofit-data.md | NCCS datasets and what they contain | Understanding available data sources |
form-990.md | IRS Form 990 structure and data elements | Understanding what information is collected |
education-relevance.md | How NCCS relates to higher education | Connecting nonprofit data to education research |
ntee-codes.md | Nonprofit classification system | Finding and filtering educational institutions |
variable-definitions.md | Key financial and organizational variables, codes, special values | Interpreting specific data elements or building queries |
Research need?
├─ Financial data for private colleges → ./references/form-990.md
│ ├─ Revenue breakdown → Part VIII (Statement of Revenue)
│ ├─ Expenses by function → Part IX (Statement of Functional Expenses)
│ ├─ Assets and liabilities → Part X (Balance Sheet)
│ └─ Endowment details → Schedule D
├─ Governance/leadership → ./references/form-990.md
│ ├─ Board members → Part VII (Compensation)
│ ├─ Executive compensation → Part VII, Schedule J
│ └─ Policies and procedures → Part VI (Governance)
├─ Organizational characteristics → ./references/nonprofit-data.md
│ ├─ Basic info (name, address, EIN) → BMF
│ ├─ Tax-exempt type → BMF (SUBSECCD)
│ └─ NTEE classification → BMF (NTEECC)
└─ Identify institutions → ./references/ntee-codes.md
├─ All higher education → NTEE B40-B50
├─ Universities → B40, B41, B42, B43
└─ Community colleges → B44
Dataset selection?
├─ Need universe of all nonprofits?
│ └─ Business Master File (BMF) → ./references/nonprofit-data.md
├─ Need detailed financial variables?
│ ├─ Large organizations (full 990 filers) → Core PC files
│ ├─ All organizations (990 + 990EZ) → Core PZ files
│ └─ Maximum detail (2000+ fields) → Efile database
├─ Need private foundations?
│ └─ Core PF or 990-PF Efile data
└─ Need small grassroots orgs?
└─ 990-N ePostcard database
Linking NCCS to education data?
├─ Need to match to IPEDS?
│ └─ See ./references/education-relevance.md (EIN-UNITID crosswalk)
├─ Need geographic analysis?
│ └─ Use BMF geocoded addresses + Census crosswalks
├─ Want institutional comparisons?
│ └─ Filter by NTEE codes B40-B50 for higher ed
└─ Analyzing trends over time?
└─ Use Core data panel (1989-present)
Portal mirror (via fetch_from_mirrors()):
| Dataset | Description | Coverage | Rows |
|---|---|---|---|
990 Forms (nccs/colleges_nccs_all) | Form 990 data for higher ed institutions matched to IPEDS | 1993-2016, ~2,600 institutions | ~30K |
Full NCCS (direct download, outside Portal):
| Dataset | Description | Coverage | Key Use |
|---|---|---|---|
| Business Master File (BMF) | All active tax-exempt organizations | ~3.8M orgs | Sampling frame, basic info |
| NCCS Core Series | 990/990EZ filer financials | 1989-2022 | Historical financial analysis |
| IRS 990 Efile | Full electronic filings (2000+ fields) | 2012-present | Detailed governance, programs |
| Form 990-N ePostcard | Small nonprofits (<$50K revenue) | 2007-present | Grassroots organizations |
| Pub78 | Organizations eligible for tax-deductible donations | Current | Verify charitable status |
Scope note: The Portal mirror dataset contains NCCS Form 990 data matched to IPEDS institutions only (~2,600 institutions). It does NOT include the full NCCS universe of ~3.8M nonprofits. For non-education nonprofits, NTEE-based filtering, or BMF/Core/Efile data, download directly from NCCS.
Portal dataset:
| ID | Format | Level | Example | Notes |
|---|---|---|---|---|
unitid | Integer | Institution | 110635 | IPEDS institution ID (Portal addition) |
ein | Integer | Organization | 10211484 | Employer Identification Number |
fips | Integer | State | 6 (California) | State FIPS code |
Full NCCS (direct download, outside Portal):
| ID | Format | Level | Example | Notes |
|---|---|---|---|---|
EIN | 9-digit number | Organization | 123456789 | Unique to each nonprofit |
NTEECC | Letter + 2 digits | Classification | B42 (4-year college) | May be imprecise (~25%); NOT in Portal data |
SUBSECCD | 2-digit code | Tax subsection | 03 (501(c)(3) charity) | NOT in Portal data |
FIPS | 5-digit code | Geography | 06037 (LA County) | State + county; Portal uses state-level integer |
| Code | Description |
|---|---|
| B20-B29 | Elementary & Secondary Schools |
| B40 | Higher Education Institutions (General) |
| B41 | Two-Year Colleges |
| B42 | Undergraduate Colleges (4-year) |
| B43 | Universities |
| B50 | Graduate/Professional Schools |
| B60 | Adult/Continuing Education |
| B70 | Libraries |
| B80 | Student Services/Organizations |
| B90 | Educational Services/Schools N.E.C. |
The Portal dataset has 161 columns. Key mappings from original NCCS/990 names to Portal lowercase names:
| Portal Name | Original NCCS/990 | Description |
|---|---|---|
year | FISYR | Academic year (fall semester) — Portal-aligned year (1993-2016) |
fiscal_year | — | IRS fiscal year ending year from 990 filing (1994-2017); typically year + 1 |
unitid | — | IPEDS institution ID (Portal addition) |
ein | EIN | Employer Identification Number |
fips | FIPS | State FIPS code (integer) |
inst_name_nccs | NAME | Organization name from 990 filing |
mult_ein_flag | — | Multiple-EIN indicator (0=No, 1=Yes) |
contributions_total | CONT | Total contributions |
prog_serv_rev | PROGREV | Program service revenue |
revenue_total | TOTREV | Total revenue |
expenses_total | EXPS | Total expenses |
total_assets_eoy | TOTASS | Total assets (end of year) |
net_assets_eoy | NETASS | Net assets (end of year) |
compensation_officers | COMPENS | Officer compensation |
salaries_other | OTHSAL | Other salaries |
Note: The full 161 columns include detailed revenue breakdowns (Part VIII), expense breakdowns (Part IX), and balance sheet items (Part X). Consult the codebook for the complete list. Use
get_codebook_url("nccs/codebook_colleges_nccs_form_990")fromfetch-patterns.mdto download it.
| Code | Meaning | When Used |
|---|---|---|
-1 | Data unavailable | Not collected for this form/year |
-2 | Not applicable | Field doesn't apply to this entity |
-3 | Suppressed | Confidentiality restriction |
null | Not reported | Organization did not report (may have data) |
0 | Zero value | Explicitly reported as zero |
Important: In Portal data,
-1/-2/-3are integer values. However, empirically these codes are rare in the NCCS Portal dataset — most missing data appears asnullrather than negative codes. Only a handful of financial columns (e.g.,sale_sec_gross_net,changes_net_assets_other) contain any-1/-2/-3values. A0means the organization reported zero;nullmeans the organization did not report. These are distinct conditions.
Datasets for NCCS are available via the mirror system. See datasets-reference.md for canonical paths, mirrors.yaml for mirror configuration, and fetch-patterns.md for fetch code patterns.
| Dataset | Type | Years | Path | Codebook |
|---|---|---|---|---|
| 990 Forms | Single | 1993-2016 | nccs/colleges_nccs_all | nccs/codebook_colleges_nccs_form_990 |
Codebooks are .xls files co-located with data in all mirrors. Use get_codebook_url() from fetch-patterns.md to construct download URLs.
Truth Hierarchy: When interpreting variable values, apply this priority:
- Actual data file (what you observe in the parquet/CSV) — this IS the truth
- Live codebook (.xls in mirror) — authoritative documentation, may lag
- This skill documentation — convenient summary, may drift from codebook
If this documentation contradicts the codebook, trust the codebook. If the codebook contradicts observed data, trust the data and investigate.
The Portal dataset is pre-filtered to higher education institutions matched to IPEDS UNITIDs. NTEE codes are NOT included in the Portal data — for NTEE-based filtering, use the full NCCS BMF directly.
import polars as pl
# Filter by year
df_2015 = df.filter(pl.col("year") == 2015)
# Filter by state (integer FIPS codes)
df_ca = df.filter(pl.col("fips") == 6) # California
# Filter out null values from financial columns
df_valid = df.filter(
(pl.col("revenue_total").is_not_null()) &
(pl.col("revenue_total") >= 0) # Excludes rare -1/-2/-3 codes
)
# Replace negative codes with null for analysis (precautionary)
df = df.with_columns(
pl.when(pl.col("revenue_total") < 0)
.then(None)
.otherwise(pl.col("revenue_total"))
.alias("revenue_total_clean")
)
| Pitfall | Issue | Solution |
|---|---|---|
| Using string codes | Portal uses integer FIPS (6), not string ("CA" or "06") | Always use integer comparisons; filter >= 1 to exclude missing codes |
| Filing threshold confusion | Organizations under $200K revenue may file 990-EZ with fewer variables | Check form type; use Core PZ files for combined 990/990-EZ coverage |
| Fiscal year variation | Nonprofits have different fiscal year ends (June 30 common for colleges) | year = Portal academic year (fall semester); fiscal_year = IRS fiscal year end (typically year + 1). Filter on year for IPEDS joins. |
| No NTEE in Portal data | Portal dataset does not include NTEE codes; pre-filtered to higher ed institutions | Cannot filter by NTEE code; use full NCCS BMF for NTEE-based filtering |
| NTEE classification accuracy | ~25% of NTEE codes estimated to be imprecise | Use NCCS-corrected codes (NTEE_NCCS) over IRS-assigned codes when available |
| Consolidated filings | Some university systems file consolidated 990s covering multiple campuses | Check mult_ein_flag; one EIN may represent multiple institutions |
| Form version changes | Form 990 was redesigned in 2008; variable definitions changed | Be cautious comparing pre-2008 and post-2008 data for governance variables |
| Missing vs. zero | 0 means explicitly reported zero; null means not reported | Distinguish between zero-value and not-reported before aggregating |
| Aspect | NCCS (Form 990) | IPEDS |
|---|---|---|
| Coverage | All 501(c)(3) nonprofits | Title IV institutions only |
| Reporting Basis | IRS fiscal year | IPEDS survey cycles |
| Financial Framework | Nonprofit accounting (GAAP) | Education-specific categories |
| Governance | Detailed board/compensation data | Limited HR data |
| Programs | Mission statements, activities | Degree programs, enrollment |
| Identifier | EIN | UNITID |
| Update Frequency | Annual (with lag) | Annual |
Fetch data via fetch_from_mirrors("nccs/colleges_nccs_all")
unitid for IPEDS joiningFilter and clean
Link to IPEDS using unitid and year columns
Analyze — See variable definitions for meaning and limitations
Identify target organizations
Select appropriate dataset
Extract and clean data
Analyze — See variable definitions for meaning and limitations
| Source | Relationship | When to Use |
|---|---|---|
education-data-source-ipeds | Complementary institution data | Join on EIN-UNITID crosswalk for enrollment, degrees, and education-specific financials |
education-data-explorer | Parent discovery skill | Finding available endpoints |
education-data-query | Data fetching | Downloading parquet/CSV files |
| Topic | Reference File |
|---|---|
| BMF overview | ./references/nonprofit-data.md |
| Core data series | ./references/nonprofit-data.md |
| Efile database | ./references/nonprofit-data.md |
| Form 990 structure | ./references/form-990.md |
| Revenue variables | ./references/form-990.md |
| Expense variables | ./references/form-990.md |
| Balance sheet | ./references/form-990.md |
| Governance data | ./references/form-990.md |
| Schedule details | ./references/form-990.md |
| Linking to IPEDS | ./references/education-relevance.md |
| Private college identification | ./references/education-relevance.md |
| Supplementing education research | ./references/education-relevance.md |
| NTEE code structure | ./references/ntee-codes.md |
| Education NTEE codes | ./references/ntee-codes.md |
| NTEEV2 format | ./references/ntee-codes.md |
| Financial variables | ./references/variable-definitions.md |
| Variable naming conventions | ./references/variable-definitions.md |
| Data quality issues | ./references/variable-definitions.md |
评论 (0)
暂无评论,成为第一个评论者吧!