Contributions

How to contrib

CONTRIBUTIONS.md

@@ -0,0 +1,35 @@
+## How to contribute to Atomic Red Team
+
+#### **Atomic Contribution**
+
+Atomic Red Team welcomes all types of contributions as long as it is mapped to [MITRE ATT&CK](https://attack.mitre.org/wiki/Main_Page).
+
+The Framework is also meant to be "easy". If your Atomic test is complicated and requires multiple external utilities/packages/Kali, we may dismiss it.
+
+TEST YOUR Atomic Test! Be sure to run it from a few OS platforms before submitting a pull to ensure everything is working correctly.
+
+If sourcing from another tool/product (ex. generated command), be sure to cite it in your .md file.
+
+Any and all Payloads need to be placed in the respective Windows|Mac|Linux Payload directory.
+
+Be sure you update the ATT&CK url, Txxxx number, and the title (ex. InstallUtil).
+
+
+#### Atomic Template Example
+
+
+    ## InstallUtil
+
+    MITRE ATT&CK Technique: [T1118](https://attack.mitre.org/wiki/Technique/T1118)
+
+    ### Execution Examples:
+
+    Input:
+
+        x86 - C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe /logfile= /LogToConsole=false /U AllTheThings.dll
+
+        x64 - C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe /logfile= /LogToConsole=false /U AllTheThings.dll
+
+    ## Test Script
+
+    [InstallUtilBypass.cs](https://github.com/redcanaryco/atomic-red-team/blob/master/Windows/Payloads/InstallUtilBypass.cs)