Improve model card for SKEL-CF: add metadata, links, description, usage, and visuals (#1)

- Improve model card for SKEL-CF: add metadata, links, description, usage, and visuals (c10c15b162d27661538b18ea63d821f5cfb58bc2)


Co-authored-by: Niels Rogge <nielsr@users.noreply.huggingface.co>

README.md

@@ -1,15 +1,100 @@
 ---
 license: apache-2.0
+pipeline_tag: image-to-3d
+tags:
+  - human-mesh-recovery
 ---
 
-# Model Card for Model ID
+# SKEL-CF: Coarse-to-Fine Biomechanical Skeleton and Surface Mesh Recovery
 
-pipeline_tag: Human Mesh Recovery
+TL;DR: SKEL-CF is a coarse-to-fine transformer framework for estimating anatomically accurate SKEL parameters from 3D human data. By converting 4DHuman to SKEL-aligned 4DHuman-SKEL and incorporating camera modeling, it addresses data scarcity and depth/scale ambiguities. SKEL-CF outperforms prior SKEL-based methods on MOYO (85.0 MPJPE / 51.4 PA-MPJPE), offering a scalable, biomechanically faithful solution for human motion analysis.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Pokerman8/SKEL-CF/main/static/images/teaser.jpg" alt="SKEL-CF Teaser Image">
+</p>
 
 ### Model Sources
 
 <!-- Provide the basic links for the model. -->
 
-- **Repository:** [Github Repo](https://github.com/Intellindust-AI-Lab/SKEL-CF)
-- **Paper :** [SKEL-CF: Coarse-to-Fine Biomechanical Skeleton and Surface Mesh Recovery](http://arxiv.org/abs/2511.20157)
-- **Demo :** [Github Demo](https://github.com/Intellindust-AI-Lab/SKEL-CF/blob/main/run_hsmr_test.py)
+-   **Repository:** [Intellindust-AI-Lab/SKEL-CF](https://github.com/Intellindust-AI-Lab/SKEL-CF)
+-   **Paper (Hugging Face):** [SKEL-CF: Coarse-to-Fine Biomechanical Skeleton and Surface Mesh Recovery](https://huggingface.co/papers/2511.20157)
+-   **Paper (arXiv):** [SKEL-CF: Coarse-to-Fine Biomechanical Skeleton and Surface Mesh Recovery](http://arxiv.org/abs/2511.20157)
+-   **Project Page:** [SKEL-CF Project Page](https://pokerman8.github.io/SKEL-CF/)
+-   **Demo:** [Github Demo](https://github.com/Intellindust-AI-Lab/SKEL-CF/blob/main/run_hsmr_test.py)
+
+---
+
+## 🗓️ Updates
+- [x] **\[2025.11.26\]** Release SKEL-CF.
+- [x] **\[2025.11.27\]** Release checkpoints and labels on [Hugging Face](https://huggingface.co/Intellindust/SKEL_CF_vitpose_H).
+
+## 🧭 Table of Content
+* [1. ⚒️ Setup](#%EF%B8%8F-setup)
+* [2. 🚀 Demo & Quick Start](#-demo--quick-start)
+* [3. 🧱 Reproducibility](#-reproducibility)
+* [4. 👀 Visual Results](#-visual-results)
+* [5. 📝 Citation](#-citation)
+* [6. 📜 Acknowledgement](#-acknowledgement)
+* [7. 🌟 Star History](#-star-history)
+
+
+## ⚒️ Setup
+
+1. [🌏 Environment Setup](./docs/SETUP.md#environment-setup)
+2. [📦 Data Preparation](./docs/SETUP.md#data-preparation)
+
+
+## 🚀 Quick Start
+Quick start with images:
+
+```shell
+bash vis/run_demo.sh
+```
+
+Quick start with videos:
+
+```shell
+bash vis/run_video.sh
+```
+
+## 🧱 Reproducibility
+
+For reproducing the results in the paper, please refer to [`docs/EVAL.md`](./docs/EVAL.md) and [`docs/TRAIN.md`](./docs/TRAIN.md).
+
+## 👀 Visual Results
+
+### Per-Layer Refinement
+![Per-Layer Refinement 2](https://raw.githubusercontent.com/Pokerman8/SKEL-CF/main/static/images/per-layer-2.gif)
+![Per-Layer Refinement 1](https://raw.githubusercontent.com/Pokerman8/SKEL-CF/main/static/images/per-layer-1.gif)
+### Sports Video
+<a href="https://raw.githubusercontent.com/Pokerman8/SKEL-CF/main/static/videos/badminton01.mp4">
+  <img src="https://img.shields.io/badge/▶️-Badminton%20Video-FF6B6B?style=for-the-badge&logo=video" alt="Badminton Video" />
+</a>
+
+
+<a href="https://raw.githubusercontent.com/Pokerman8/SKEL-CF/main/static/videos/skate01.mp4">
+  <img src="https://img.shields.io/badge/▶️-Skate%20Video-4ECDC4?style=for-the-badge&logo=video" alt="Skate Video" />
+</a>
+
+> 💡 **Tip**: Click the buttons above to watch videos, or visit our [project page](https://pokerman8.github.io/SKEL-CF/) for more visual results.
+
+
+## 📝 Citation
+If you use `SKEL-CF` or its methods in your work, please cite the following BibTeX entries:
+
+```latex
+@article{li2025skelcf,
+  title={SKEL-CF: Coarse-to-Fine Biomechanical Skeleton and Surface Mesh Recovery},
+  author={Li, Da and Jin, Jiping and Yu, Xuanlong and Cun, Xiaodong and Chen, Kai and Fan, Rui and Kong, Jiangang and Shen, Xi},
+  journal={arXiv},
+  year={2025}
+}
+```
+## 📜 Acknowledgement
+
+Parts of the code are adapted from the following repos: [SKEL](https://github.com/MarilynKeller/SKEL), [CameraHMR](https://github.com/pixelite1201/CameraHMR), [HSMR](https://github.com/IsshikiHugh/HSMR), [ViTPose](https://github.com/ViTAE-Transformer/ViTPose), [Detectron2](https://github.com/facebookresearch/detectron2)
+
+## 🌟 Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Intellindust-AI-Lab/SKEL-CF&type=date&legend=top-left)](https://www.star-history.com/#Intellindust-AI-Lab/SKEL-CF&type=date&legend=top-left)