diff --git a/README.md b/README.md
index e931819..3740dda 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,32 @@
 # claude-skills
 
-Library of Claude Code skills as git submodules
\ No newline at end of file
+Library of Claude Code skills as git submodules.
+
+## Cloning
+
+To clone this repository with all submodules:
+
+```bash
+git clone --recurse-submodules https://git.prettyhefty.com/Bill/claude-skills.git
+```
+
+If you've already cloned without submodules, initialize them with:
+
+```bash
+git submodule update --init --recursive
+```
+
+To update all submodules to their latest commits:
+
+```bash
+git submodule update --remote --merge
+```
+
+## Skills
+
+| Skill | Description |
+|-------|-------------|
+| [claude-skill-git-gitea](https://git.prettyhefty.com/Bill/claude-skill-git-gitea) | Git and Gitea repository management |
+| [construction-database-skill](https://git.prettyhefty.com/Bill/construction-database-skill) | Construction project databases in Grist |
+| [docker-compose-config-skill](https://git.prettyhefty.com/Bill/docker-compose-config-skill) | Docker Compose configuration |
+| [docker-service-architecture-skill](https://git.prettyhefty.com/Bill/docker-service-architecture-skill) | Docker service architecture |
\ No newline at end of file