diff --git a/README.md b/README.md
index cf09f7e9799ded1a9851d004d7ee18ea664ec8e3..46f318f1e4c4c65cca4e0e531a71563783c25eb8 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,26 @@
 # gentoo-qa-image
 
+To check your overlay for QA issues, add the following `.gitlab-ci.yml`:
+
+```yaml
+image: $CI_REGISTRY/poncho/gentoo-qa-image:latest
+
+stages:
+  - repoman
+  - pkgcheck
+
+variables:
+  GIT_DEPTH: 1
+
+repoman:
+  stage: repoman
+  script:
+    - repoman --version
+    - repoman full -xiIdv
+
+pkgcheck:
+  stage: pkgcheck
+  script:
+    - pkgcheck --version
+    - pkgcheck scan
+```
diff --git a/gitlab-ci.yml.example b/gitlab-ci.yml.example
new file mode 100644
index 0000000000000000000000000000000000000000..39d3747d831761a5427d97ae90f37eaae312cdeb
--- /dev/null
+++ b/gitlab-ci.yml.example
@@ -0,0 +1,20 @@
+image: $CI_REGISTRY/poncho/gentoo-qa-image:latest
+
+stages:
+  - repoman
+  - pkgcheck
+
+variables:
+  GIT_DEPTH: 1
+
+repoman:
+  stage: repoman
+  script:
+    - repoman --version
+    - repoman full -xiIdv
+
+pkgcheck:
+  stage: pkgcheck
+  script:
+    - pkgcheck --version
+    - pkgcheck scan