SkillAgentSearch skills...

writing-systems-papers

Paragraph-level structural blueprint for 10-12 page systems papers targeting OSDI, SOSP, ASPLOS, NSDI, and EuroSys. Provides page allocation, paragraph templates, and writing patterns

Install / Use

npx skills add wanshuiyin/Auto-claude-code-research-in-sleep --skill writing-systems-papers

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

95/100

Supported Platforms

OpenAI Codex

Our assessment of writing-systems-papers

writing-systems-papers scores 95/100 on our quality scale, 74th of 670 Content & Media skills we index (top 12%).

Its SKILL.md is 6.6 KB long, well organised into 22 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.

With 16,644 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
18/20
Description
15/15
Adoption
18/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 9 days ago, so writing-systems-papers is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

writing-systems-papers compared with similar skills

All 4 of these similar skills score higher than writing-systems-papers; compare them before choosing.

SkillScoreStarsUpdatedFormat
writing-systems-papers (this skill)by wanshuiyin9516.6k9d agoSKILL.md
Agent-Reachby Panniantong10085.8k12d agoCLAUDE.md
headroomby headroomlabs-ai10074.0k1d agoCLAUDE.md
rufloby ruvnet10073.4ktodayCLAUDE.md
CowAgentby zhayujie10047.1ktodayCLAUDE.md

Frequently asked questions

How do I install writing-systems-papers?
Run npx skills add wanshuiyin/Auto-claude-code-research-in-sleep --skill writing-systems-papers. The install tabs above show the steps for each supported agent.
Which AI agents does writing-systems-papers work with?
It is written for OpenAI Codex, as a SKILL.md file. Other agents that read the same format can often use it too.
Is writing-systems-papers safe to use?
It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is writing-systems-papers still maintained?
The repository was last updated 9 days ago, so writing-systems-papers is actively maintained.

name: writing-systems-papers description: "Paragraph-level structural blueprint for 10-12 page systems papers targeting OSDI, SOSP, ASPLOS, NSDI, and EuroSys. Provides page allocation, paragraph templates, and writing patterns. Use when user says "写系统论文", "systems paper structure", "OSDI paper", "SOSP paper", or wants fine-grained structural guidance for a systems conference submission." argument-hint: "[venue-or-section]" allowed-tools: Bash(*), Read, Write, Edit, Grep, Glob, WebSearch, WebFetch, mcp__codex__codex, mcp__codex__codex-reply

Writing Systems Papers: Paragraph-Level Blueprint

Structural guidance for $ARGUMENTS

Relationship to Other ARIS Skills

  • paper-write: General paper generation workflow with citation verification. This skill complements it with systems-specific structural blueprints.
  • paper-slides: Conference presentation generation (Beamer+PPTX). Already covers talks — no overlap.
  • paper-plan: Research outline creation. Use paper-plan first, then this skill for paragraph-level structure.

Boundary: paper-write handles the generation workflow (LaTeX output, DBLP verification, section-by-section drafting). This skill provides the structural skeleton — page budgets, paragraph roles, and writing patterns specific to systems venues.


Page Allocation: 12-Page Systems Paper

| Section | Pages | Key Content | |---------|-------|-------------| | Abstract | ~0.25 | 150–250 words, 5 sentences | | S1 Introduction | 1.5–2 | Problem → Gap → Insight → Contributions | | S2 Background & Motivation | 1–1.5 | Terms + Production observations | | S3 Design | 3–4 | Architecture + Modules + Alternatives | | S4 Implementation | 0.5–1 | Prototype, LOC, engineering | | S5 Evaluation | 3–4 | Setup + E2E + Ablation + Scalability | | S6 Related Work | 1 | By methodology, explicit comparison | | S7 Conclusion | 0.5 | 3-sentence summary |


Section Blueprints

Abstract (5 sentences)

S1: Problem context and importance
S2: Gap in existing approaches
S3: Thesis — "X is better for Y in environment Z" (Irene Zhang formula)
S4: Approach summary + headline results
S5: Impact or availability

Sources: Levin & Redell — "Can you state the new idea concisely?"; Irene Zhang — "abstract cannot use terms introduced in the paper."

S1 Introduction (1.5–2 pages)

  1. Problem (~0.5p) — Domain + concrete numbers + why it matters
  2. Gap analysis (~0.5p) — G1–Gn: specific shortcomings with evidence
  3. Key insight (1 para) — Thesis: "X is better for Y in Z"
  4. Contributions (~0.5p) — 3–5 numbered, testable claims with §N references

Pattern: hzwer Move 1 (territory) → Move 2 (niche) → Move 3 (occupy).

S2 Background & Motivation (1–1.5 pages)

  1. Technical background (~0.5p) — Define-before-use (Gernot Heiser)
  2. Observations (~0.5–1p) — O1, O2, O3 from production data → design insights

S3 Design (3–4 pages)

  1. Architecture overview (~0.5p) — Diagram first (Yi Ding: "draw a picture first")
  2. Module details (~2–2.5p) — Per module: choice, alternatives, why
  3. Trade-offs (~0.5–1p) — Summary of design decisions

Rule: "Every design choice must discuss alternatives" (Irene Zhang).

S4 Implementation (0.5–1 page)

Language, LOC, framework, key engineering decisions. Keep concise.

S5 Evaluation (3–4 pages)

  1. Setup (~0.5p) — Hardware, baselines, workloads, metrics
  2. End-to-end (~1–1.5p) — X vs baselines for Y on Z
  3. Ablation (~1–1.5p) — Remove each component, measure impact
  4. Scalability (~0.5p) — Behavior at increasing scale

Three-statement rule (Irene Zhang): Every conclusion stated as:

  • Hypothesis (section opening)
  • Conclusion (section closing)
  • Caption (figure caption)

S6 Related Work (1 page)

Group by methodology. For each group: what they do, limitation, how we differ.

S7 Conclusion (0.5 page)

Three sentences: problem, solution, result. No new information.


Writing Patterns

Pattern 1: Gap Analysis

Enumerate G1–Gn in intro → A1–An in design → verify in evaluation. Example: Lucid (ASPLOS'23) — 5 gaps mapped to 5 answers.

Pattern 2: Observation-Driven

O1–O3 from production data → insights → design components. Example: GFS (arXiv 2025) — 3 observations drive 3 components.

Pattern 3: Contribution List

Numbered contributions in intro, each with §N cross-reference. Example: Blox (EuroSys'24) — 7 contributions; Sia (SOSP'23) — 5 contributions.

Pattern 4: Thesis Formula

"X is better for Y in Z" structures the entire paper. Combine with other patterns for maximum impact.


Conference Differences

Always verify against current CFP — rules change yearly.

| Venue | Format | Pages | Camera-Ready | |-------|--------|-------|-------------| | OSDI | USENIX | 12 | 14 | | NSDI | USENIX | 12 | 14 | | SOSP | ACM SIGOPS | 12 | — | | ASPLOS | ACM SIGPLAN | 11 | 13 | | EuroSys | ACM | 12 | — |

Based on 2025/2026 CFPs.


Workflow

1. Determine venue and page limit
2. Choose writing pattern (Gap/Observation/Contribution/Thesis)
3. Allocate pages per section using the table above
4. Draft Abstract following 5-sentence template
5. Draft Introduction: Problem → Gap → Insight → Contributions
6. Draft Motivation with production observations (if available)
7. Draw architecture figure, then write Design
8. Draft Implementation (concise)
9. Draft Evaluation: setup → E2E → ablation → scalability
10. Draft Related Work by methodology groups
11. Draft Conclusion: 3 sentences
12. Run pre-submission checklist
13. Hand off to /paper-write for LaTeX generation and citation verification

Quick Self-Check

  • [ ] Thesis follows "X is better for Y in Z"
  • [ ] 3–5 numbered contributions with §N references
  • [ ] Design discusses alternatives for every major choice
  • [ ] Eval conclusions stated 3 times (hypothesis, result, caption)
  • [ ] Related work grouped by methodology
  • [ ] Page budget within venue limits
  • [ ] No fabricated observations, traces, or results
  • [ ] All citations verified (delegate to /paper-write)

Academic Integrity

  • Never fabricate observations, traces, or experimental results
  • Never generate citations from memory — use /paper-write citation workflow
  • Disclose LLM use per venue policy
  • This blueprint provides structural guidance, not copy-paste text

Authoritative Sources

  1. Levin & Redell — "How (and How Not) to Write a Good Systems Paper" (USENIX)
  2. Irene Zhang — "Hints on how to write an SOSP paper"
  3. Gernot Heiser — Style Guide + Paper Writing Talk
  4. Timothy Roscoe — "Writing reviews for systems conferences"
  5. Yi Ding — "How to write good systems papers?"
  6. hzwer & DingXiaoH — WritingAIPaper (GitHub)

Related Skills

View on GitHub
GitHub Stars16.6k
CategoryContent
Updated9d ago
Forks1.4k

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions