From fe977e500cb4b31c9300f0628a3fac904ed94ccb Mon Sep 17 00:00:00 2001
From: Bill Ballou <bill@bballou.com>
Date: Wed, 7 Jan 2026 07:54:55 -0500
Subject: [PATCH] Update README with cloning instructions and skills list

- Add instructions for cloning with submodules
- Add commands for initializing and updating submodules
- Add table listing all skills with links to repositories
---
 README.md | 31 ++++++++++++++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

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