From ai4ss-skills
Develops and revises academic prose for empirical political-science research. Clarifies central points, builds arguments, drafts sections, integrates evidence. Use for working papers, argument outlines, or revision memos.
How this skill is triggered — by the user, by Claude, or both
Slash command
/ai4ss-skills:academic-writing-scaffoldThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Use writing to develop the political-science argument. A paper's central point often becomes clear
Use writing to develop the political-science argument. A paper's central point often becomes clear through successive drafts, criticism, cuts, and reorganization. Working prose should expose the logic of the argument and its evidentiary limits.
Depending on the state of the paper, the work may include:
These materials remain provisional and should preserve unresolved choices and evidence gaps.
Read the current draft, concept memo, literature synthesis, design, analysis interpretation, figures, tables, and methods review. State the paper's one central point in a sentence. Ask whose understanding the paper changes, about what, and why the change matters to political science.
If the point cannot be stated, diagnose whether the problem is an unclear question, multiple papers competing for space, weak contribution, unresolved evidence, or a theory that does not match the study.
Determine what the paper actually does. It may develop or refine a theory, explore an explanation, offer a counterexample, establish an important descriptive pattern, evaluate a theoretical prediction, measure a neglected construct, or estimate a causal effect. Do not write the paper as if it performed a stronger inferential task than the design supports.
Lay out the chain from problem to explanation, evidence, and implication. Represent competing accounts fairly and show what evidence differentiates them. Distinguish assumptions, mechanisms, hypotheses, measurements, results, and interpretations. Decide which details belong in the main text, appendix, or future work based on their role in the point.
Write complete working paragraphs, not placeholder slots, when the available evidence supports them. Use direct claims, concrete subjects and verbs, clear transitions, and enough methodological detail for the reader to understand the inference. Preserve uncertainty, contrary evidence, and limits rather than smoothing them into a cleaner story.
Write in the language of the paper and follow the conventions of its field and audience without imitating journal boilerplate.
Read the draft for argument rather than surface polish. Remove material that does not advance the point, even if it was useful during discovery. Reorder sections when the reader learns things in the wrong sequence. Rewrite vague contribution claims, straw-man literatures, method-first introductions, table-by-table results narration, and conclusions that exceed the evidence.
Expect multiple passes: point and structure, paragraph logic, evidence and citation, then style.
Trace consequential empirical and literature claims to inspected sources, tables, or figures. Preserve the estimand, population, magnitude, uncertainty, and causal status. Mark genuine evidence gaps; do not invent a citation or use a transition to conceal missing support.
End with the few unresolved research choices that materially affect the working draft: competing interpretation, missing evidence, unstable point, scope condition, or analysis still needed.
npx claudepluginhub siyaozheng/ai4ss-skills --plugin ai4ss-skillsStructures the theoretical argument of an APSR manuscript into a discipline-level contribution by defining concepts, mechanisms, observable implications, and scope conditions.
Assists in writing and revising anthropology research articles, thesis chapters, and dissertation chapters across subfields, including abstracts, introductions, literature reviews, methods, findings, discussions, and conclusions.
Drafts publication-ready Theory sections for sociology journal articles. Guides structure, paragraph functions, contribution clusters, and prose calibration from analysis of 80 Social Problems/Social Forces papers.