Writing & Publication Skill
SKILL.md
Writing & Publication Skill
Patterns for technical writing, academic publication, and content strategy.
Writing Formats
| Format | Audience | Length | Review |
|---|---|---|---|
| Academic Paper | Researchers | 4-10K words | Peer (2-6 mo) |
| Workshop Paper | Researchers | 2-4K words | Light (1-2 mo) |
| Trade Publication | Practitioners | 1-2K words | Editorial (2-4 wk) |
| Blog Post | Developers | 500-1.5K words | Self |
| Documentation | Users | Variable | Internal |
Academic Paper Structure
- Abstract — Problem, approach, results, implications (150-300 words)
- Introduction — Motivation, problem, contributions, outline
- Related Work — Position within existing research
- Methodology — How you did it (reproducible)
- Implementation — Technical details (if applicable)
- Evaluation — Evidence for claims
- Discussion — Interpretation, limitations
- Conclusion — Summary, future work
- References — Venue-specific format
Writing Principles
- Precision over flair
- Evidence for claims (data or citations)
- Acknowledge limitations
- Active voice preferred
- Define terms on first use
- Break sentences at 25-30 words
Pitfalls to Avoid
| Bad | Fix |
|---|---|
| "might possibly perhaps" | "may" |
| "revolutionary" | "novel approach" |
| "was performed" | "we performed" |
| Jargon without definition | Define on first use |
| Buried contributions | State explicitly in intro |
Structuring Arguments
CARS Model (Introductions):
- Establish territory (topic importance)
- Establish niche (gap in knowledge)
- Occupy niche (your contribution)
Heilmeier Catechism (Motivation):
- What are you trying to do?
- How is it done today? Limits?
- What's new in your approach?
- Who cares? What difference?
- What are the risks?
Audience Adaptation
| Audience | Adjust |
|---|---|
| Researchers | Add theoretical framing, citations |
| Practitioners | Add code examples |
| Executives | Add business value |
| General tech | Remove jargon |
Publication Strategy
Venue sequencing:
- Trade publication → immediate visibility
- arXiv pre-print → establish priority
- Workshop paper → academic credibility
- Journal/conference → peer-reviewed validation
First-time author:
- Start with lower-barrier venues
- Collaborate with established authors
- Target workshops first
- Conduct user studies (empirical data strengthens)
Responding to Reviews
| Feedback | Response |
|---|---|
| "Missing related work" | Add citations, explain positioning |
| "Claims not supported" | Add evidence or soften claims |
| "Unclear methodology" | Expand description |
| "Limited evaluation" | Add studies or acknowledge |
Response letter: Thank → Summarize changes → Address each point → Highlight extras
Pre-Submission Checklist
- Abstract stands alone
- Contributions stated in intro
- Claims supported by evidence
- Limitations acknowledged
- References complete
- Figures/tables readable
- Page limit respected
- Code available (if applicable)
Tools
| Tool | Purpose |
|---|---|
| Overleaf | LaTeX collaboration |
| Grammarly | Grammar/style |
| Zotero | References |
| Connected Papers | Literature discovery |
Synapses
See synapses.json for connections.