ai-asset-pricing: Skill for Claude Code

Edit Section Skill

When this skill is invoked, follow this structured workflow to revise an existing section of the paper.

Input

The user specifies which section to edit (file path or section key) and what kind of revision (style cleanup, content revision, restructuring, or specific feedback to address).

Workflow

Step 1: Read Current Text

1. Read the target section from main.tex
2. Note the current structure, length, and key claims

Step 2: Load Standards

1. Read .claude/rules/academic-writing.md for banned words, terminology, and style rules
2. Read .claude/rules/banned-words.md for the full banned-word list
3. Read guidance/paper-context.md for correct claims, numbers, and paper framing (if it exists)

Step 3: Diagnose Issues

Run through each check category:

A. Banned Words (read banned-words.md for the full current list; key examples: delve, crucial, comprehensive, utilize; AI markers: underscores, showcasing, pivotal, intricate, encompass, aligns with; previewing: "as we show below", "Recall from"; filler: of course, obviously, in other words) B. Opening Quality -- Does sentence 1 state a concrete finding? C. Voice and Tense -- Flag passive constructions D. Quantitative Precision -- Numbers instead of adjectives; cross-check against paper-context.md if available E. Terminology -- If guidance/paper-context.md defines a terminology table, check compliance. Otherwise flag any terms used inconsistently within the section. F. Self-Praise -- Flag "striking", "important contribution", "novel" G. Concision -- Cut repeated ideas, "in other words", sentences that don't earn their place H. Em-Dashes -- No --- in prose (rewrite with commas, semicolons, colons, or parentheses) I. Structural AI Tells -- Check for patterns from academic-writing.md: naked "this" without noun, "Importantly,"/"Notably,"/"Specifically," as sentence openers, "Together, these results..." openers (max 1/paper), "In this section, we..." throat-clearing, "This finding" repetition (max 1/paper), "Overall," as paragraph opener. Check soft-ban counts: "highlights" (max 2/paper), "insights" (max 1/paper) J. Hedge Words -- Delete or quantify: somewhat, quite, very (intensifier), rather (hedge), arguably, perhaps. Replace with magnitudes. (See academic-writing.md "Kill Hedge Words") K. Nominalizations -- Prefer verbs: "conduct an analysis" → "analyze", "provide evidence" → "show". (See academic-writing.md "Prefer Verbs over Nominalizations")