Rs paper writing
Improve academic paper writing for recommender-system papers, including LLM-based recommendation, fairness/debiasing/causal recommendation, sequential recommendation, retrieval, ranking, and RS experiments. Use when drafting or revising Abstract, Introduction, Preliminary, Method, Experiments, Related Work, or Conclusion; polishing figures/tables; checking claim-evidence alignment; or performing pre-submission self-review for KDD, SIGIR, WWW, AAAI, ACL, RecSys, CIKM, or WSDM style papers.From its SKILL.md
npx -y skills add quentinzh/rs-paper-writing --skill rs-paper-writingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
6.1 KB, ~1.1k tokens by cl100k_base, as published. Nobody here has run it
Recommender Systems Paper Writing
Overview
Use this skill to write or revise recommender-system research papers into clear, reviewer-friendly drafts.
Prioritize three outcomes:
- The paper story is easy to understand.
- Every major claim is supported by appropriate evidence.
- The writing matches recommender-system review expectations.
Core Workflow
- Clarify the paper story before sentence-level editing.
- Identify the paper type: LLM-based recommendation, fairness/debiasing/causal recommendation, sequential recommendation, retrieval/ranking, or another RS task.
- Load only the needed section guide from
references/. - Build a compact outline before drafting prose.
- Rewrite paragraph-by-paragraph with one message per paragraph.
- Run reverse outlining after each section.
- Check Abstract and Introduction claims against experiments.
- Run final adversarial review with
references/paper-review.md.
Global Principles
- Keep one paragraph for one message only.
- State the paragraph message in the first sentence.
- Make nouns self-contained; define new terms before reusing them.
- Keep terminology consistent throughout the paper.
- Choose the object noun based on the paper: model, method, framework, objective, algorithm, system, or evaluation protocol. Once chosen, use it consistently.
- Use
proposewhen introducing the paper's own technical contribution unless another verb is technically necessary. - Maintain sentence-to-sentence flow through cause, contrast, consequence, refinement, or example.
- Treat figures, tables, and captions as core communication, not decoration.
- Avoid unsupported superiority claims.
- Read every section as a skeptical recommender-system reviewer.
RS-Specific Priorities
- Make the task setting explicit: user-item interaction, candidate generation, ranking, next-item prediction, click/conversion prediction, list generation, fairness, debiasing, causal inference, or LLM-based recommendation.
- For LLM-based recommendation, define the input prompt, output format, valid-item mapping, and training loss when relevant.
- For fairness/debiasing/causal papers, define the target distribution, bias source, causal variables, or fairness metric before proposing the method.
- For sequential recommendation, keep temporal user behavior, short-term/long-term interest, and prediction target unambiguous.
- For experiments, focus on task-specific metrics, baseline grouping, statistical significance, efficiency/resource cost, LLM generation validity/grounding, and fairness/accuracy trade-off.
- For experimental setup choices, use recent high-quality literature to justify datasets, compared models, metrics, and common hyperparameters.
Paragraph Clarity Check
Use this quick test whenever the user asks whether a paragraph flows or is clear.
- Read as an external reviewer:
- Does this paragraph have one explicit message?
- Does the first sentence state that message?
- Are all key terms readable without hidden context?
- Does each sentence connect to the previous one with a clear relation?
- Run reverse outlining:
- Write down the section thesis.
- Write down each paragraph topic sentence.
- Write down the evidence or explanation under each paragraph.
- Check whether each paragraph maps cleanly to the thesis.
- If flow is weak, add temporary transition phrases during revision, then remove unnecessary scaffolding before finalizing.
Source reference:
references/does-my-writing-flow-source.md
Section Guides
Load only the needed section file:
- Abstract:
references/abstract.md - Introduction:
references/introduction.md - Preliminary / Problem Formulation:
references/preliminary.md - Method:
references/method.md - Experiments:
references/experiments.md - Related Work:
references/related-work.md - Conclusion:
references/conclusion.md - Paper review:
references/paper-review.md - Paragraph clarity source:
references/does-my-writing-flow-source.md - Example bank index:
references/examples/index.md
Paper Review Core Points
Use references/paper-review.md for the full checklist and workflow.
- Add an end-of-draft self-review question list in five dimensions:
- contribution,
- writing clarity,
- experimental strength,
- evaluation completeness,
- method design soundness.
- Treat claim-evidence alignment as a hard constraint.
- Resolve recommender-system rejection risks such as weak baselines, unsupported metric choices, missing significance, unclear efficiency cost, invalid LLM outputs, weak grounding, and unexamined fairness/accuracy trade-off.
- Revise until major rejection risks are explicitly addressed.
Execution Rules
- Build a mini-outline before drafting prose.
- For Method, explicitly include motivation, design, and technical advantage for each major module.
- For Preliminary, define only what the Method section directly needs.
- Avoid presenting the paper as a small patch over a weak baseline.
- Keep terminology stable across the full paper.
- If a claim cannot be supported by experiments or analysis, weaken or remove it.
- Do not load all section references at once; load only the guide needed for the current edit target.
Output Contract
When asked to rewrite or draft sections, return:
- A compact section outline.
- Revised paragraphs with explicit paragraph roles.
- A short self-review checklist covering clarity, flow, terminology consistency, unsupported claims, and missing evidence.
- A claim-evidence map for each major claim using
Claim: ... | Evidence: ... | Status: supported/needs evidence.
What ships with it: 39 files
66.0 KB alongside SKILL.md
agents/
- openai.yaml260 B
references/
- abstract.md4.5 KB
- conclusion.md1.4 KB
- does-my-writing-flow-source.md4.9 KB
- examples/abstract-examples.md601 B
- examples/abstract/template-a.md906 B
- examples/abstract/template-b.md1009 B
- examples/abstract/template-c.md824 B
- examples/index.md2.4 KB
- examples/introduction-examples.md1.6 KB
- examples/introduction/novel-task-challenge-decomposition.md726 B
- examples/introduction/pipeline-not-recommended-abstract-only.md714 B
- examples/introduction/pipeline-version-1-one-contribution-multi-advantages.md645 B
- examples/introduction/pipeline-version-2-two-contributions.md552 B
- examples/introduction/pipeline-version-3-new-module-on-existing-pipeline.md517 B
- examples/introduction/pipeline-version-4-observation-driven.md552 B
- examples/introduction/technical-challenge-version-1-existing-task.md689 B
- examples/introduction/technical-challenge-version-2-existing-task-insight-backed-by-traditional.md912 B
- examples/introduction/technical-challenge-version-3-novel-task.md727 B
- examples/introduction/version-1-task-then-application.md660 B
- examples/introduction/version-2-application-first.md626 B
- examples/introduction/version-3-general-to-specific-setting.md682 B
- examples/introduction/version-4-open-with-challenge.md706 B
- examples/method/example-of-the-three-elements.md1.2 KB
- examples/method-examples.md1019 B
- examples/method/llm-rec-pipeline-notes.md1.0 KB
- examples/method/method-writing-common-issues-note.md814 B
- examples/method/module-design-sequential-rec.md1.2 KB
- examples/method/module-motivation-patterns.md668 B
- examples/method/module-triad-llm-rec.md1.1 KB
- examples/method/overview-template.md727 B
- examples/method/pre-writing-questions.md700 B
- examples/method/section-skeleton.md353 B
- experiments.md7.5 KB
- introduction.md4.9 KB
- method.md6.1 KB
- paper-review.md4.0 KB
- preliminary.md6.2 KB
- related-work.md1.8 KB