diff --git a/shard.yml b/shard.yml
index ab888d65..885a2758 100644
--- a/shard.yml
+++ b/shard.yml
@@ -1,9 +1,15 @@
 name: shards
 version: 0.18.0
+description: |
+ Resolves, installs and updates project dependencies reproducibly from source
+ repositories.
 
 authors:
   - Julien Portalier <julien@portalier.com>
 
+documentation: https://crystal-lang.org/reference/man/shards
+repository: https://github.com/crystal-lang/shards
+
 dependencies:
   molinillo:
     github: crystal-lang/crystal-molinillo