diff --git a/.templates/README.md b/.templates/README.md
new file mode 100644
index 0000000..1445d4b
--- /dev/null
+++ b/.templates/README.md
@@ -0,0 +1,40 @@
+# {CI Job Name}
+Summary of job here
+
+This job provides the following badge:
+
+{A badge here}
+
+## Dependencies
+
+- {dependent job name}
+
+## your .gitlab-ci.yml changes
+To use this job add the following to your `.gitlab-ci.yml` file
+
+``` yaml
+variables:
+    VARNAME: "a var value"
+
+stages:
+    - {new stage name}
+
+include:
+    - local: CI/{job name}/.gitlab-ci.yml
+```
+
+## CI/CD Variables required
+
+| var name | Description |
+|:----:|:----|
+| NEW VAR | this var does this and bka |
+
+
+## Job Workflow
+
+
+## Artifacts
+
+
+## License
+To view the license for this folder and any sub-folders, refer [here](https://gitlab.com/nofusscomputing/projects/gitlab-ci)