diff --git a/README.md b/README.md
index 848ff57..db9329b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,21 @@
-# template_library
+# shared-actions
 
-Template for library projects (no dev branch)
\ No newline at end of file
+Shared composite actions for Forgejo CI/CD pipelines.
+
+## Actions
+
+| Action | Description |
+|--------|-------------|
+|  |  |
+
+## Usage
+
+Reference actions from your project's workflow:
+
+```yaml
+- uses: schmalz/shared-actions/.github/actions/<action-name>@v1
+  with:
+    # see each action's README for inputs
+```
+
+Each action has its own README with inputs, usage examples, and notes.
\ No newline at end of file