Agent skill

Finman Empirical Design

by brycewang-stanford in brycewang-stanford/Awesome-Journal-Skills

A skill your agent uses when the sample construction, variable measurement, panel structure, or inference of a Financial Management (FM) manuscript is fragile — before identification can be trusted…

MITAuto-check passedResearch & Science

Install Finman Empirical Design

skills CLI
$ npx skills add brycewang-stanford/Awesome-Journal-Skills --skill finman-empirical-design -a claude-code

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

GitHub CLI
$ gh skill install brycewang-stanford/Awesome-Journal-Skills finman-empirical-design --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/brycewang-stanford/Awesome-Journal-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Financial-Management-Skills/skills/finman-empirical-design .claude/skills/finman-empirical-design && 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/

Facts

Skill name
finman-empirical-design
GitHub stars
1.2k
Token cost
~2.2k tokens
SKILL.md length
1,047 words
Files
1
Skills in repo
2,387
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the sample construction, variable measurement, panel structure, or inference of a Financial Management (FM) manuscript is fragile — before identification can be trusted…

  • Works in 5 steps: Build the attrition table. Start from… → Pin every key variable to a source field… → Defend point-in-time discipline. For… → …
  • The sample construction
  • SKILL.md covers When to trigger, The FM empirical-design bar, The data-layer audit and Hardening sequence, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Finman Empirical Design is an agent skill from brycewang-stanford/Awesome-Journal-Skills. Use when the sample construction, variable measurement, panel structure, or inference of a Financial Management (FM) manuscript is fragile — before identification can be trusted or exhibits finalized. Hardens the data layer; it does not establish the causal claim (finman-identification) or run robustness (finman-robustness).

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science. The repository describes itself as: Journal-specific Claude Code/Codex skill packs covering mainstream journals — AER, QJE, Nature, Cell, 管理世界, 经济研究 & 200+ more — your fast track to getting published. | 覆盖主流期刊的… The licence is MIT.

When your agent uses it

  • The sample construction
  • Variable measurement
  • Panel structure
  • Inference of a Financial Management (FM) manuscript is fragile — before identification can be trusted

Example prompts

  • “/finman-empirical-design”

Workflow steps

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

  1. Build the attrition table. Start from the raw universe and report the count dropped at each screen; this single exhibit answers most…
  2. Pin every key variable to a source field and a definition. State winsorization (typically 1%/99%) and why; if a variable has competing…
  3. Defend point-in-time discipline. For accounting variables, use data as it would have been known; for returns, avoid look-ahead in signal…
  4. Justify the clustering. Cluster at the level where the shocks are correlated (firm, industry, state); use two-way (firm and time) when…
  5. Report power/economic scale. State N, the dependent-variable mean, and the standard-deviation-scaled effect so a reader sees the magnitude…

What it can do on your machine

Read from SKILL.md and the folder at commit 932eb23. 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

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

Finman Empirical Design loads about 2.2k tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 1,047 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~88
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from brycewang-stanford/Awesome-Journal-Skills at commit 932eb23, republished under its MIT licence (© brycewang-stanford). 1,047 words, ~2,206 tokens.

Download SKILL.mdSave it as .claude/skills/finman-empirical-design/SKILL.md (or your agent's skills folder).
name
finman-empirical-design
description
Use when the sample construction, variable measurement, panel structure, or inference of a Financial Management (FM) manuscript is fragile — before identification can be trusted or exhibits finalized. Hardens the data layer; it does not establish the causal claim (finman-identification) or run robustness (finman-robustness).

Empirical Design (finman-empirical-design)

When to trigger

  • The sample comes from CRSP / Compustat / a vendor feed and the screens and survivorship choices are not documented
  • A key variable (leverage, payout, governance index, a return measure) has several definitions and you picked one without justification
  • The panel mixes frequencies, has look-ahead bias, or merges datasets on a fragile key
  • Standard errors are reported but the clustering and cross-sectional/time dependence are not justified

The FM empirical-design bar

FM publishes empirical finance across corporate, asset-pricing, and banking data, so the design layer is judged on whether a competent referee could reconstruct your sample and trust your measures. The journal's "less weight on trivial robustness" stance is a double-edged sword: it means you should not bury the paper in redundant checks, but it raises the premium on getting the primary design right the first time — the screens, the variable definitions, the merge, and the inference. FM referees in corporate finance are especially alert to silent sample screens, point-in-time vs. restated accounting data, and clustering that ignores the panel's dependence structure.

The data-layer audit

LayerWhat FM referees checkCommon failure
Sample frameuniverse, date range, every screen stated with counts dropped"standard filters" with no attrition table
Survivorship / look-aheaddelisted firms retained; accounting data point-in-timeusing restated Compustat as if known contemporaneously
Variable constructioneach key variable defined, winsorization level stated, source field nameda leverage measure that silently switches book/market
Merge integrityjoin keys, match rate, unmatched-firm biasCRSP-Compustat merge with an unreported low match rate
Panel structurefrequency, balanced vs. unbalanced, entry/exit handlingmixing annual and quarterly without stating it
Inferenceclustering level justified by the dependence; few-cluster / two-way addressedwhite SEs on a firm-year panel with serial correlation

Hardening sequence

  1. Build the attrition table. Start from the raw universe and report the count dropped at each screen; this single exhibit answers most sample-construction doubts.
  2. Pin every key variable to a source field and a definition. State winsorization (typically 1%/99%) and why; if a variable has competing definitions, justify yours and note the alternative goes to the appendix.
  3. Defend point-in-time discipline. For accounting variables, use data as it would have been known; for returns, avoid look-ahead in signal construction.
  4. Justify the clustering. Cluster at the level where the shocks are correlated (firm, industry, state); use two-way (firm and time) when both dimensions have common shocks; address few-cluster with wild-cluster bootstrap.
  5. Report power/economic scale. State N, the dependent-variable mean, and the standard-deviation-scaled effect so a reader sees the magnitude in context.

Execution bridge (StatsPAI / Stata MCP)

Run the asset-pricing battery, don't just specify it. Full map: execution-with-mcp. Financial Management is empirical corporate finance + asset pricing; corporate-causal chain (DiD/IV/RDD) plus the factor-zoo haircut for cross-sectional pricing.

  • Factor regressions / time-series alphas: feols with the right SEs (Newey–West / clustered) — read the alpha and t off the return.
  • Factor-zoo haircut: after disclosing how many signals were screened, apply romano_wolf / benjamini_hochberg and report the alpha that survives.
  • Fama–MacBeth + Shanken EIV are Stata-canonical — run via mcp__stata-mcp__stata_do with the vendored resources/code/ (asreg / xtfmb).
  • Exhibits: etable; hand formatting to the tables/figures skill.

Report the economic magnitude (bps/month alpha, Sharpe gain); full factor grid → appendix. JF execution walkthrough.

Checklist

  • Attrition table from raw universe to estimation sample, with counts per screen
  • Every key variable defined, winsorization stated, source field named
  • Survivorship and look-ahead bias addressed (point-in-time accounting; clean signals)
  • Merge keys and match rate reported; unmatched-firm bias discussed
  • Panel frequency and balanced/unbalanced status stated; entry/exit handled
  • Clustering level justified; two-way / few-cluster handled where needed
  • Dependent-variable mean and N reported so magnitudes are interpretable
Show full SKILL.md (452 more words)Show less

Anti-patterns

  • "We apply standard filters" with no attrition table or counts
  • Restated accounting data used as if it were known at the time (look-ahead)
  • A leverage / payout / governance measure that silently switches definition across tables
  • CRSP-Compustat (or vendor) merges with an unreported or low match rate
  • White / homoskedastic SEs on a firm-year panel with obvious serial and cross-sectional dependence
  • Reporting only t-statistics with no dependent-variable mean to anchor the magnitude

Worked vignette (illustrative)

A draft studies payout on a "standard Compustat sample" with white standard errors. A referee cannot reconstruct it. The FM fix: add Table 1 Panel A as an attrition table (raw universe → drop financials/utilities → drop missing payout → final N), define payout precisely as dividends-plus-repurchases over assets winsorized at 1%/99%, switch to standard errors clustered by firm and year (the panel has both firm persistence and common market shocks), and report the dependent-variable mean so the coefficient's economic size is legible. The design is now reconstructable and the inference defensible.

Data-source notes specific to finance

  • Compustat: beware restated data — use point-in-time (PIT) snapshots for accounting variables that signals are built from; flag any look-ahead in the merge.
  • CRSP: retain delisted securities and apply delisting returns; survivorship bias from dropping them inflates many results.
  • CRSP–Compustat link: report the link table used and the match rate; unmatched firms skew toward small/young/foreign issuers.
  • Vendor / hand-collected data (governance, syndicated loans, microstructure): describe coverage, the time window, and any sample selection the vendor's universe imposes — FM referees ask "what is not in this dataset?"
  • Returns: state whether returns are gross or net, the holding-period convention, and how microcaps/penny stocks are treated.

Referee pushback mapped to the design fix

  • "I can't reproduce your sample." → Add the attrition table from the raw universe with counts dropped per screen.
  • "Your accounting variable uses restated data." → Switch to point-in-time data and say so in the note.
  • "The standard errors look too small." → Justify and report two-way (or wild-cluster) standard errors matched to the panel's dependence.
  • "Is this effect economically meaningful?" → Report the dependent-variable mean and a one-SD-scaled effect.

When the design choice is itself the contribution

Some FM papers earn their place through a measurement or sample-construction innovation — a cleaner proxy, a newly merged dataset, a hand-collected sample. When that is the contribution:

  • Validate the new measure against an external benchmark or a known case, not just internal consistency.
  • Show what it captures that prior proxies miss, with a side-by-side comparison.
  • Document construction in painstaking detail in the internet appendix, because the measure is the asset and referees will probe it.
  • Connect the measurement gain to a substantive finding — a better proxy is interesting at FM only if it changes what we conclude about a decision-relevant question.

Output format

【Sample frame】universe + date range + screens (attrition table? [Y/N])
【Key variables】defined + winsorized + source fields named? [Y/N]
【Bias controls】survivorship / look-ahead handled? [Y/N]
【Merge】keys + match rate reported? [Y/N]
【Inference】clustering level justified; two-way/few-cluster handled? [Y/N]
【Magnitude】dep-var mean + N reported? [Y/N]
【Next skill】finman-robustness

© brycewang-stanford, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in Financial-Management-Skills/skills/finman-empirical-design of brycewang-stanford/Awesome-Journal-Skills.

Open the folder on GitHubat commit 932eb23

Compare with similar skills

Finman Empirical Design 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.

Finman Empirical Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Finman Empirical Design this skillbrycewang-stanford/Awesome-Journal-Skills1.2k—~2.2kAutomated safety check: PassMIT
Hypothesis Generationspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
Last30daysmvanhorn/last30days-skill64k—~7.9kAutomated safety check: NotesMIT

Similar skills

  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes
  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.9k GitHub starsUsed in 17 repos~5.9k tokens
    Research & ScienceAuto-check: notes

More from brycewang-stanford/Awesome-Journal-Skills

All 2,387 skills in this repo
  • Aaag Data Analysis

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when running and reporting the analysis for an Annals of the American Association of Geographers manuscript — spatial statistics and modeling, remote-sensing accuracy, or…

    1.2k GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Literature Positioning

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when positioning an Annals of the American Association of Geographers manuscript in the literature — engaging geographic scholarship across the relevant area and the…

    1.2k GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Rebuttal

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when responding to an Annals of the American Association of Geographers decision letter (major/minor revision) — building a point-by-point response to the subject editor and…

    1.2k GitHub stars~1.4k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Research Design

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when defending the research design of an Annals of the American Association of Geographers manuscript — spatial/quantitative analysis and GIScience, remote-sensing and…

    1.2k GitHub stars~1.4k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Review Process

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when you need to understand how the Annals of the American Association of Geographers evaluates a manuscript — double-anonymous review routed through a subject editor by…

    1.2k GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Submission

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when running the final pre-submission preflight for the Annals of the American Association of Geographers via ScholarOne Manuscripts — area/article-type selection…

    1.2k GitHub stars~1.6k tokensUpdated 14 days ago
    Auto-check passed

Questions about Finman Empirical Design

What does Finman Empirical Design do?

A skill your agent uses when the sample construction, variable measurement, panel structure, or inference of a Financial Management (FM) manuscript is fragile — before identification can be trusted…. Finman Empirical Design is an agent skill from brycewang-stanford/Awesome-Journal-Skills. Use when the sample construction, variable measurement, panel structure, or inference of a Financial Management (FM) manuscript is fragile — before identification can be trusted or exhibits finalized.

When should I use Finman Empirical Design?

Finman Empirical Design fits situations like: the sample construction; variable measurement; panel structure; inference of a Financial Management (FM) manuscript is fragile — before identification can be trusted.

How do I install Finman Empirical Design in Claude Code?

Run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill finman-empirical-design -a claude-code`. Or copy the skill folder (Financial-Management-Skills/skills/finman-empirical-design in brycewang-stanford/Awesome-Journal-Skills) into .claude/skills/finman-empirical-design in your project. Claude Code loads it when a task matches its description.

How do I install Finman Empirical Design in Codex?

Run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill finman-empirical-design -a codex`. Or copy the skill folder (Financial-Management-Skills/skills/finman-empirical-design in brycewang-stanford/Awesome-Journal-Skills) into .agents/skills/finman-empirical-design in your project. Codex loads it when a task matches its description.

Can I use Finman Empirical Design 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 brycewang-stanford/Awesome-Journal-Skills --skill finman-empirical-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/finman-empirical-design, .gemini/skills/finman-empirical-design, .github/skills/finman-empirical-design and .opencode/skills/finman-empirical-design in your project.

What does Finman Empirical Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Finman Empirical Design is instructions for the agent only.

Does Finman Empirical Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Finman Empirical Design 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. Review the folder before installing.

What licence does Finman Empirical Design use?

Finman Empirical Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Finman Empirical Design use?

About 2.2k tokens (SKILL.md is roughly 8.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Finman Empirical Design?

Skills that share tags, products or a category with Finman Empirical Design: Hypothesis Generation (spacering-net/codeg, 3.9k stars), GitHub Deep Research (bytedance/deer-flow, 84k stars), Nature Paper Card (Yuan1z0825/nature-skills, 47k stars) and Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Finman Empirical Design?

brycewang-stanford (a GitHub user) maintains it in brycewang-stanford/Awesome-Journal-Skills, which has 1,231 GitHub stars. The repository holds 2,387 skills in this directory. The repository was last updated on September 27, 2026.

Source: brycewang-stanford/Awesome-Journal-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.