Update README.md

README.md

@@ -1,6 +1,6 @@
 # OpenRubrics/RubricRM-8B-Rubric-v2
 
-Finetuned checkpoint for rubric-based reward modeling / judging.
+This is a 8B RubricRM-Rubric model (v2), finetuned from [Qwen3/Qwen3-8B](https://huggingface.co/Qwen/Qwen3-8B).
 
 ## Usage
 ```python
@@ -10,7 +10,68 @@ tok = AutoTokenizer.from_pretrained(model_id, use_fast=True)
 model = AutoModelForCausalLM.from_pretrained(model_id, torch_dtype="auto")
 ```
 
-## Notes
-- Format: Transformers-compatible (config/tokenizer/weights).
-- Base: Qwen3 8B (Rubric-Generator).
-- Files tracked with Git LFS.
+
+To evaluate the model, please use the following format to build up message.
+
+```python
+RUBRIC_PROMPT_TEMPLATE = (
+    "Your task is to extract a set of rubric-style instructions from a user's request.\n"
+    "These rubrics will be used as evaluation criteria to check if a response fully meets the request.\n"
+    "Every rubric item must be a universal principle. If any rubric still contains topic-specific references (e.g., names, places, myths, numbers, historical facts), it is automatically invalid.\n"
+    "\n"
+    "- **Two Distinct Categories:**\n"
+    "  - [Hard Rule]: Derived strictly from explicit requirements stated in the <request> (format, length, structure, forbidden/required elements, etc.).\n"
+    "  - [Principle]: Derived by abstracting any concrete cues into domain-agnostic quality criteria (e.g., clarity, correctness, sound reasoning, pedagogy).\n"
+    "\n"
+    "- **Comprehensiveness:**\n"
+    "  The rubric must cover all critical aspects implied by the request and examples, including explicit requirements and implicit quality standards.\n"
+    "\n"
+    "- **Conciseness & Uniqueness:**\n"
+    "  Each rubric must capture a distinct evaluation criterion. Overlapping or redundant criteria must be merged into a single rubric. Wording must be precise and free of repetition.\n"
+    "\n"
+    "- **Format Requirements:**\n"
+    "  - Use a numbered list.\n"
+    "  - Each item starts with \"The response\" phrased in third person.\n"
+    "  - Append [Hard Rule] or [Principle] at the end of each item.\n"
+    "  - Do not include reasoning, explanations, or examples in the final output—only the rubrics.\n"
+    "\n"
+    "Here is the request:\n"
+    "{prompt}\n"
+    "\n"
+    "Please generate the rubrics for the above request."
+)
+
+user_text = RUBRIC_PROMPT_TEMPLATE.format(
+  prompt=instruction,
+  )
+
+messages_list = [
+  {"role": "user", "content": user_text},
+]
+
+message = tok.apply_chat_template(
+  messages_list, 
+  tokenize=False, 
+  add_generation_prompt=True,
+  enable_thinking=False
+)
+
+# Remaining step: Use either HF or vLLM for evaluation.
+# ...
+# ...
+```
+
+
+If you fidn our work helpful, please consider citing our paper:
+
+```
+@misc{liu2025openrubrics,
+      title={OpenRubrics: Towards Scalable Synthetic Rubric Generation for Reward Modeling and LLM Alignment}, 
+      author={Tianci Liu and Ran Xu and Tony Yu and Ilgee Hong and Carl Yang and Tuo Zhao and Haoyu Wang},
+      year={2025},
+      eprint={2510.07743},
+      archivePrefix={arXiv},
+      primaryClass={cs.CL},
+      url={https://arxiv.org/abs/2510.07743}, 
+}
+```