agentsclimarketplace

Sigmetrics writing style

Skill brycewang-stanford/Awesome-Journal-Skills/SIGMETRICS-Skills/skills/sigmetrics-writing-style

Use when revising an ACM SIGMETRICS paper for a rigorously stated performance contribution on the first page, explicit modeling assumptions and their validity, theorems paired with numerical/empirical validation, evidence proportional to the claim, double-anonymous wording, and disciplined use of the 20-page single-column acmsmall budget.From its SKILL.md

Install
npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill sigmetrics-writing-style

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

5.6 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it

SIGMETRICS Writing Style

Use this when revising the main paper. SIGMETRICS papers are POMACS journal articles read by performance-evaluation specialists, so they need a precise performance contribution stated on the first page and claims a reviewer can check. The failure this skill prevents is a paper that reads like a systems demo (numbers, no model) or a theory paper with no systems relevance (theorems, no validation).

Revision rules

  • Lead with the performance contribution, stated rigorously: the systems-performance problem, a precise metric (mean vs. tail latency, throughput, regret, energy), why current models/policies fall short, the contribution (a model, policy, methodology — ideally with a proven bound), the validation, and what changes for real systems.
  • State assumptions where the result uses them. A theorem is only as strong as its assumptions; name the arrival process, service distribution, independence, and stationarity your result needs, and show they are plausible for the target system. Hidden assumptions are the fastest reject.
  • Pair every quantitative claim with proportional evidence — a proof for an analytic claim, a simulation whose curve matches the analysis, confidence intervals over repeated runs, effect sizes for a comparison — not adjectives.
  • Validate the model against measurement. The SIGMETRICS signature move is showing that the analytic prediction and the measured/simulated data agree; a theorem with no validation, or a measurement with no model, is half a paper.
  • Respect the 20-page acmsmall budget as a design constraint. References are unlimited, but body text, figures, and in-body appendices are not. A paper that only fits by shrinking the assumptions or the validation is over-scoped.
  • Maintain double-anonymity in self-citations, system names, trace provenance, and acknowledgements (except in the Operational Systems Track).

Performance-evaluation paper skeleton

SectionJob it must doCommon failure
IntroProblem, precise metric, inadequacy, contribution, validation preview, systems payoff — first pageLeads with a trend and "improves performance," no metric or model
Model / SystemThe model and its assumptions, stated precisely and justifiedAssumptions hidden or unjustified against the real workload
AnalysisTheorems/bounds with proofs (full proofs in an appendix)A claimed bound with a hand-waved or incomplete proof
ValidationAnalysis-vs-simulation agreement; measurement of the real systemA plot with no analytic comparison, or no confidence intervals
EvaluationBaselines, fairly tuned; the systems payoff on real workloadsUntuned baseline; toy inputs; benchmark score as the whole result
Assumption validity / threatsWhere assumptions hold and where they are stressedDeferred or absent; no estimation-error / robustness discussion

Sentence-level rewrites

Draft patternSIGMETRICS-safe rewrite
"Our policy significantly improves performance.""reduces p99 latency by X% (95% CI ...) over <tuned baseline> on <workload>, matching Thm. 1"
"We assume the standard queueing model.""We assume M/G/1 with service-time distribution fit to the trace (§5.1, QQ-plot Fig. 6)"
"The bound holds in general.""Thm. 1 holds under assumptions A1-A3; §6 quantifies degradation when A2 is violated"
"Simulation confirms our approach.""the analytic p99 curve lies within the simulated confidence intervals across three distributions (Fig. 4)"
"State-of-the-art results."Claim scoped to the metric, workload, and regime actually analyzed and measured

Assumption-and-validation discipline

[Assumptions] list each (arrival, service, independence, stationarity); justify against the target
[Analysis]    prove the bound; put full derivations in an appendix within the reviewed pages
[Validation]  overlay analysis on simulation/measurement; report CIs and number of runs
[Robustness]  quantify what happens when an assumption is stressed (estimation error, heavy tails)
-> a theorem, its assumptions, and its validation are one unit -- present them together

Vignette: compressing a proof-plus-measurement paper

A draft with three theorems, a long simulator description, and a sprawling measurement section: keep all three theorem statements and their assumptions in the body, move full proofs to an appendix with forward references, keep the one figure showing analysis-vs-simulation agreement and the table with the trace-driven payoff, and cut redundant simulator detail to the artifact. The test of a good cut: a reviewer should be able to answer "what is claimed, under what assumptions, and does the measurement back it?" from the body alone.

Output format

[Writing diagnosis] clear / under-specified-assumptions / unvalidated / over-claimed / over-scoped
[First-page fix] <new framing leading with the precise performance contribution>
[Assumption audit] <assumption -> stated? justified against workload? where used?>
[Validation fix] <theorem/claim -> analysis-vs-measurement evidence to add>
[Anonymity edits] <system names / self-citations / trace provenance to rewrite>

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.