diff --git a/pyproject.toml b/pyproject.toml
index 0c43423..ffc71c0 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -2,6 +2,7 @@
 name = "upskill"
 version = "0.2.1"
 description = "Generate and evaluate agent skills"
+readme = "README.md"
 requires-python = ">=3.13.5,<3.14"
 dependencies = [
     "click>=8.1",
@@ -12,6 +13,10 @@ dependencies = [
     "rich>=13.0",
 ]
 
+[project.urls]
+Homepage = "https://github.com/huggingface/upskill"
+Repository = "https://github.com/huggingface/upskill"
+
 [project.optional-dependencies]
 dev = [
     "pytest>=8.0",