diff --git a/config.role.example.md b/config.role.example.md
new file mode 100644
index 0000000..7800828
--- /dev/null
+++ b/config.role.example.md
@@ -0,0 +1,10 @@
+---
+# Everything in this section is optional
+name: <role-name>                 # The name of the role
+model: openai:gpt-4o              # The model to use for this role
+temperature: 0.2                  # The temperature to use for this role when querying the model
+top_p: null                       # The top_p to use for this role when querying the model
+use_tools: fs_ls,fs_cat           # A comma-separated list of tools to enable for this role
+use_mcp_servers: github,gitmcp    # A comma-separated list of MCP servers to enable for this role
+---
+You are an expert at doing things. This is where I would write the instructions for the role.