Install
openclaw skills install @laninga/discussion-conventions-diagnosisDiagnose academic-writing conventions in the Discussion of an English psychology research paper. Checks the Achievement/Contribution statement (placement, type among 4 — method / results / impact / application), limitations writing, future-work conventions, citation density and function, and the use
openclaw skills install @laninga/discussion-conventions-diagnosisScience Research Writing Unit 4.1.1 (4 types of contribution) + 4.2.2 Q&A "Is there a difference between ACHIEVEMENT and CONTRIBUTION?" + 4.2.3 ("Identify potential applications") + 4.2.2 (How many citations / what function).
| Type | Definition | Signal phrase |
|---|---|---|
| Method | Modified or new method that improves on existing methods | "we developed a novel...", "the proposed method outperforms..." |
| Results | Better / more accurate results than prior studies | "we first demonstrated that...", "to our knowledge, this is the first..." |
| Impact | Game-changer / sets new direction / invalidates prior work | "our findings challenge the assumption that...", "we propose a paradigm shift..." |
| Application | New or extended real-world application | "could be used to...", "has implications for clinical practice..." |
| Signal | Means |
|---|---|
| "Our study made a contribution to the field of..." | Generic — should name the specific contribution |
| "We proved that..." | Overclaim — "prove" is rarely appropriate in a single study |
| "More research is needed" (no specifics) | Weak future work — should be directional |
| Limitations are one vague sentence | Surface-level — should be specific (sample, design, measure) |
| Contribution in the last paragraph | Placement violation — should be in the opening |
| Multiple contribution types claimed without support | Type-mixing — pick the strongest one and own it |
| Citation density <5 or >40 in a Discussion of ~1500 words | Density outside typical range |
## Conventions Diagnosis
### Achievement/Contribution
- [✓/✗] Achievement statement present
- [✓/✗] Contribution statement present
- Type claimed: [method / results / impact / application]
- Type appropriate for study? [yes / concern / no]
- Placement: [opening / mid / closing]
- Hedging level: [appropriate / over-claimed / under-claimed]
### Limitations
- [✓/✗/⚠] Present
- Quality: [specific / vague / throwaway]
### Future work
- [✓/✗/⚠] Present
- Quality: [directional / vague / missing]
### Citation audit
- Total count: N
- Density: N / 1000 words
- Function distribution: confirm=X / contrast=Y / extend=Z
- Coverage: [all three functions / only confirm / etc.]
### Top issues (severity: critical / major / minor)
1. ...
Does not generate or rewrite. Only diagnoses.
references/rubric.mdreferences/checklist.mdreferences/examples/