Writing & Publication Skill
Installation
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.
Related skills
More from fabioc-aloha/windowswidget
prompt engineering skill
Craft effective prompts that get the best results from language models.
3text-to-speech
Alex's voice synthesis capability for reading documents aloud
1socratic questioning skill
Help users discover answers, don't just deliver them.
1academic research skill
Patterns for thesis writing, dissertations, research papers, literature reviews, and scholarly work.
1work-life balance skill
Detect burnout signals and proactively support sustainable productivity.
1grant writing skill
Translate research vision into funded reality.
1