diff --git a/CREATE_SKILL.md b/CREATE_SKILL.md
new file mode 100644
index 0000000..9b69c4a
--- /dev/null
+++ b/CREATE_SKILL.md
@@ -0,0 +1,28 @@
+# create a skill
+
+    start a github repo
+    star it
+    add README
+    add tags
+        aam
+        aam-skill
+        skill
+    check out
+    add npm
+    fund from faucet
+        get address
+        get secret exponent
+        put address in faucet
+        git config gitmark.secret exponent
+    get txid
+    create gitmark.json
+        add txid to gitmark.json
+    write INSTALL
+    git add . ; git commit -m first
+    git mark --genesis tx
+    send new tx
+    add empty commit
+    git push origin
+    npm publish
+    add to skills registry
+    update aam
diff --git a/lib/GITMARK_DIR.md b/lib/GITMARK_DIR.md
index a9bcd8f..0dbd774 100644
--- a/lib/GITMARK_DIR.md
+++ b/lib/GITMARK_DIR.md
@@ -54,3 +54,9 @@ it contains one field `privkey`
 This contains the secret exponent of the private key of the genesis txo
 
 It is used to move forward each gitmark
+
+The nesting of the repo dir by default follows the 3 directories in the git tree by default
+ie
+- project
+- user
+- provider (e.g. github.com)