experiment-report-writerlisted
Install: claude install-skill xjsongphy/skills
# Experiment Report Writer
Professional assistant for writing experiment reports, designed for physics and engineering academic contexts. Backend-specific typesetting (LaTeX or Typst) is handled by the project template together with the `latex-compile` / `typst` skills; this skill focuses on writing methodology.
## Core Writing Principles
### Narrative Flow (Essential)
**NEVER** start a section directly with a list, table, formula, or figure. **ALWAYS** include explanatory text first.
Use **"narrative → element → explanation"** structure. After presenting data, formulas, tables, or figures, add explanatory text that:
- Unpacks the meaning and significance
- Connects to previous findings
- Provides context for what comes next
- Discusses practical or theoretical implications
**BAD** (abrupt start):
```
## 结果
[Table: measurements]
[Equation: F = ma]
```
**GOOD** (narrative leads into content):
```
## 结果
表~1 展示了在不同条件下测得的实验数据。实验中控制变量为X,记录的响应变量Y呈现以下规律。
[Table: measurements]
对于质量为 $m$、所受合力为 $F$ 的物体,牛顿第二定律为
[Equation: F = ma]
其中,$a$ 表示物体加速度。
```
### Define Before Formula
**EVERY variable and unit must be defined in narrative before it appears in a formula.** Never introduce variables only inside parentheses after a formula.
**BAD** (undefined variables):
根据公式 $F = kx$,其中...
**GOOD** (define first, then formula):
对于弹簧系统,胡克定律指出恢复力 $F$ 与位移 $x$ 成正比:
[Equation: F = kx]
其中 $k$ 为弹簧劲度系数。
### Complete Sentences and Professional Tone
- Use complete sentences. Avoid sentence fr