diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ee9dabb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# X2ProjectGenerator
+
+### Usage
+
+* Create an empty or default mod project
+* Close ModBuddy
+* Copy the files as you want them to be in the project
+* Run this exe with a single argument which points to the directory where `.x2proj` file is located:
+
+```
+X2ProjectGenerator.exe "C:\Users\xyman\Documents\Firaxis ModBuddy\XCOM - War of the Chosen\MyAwesomeMod\MyAwesomeMod"
+``` 
+
+*Note that the quotes (`"`) are important - otherwise script will break (if there are spaces in folder names)*
+
+This script will make sure that every folder and file in project folder is included in the project and sorted in correct order.
+Already existing entries won't be touched - you can run this script as many as you like.
\ No newline at end of file
diff --git a/X2ProjectGenerator.csproj b/X2ProjectGenerator.csproj
index 66a2fb5..9980750 100644
--- a/X2ProjectGenerator.csproj
+++ b/X2ProjectGenerator.csproj
@@ -43,6 +43,7 @@
   </ItemGroup>
   <ItemGroup>
     <Content Include=".gitignore" />
+    <Content Include="README.md" />
   </ItemGroup>
   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
   <!-- To modify your build process, add your task inside one of the targets below and uncomment it.