scholarly-technical-writing

Plan and write scholarly, technical, scientific, professional, policy, engineering, developer, and research-based books. Use when the project requires argument maps, literature review, concept hierarc

SKILL.md

GitHub

Scholarly Technical Writing

Workflow

Make expertise legible. Define the reader's prior knowledge, concepts, terminology, argument, evidence, examples, and validation needs before drafting.

Read:

  • references/scholarly-technical-playbook.md for structure
  • references/argument-map.md for claims and evidence
  • references/technical-explanation.md for examples, diagrams, code, formulas, and teaching order

Use high-stakes-book-review if errors could affect health, law, finance, safety, security, or professional decisions.

Output Contract

End with:

## Argument Map

| claim | evidence | counterpoint | chapter |
|---|---|---|---|

## Literature Review Plan

## Concept Hierarchy

## Technical Explanation Plan

- Definitions:
- Examples:
- Figures/tables/code:
- Edge cases:

## Citation Plan