diff --git a/@vates/async-each/USAGE.md b/@vates/async-each/.USAGE.md
similarity index 100%
rename from @vates/async-each/USAGE.md
rename to @vates/async-each/.USAGE.md
diff --git a/@vates/coalesce-calls/USAGE.md b/@vates/coalesce-calls/.USAGE.md
similarity index 100%
rename from @vates/coalesce-calls/USAGE.md
rename to @vates/coalesce-calls/.USAGE.md
diff --git a/@vates/compose/USAGE.md b/@vates/compose/.USAGE.md
similarity index 100%
rename from @vates/compose/USAGE.md
rename to @vates/compose/.USAGE.md
diff --git a/@vates/decorate-with/USAGE.md b/@vates/decorate-with/.USAGE.md
similarity index 100%
rename from @vates/decorate-with/USAGE.md
rename to @vates/decorate-with/.USAGE.md
diff --git a/@vates/disposable/USAGE.md b/@vates/disposable/.USAGE.md
similarity index 100%
rename from @vates/disposable/USAGE.md
rename to @vates/disposable/.USAGE.md
diff --git a/@vates/multi-key-map/USAGE.md b/@vates/multi-key-map/.USAGE.md
similarity index 100%
rename from @vates/multi-key-map/USAGE.md
rename to @vates/multi-key-map/.USAGE.md
diff --git a/@vates/parse-duration/USAGE.md b/@vates/parse-duration/.USAGE.md
similarity index 100%
rename from @vates/parse-duration/USAGE.md
rename to @vates/parse-duration/.USAGE.md
diff --git a/@vates/predicates/USAGE.md b/@vates/predicates/.USAGE.md
similarity index 100%
rename from @vates/predicates/USAGE.md
rename to @vates/predicates/.USAGE.md
diff --git a/@vates/read-chunk/USAGE.md b/@vates/read-chunk/.USAGE.md
similarity index 100%
rename from @vates/read-chunk/USAGE.md
rename to @vates/read-chunk/.USAGE.md
diff --git a/@vates/toggle-scripts/USAGE.md b/@vates/toggle-scripts/.USAGE.md
similarity index 100%
rename from @vates/toggle-scripts/USAGE.md
rename to @vates/toggle-scripts/.USAGE.md
diff --git a/@xen-orchestra/async-map/USAGE.md b/@xen-orchestra/async-map/.USAGE.md
similarity index 100%
rename from @xen-orchestra/async-map/USAGE.md
rename to @xen-orchestra/async-map/.USAGE.md
diff --git a/@xen-orchestra/audit-core/USAGE.md b/@xen-orchestra/audit-core/.USAGE.md
similarity index 100%
rename from @xen-orchestra/audit-core/USAGE.md
rename to @xen-orchestra/audit-core/.USAGE.md
diff --git a/@xen-orchestra/babel-config/USAGE.md b/@xen-orchestra/babel-config/.USAGE.md
similarity index 100%
rename from @xen-orchestra/babel-config/USAGE.md
rename to @xen-orchestra/babel-config/.USAGE.md
diff --git a/@xen-orchestra/backups-cli/USAGE.md b/@xen-orchestra/backups-cli/.USAGE.md
similarity index 100%
rename from @xen-orchestra/backups-cli/USAGE.md
rename to @xen-orchestra/backups-cli/.USAGE.md
diff --git a/@xen-orchestra/backups/USAGE.md b/@xen-orchestra/backups/.USAGE.md
similarity index 100%
rename from @xen-orchestra/backups/USAGE.md
rename to @xen-orchestra/backups/.USAGE.md
diff --git a/@xen-orchestra/cr-seed-cli/USAGE.md b/@xen-orchestra/cr-seed-cli/.USAGE.md
similarity index 100%
rename from @xen-orchestra/cr-seed-cli/USAGE.md
rename to @xen-orchestra/cr-seed-cli/.USAGE.md
diff --git a/@xen-orchestra/cron/USAGE.md b/@xen-orchestra/cron/.USAGE.md
similarity index 100%
rename from @xen-orchestra/cron/USAGE.md
rename to @xen-orchestra/cron/.USAGE.md
diff --git a/@xen-orchestra/defined/USAGE.md b/@xen-orchestra/defined/.USAGE.md
similarity index 100%
rename from @xen-orchestra/defined/USAGE.md
rename to @xen-orchestra/defined/.USAGE.md
diff --git a/@xen-orchestra/emit-async/USAGE.md b/@xen-orchestra/emit-async/.USAGE.md
similarity index 100%
rename from @xen-orchestra/emit-async/USAGE.md
rename to @xen-orchestra/emit-async/.USAGE.md
diff --git a/@xen-orchestra/fs/USAGE.md b/@xen-orchestra/fs/.USAGE.md
similarity index 100%
rename from @xen-orchestra/fs/USAGE.md
rename to @xen-orchestra/fs/.USAGE.md
diff --git a/@xen-orchestra/log/USAGE.md b/@xen-orchestra/log/.USAGE.md
similarity index 100%
rename from @xen-orchestra/log/USAGE.md
rename to @xen-orchestra/log/.USAGE.md
diff --git a/@xen-orchestra/mixin/USAGE.md b/@xen-orchestra/mixin/.USAGE.md
similarity index 100%
rename from @xen-orchestra/mixin/USAGE.md
rename to @xen-orchestra/mixin/.USAGE.md
diff --git a/@xen-orchestra/mixins/USAGE.md b/@xen-orchestra/mixins/.USAGE.md
similarity index 100%
rename from @xen-orchestra/mixins/USAGE.md
rename to @xen-orchestra/mixins/.USAGE.md
diff --git a/@xen-orchestra/openflow/USAGE.md b/@xen-orchestra/openflow/.USAGE.md
similarity index 100%
rename from @xen-orchestra/openflow/USAGE.md
rename to @xen-orchestra/openflow/.USAGE.md
diff --git a/@xen-orchestra/proxy-cli/USAGE.md b/@xen-orchestra/proxy-cli/.USAGE.md
similarity index 100%
rename from @xen-orchestra/proxy-cli/USAGE.md
rename to @xen-orchestra/proxy-cli/.USAGE.md
diff --git a/@xen-orchestra/proxy/USAGE.md b/@xen-orchestra/proxy/.USAGE.md
similarity index 100%
rename from @xen-orchestra/proxy/USAGE.md
rename to @xen-orchestra/proxy/.USAGE.md
diff --git a/@xen-orchestra/self-signed/USAGE.md b/@xen-orchestra/self-signed/.USAGE.md
similarity index 100%
rename from @xen-orchestra/self-signed/USAGE.md
rename to @xen-orchestra/self-signed/.USAGE.md
diff --git a/@xen-orchestra/template/USAGE.md b/@xen-orchestra/template/.USAGE.md
similarity index 100%
rename from @xen-orchestra/template/USAGE.md
rename to @xen-orchestra/template/.USAGE.md
diff --git a/@xen-orchestra/upload-ova/USAGE.md b/@xen-orchestra/upload-ova/.USAGE.md
similarity index 100%
rename from @xen-orchestra/upload-ova/USAGE.md
rename to @xen-orchestra/upload-ova/.USAGE.md
diff --git a/@xen-orchestra/xapi/USAGE.md b/@xen-orchestra/xapi/.USAGE.md
similarity index 100%
rename from @xen-orchestra/xapi/USAGE.md
rename to @xen-orchestra/xapi/.USAGE.md
diff --git a/packages/complex-matcher/USAGE.md b/packages/complex-matcher/.USAGE.md
similarity index 100%
rename from packages/complex-matcher/USAGE.md
rename to packages/complex-matcher/.USAGE.md
diff --git a/packages/value-matcher/USAGE.md b/packages/value-matcher/.USAGE.md
similarity index 100%
rename from packages/value-matcher/USAGE.md
rename to packages/value-matcher/.USAGE.md
diff --git a/packages/vhd-cli/USAGE.md b/packages/vhd-cli/.USAGE.md
similarity index 100%
rename from packages/vhd-cli/USAGE.md
rename to packages/vhd-cli/.USAGE.md
diff --git a/packages/vhd-lib/USAGE.md b/packages/vhd-lib/.USAGE.md
similarity index 100%
rename from packages/vhd-lib/USAGE.md
rename to packages/vhd-lib/.USAGE.md
diff --git a/packages/xapi-explore-sr/USAGE.md b/packages/xapi-explore-sr/.USAGE.md
similarity index 100%
rename from packages/xapi-explore-sr/USAGE.md
rename to packages/xapi-explore-sr/.USAGE.md
diff --git a/packages/xen-api/USAGE.md b/packages/xen-api/.USAGE.md
similarity index 100%
rename from packages/xen-api/USAGE.md
rename to packages/xen-api/.USAGE.md
diff --git a/packages/xo-acl-resolver/USAGE.md b/packages/xo-acl-resolver/.USAGE.md
similarity index 100%
rename from packages/xo-acl-resolver/USAGE.md
rename to packages/xo-acl-resolver/.USAGE.md
diff --git a/packages/xo-cli/USAGE.md b/packages/xo-cli/.USAGE.md
similarity index 100%
rename from packages/xo-cli/USAGE.md
rename to packages/xo-cli/.USAGE.md
diff --git a/packages/xo-collection/USAGE.md b/packages/xo-collection/.USAGE.md
similarity index 100%
rename from packages/xo-collection/USAGE.md
rename to packages/xo-collection/.USAGE.md
diff --git a/packages/xo-common/USAGE.md b/packages/xo-common/.USAGE.md
similarity index 100%
rename from packages/xo-common/USAGE.md
rename to packages/xo-common/.USAGE.md
diff --git a/packages/xo-import-servers-csv/USAGE.md b/packages/xo-import-servers-csv/.USAGE.md
similarity index 100%
rename from packages/xo-import-servers-csv/USAGE.md
rename to packages/xo-import-servers-csv/.USAGE.md
diff --git a/packages/xo-lib/USAGE.md b/packages/xo-lib/.USAGE.md
similarity index 100%
rename from packages/xo-lib/USAGE.md
rename to packages/xo-lib/.USAGE.md
diff --git a/packages/xo-remote-parser/USAGE.md b/packages/xo-remote-parser/.USAGE.md
similarity index 100%
rename from packages/xo-remote-parser/USAGE.md
rename to packages/xo-remote-parser/.USAGE.md
diff --git a/packages/xo-server-audit/USAGE.md b/packages/xo-server-audit/.USAGE.md
similarity index 100%
rename from packages/xo-server-audit/USAGE.md
rename to packages/xo-server-audit/.USAGE.md
diff --git a/packages/xo-server-auth-github/USAGE.md b/packages/xo-server-auth-github/.USAGE.md
similarity index 100%
rename from packages/xo-server-auth-github/USAGE.md
rename to packages/xo-server-auth-github/.USAGE.md
diff --git a/packages/xo-server-auth-google/USAGE.md b/packages/xo-server-auth-google/.USAGE.md
similarity index 100%
rename from packages/xo-server-auth-google/USAGE.md
rename to packages/xo-server-auth-google/.USAGE.md
diff --git a/packages/xo-server-auth-ldap/USAGE.md b/packages/xo-server-auth-ldap/.USAGE.md
similarity index 100%
rename from packages/xo-server-auth-ldap/USAGE.md
rename to packages/xo-server-auth-ldap/.USAGE.md
diff --git a/packages/xo-server-auth-saml/USAGE.md b/packages/xo-server-auth-saml/.USAGE.md
similarity index 100%
rename from packages/xo-server-auth-saml/USAGE.md
rename to packages/xo-server-auth-saml/.USAGE.md
diff --git a/packages/xo-server-backup-reports/USAGE.md b/packages/xo-server-backup-reports/.USAGE.md
similarity index 100%
rename from packages/xo-server-backup-reports/USAGE.md
rename to packages/xo-server-backup-reports/.USAGE.md
diff --git a/packages/xo-server-load-balancer/USAGE.md b/packages/xo-server-load-balancer/.USAGE.md
similarity index 100%
rename from packages/xo-server-load-balancer/USAGE.md
rename to packages/xo-server-load-balancer/.USAGE.md
diff --git a/packages/xo-server-netbox/USAGE.md b/packages/xo-server-netbox/.USAGE.md
similarity index 100%
rename from packages/xo-server-netbox/USAGE.md
rename to packages/xo-server-netbox/.USAGE.md
diff --git a/packages/xo-server-perf-alert/USAGE.md b/packages/xo-server-perf-alert/.USAGE.md
similarity index 100%
rename from packages/xo-server-perf-alert/USAGE.md
rename to packages/xo-server-perf-alert/.USAGE.md
diff --git a/packages/xo-server-sdn-controller/USAGE.md b/packages/xo-server-sdn-controller/.USAGE.md
similarity index 100%
rename from packages/xo-server-sdn-controller/USAGE.md
rename to packages/xo-server-sdn-controller/.USAGE.md
diff --git a/packages/xo-server-test/USAGE.md b/packages/xo-server-test/.USAGE.md
similarity index 100%
rename from packages/xo-server-test/USAGE.md
rename to packages/xo-server-test/.USAGE.md
diff --git a/packages/xo-server-transport-email/USAGE.md b/packages/xo-server-transport-email/.USAGE.md
similarity index 100%
rename from packages/xo-server-transport-email/USAGE.md
rename to packages/xo-server-transport-email/.USAGE.md
diff --git a/packages/xo-server-transport-icinga2/USAGE.md b/packages/xo-server-transport-icinga2/.USAGE.md
similarity index 100%
rename from packages/xo-server-transport-icinga2/USAGE.md
rename to packages/xo-server-transport-icinga2/.USAGE.md
diff --git a/packages/xo-server-transport-nagios/USAGE.md b/packages/xo-server-transport-nagios/.USAGE.md
similarity index 100%
rename from packages/xo-server-transport-nagios/USAGE.md
rename to packages/xo-server-transport-nagios/.USAGE.md
diff --git a/packages/xo-server-transport-slack/USAGE.md b/packages/xo-server-transport-slack/.USAGE.md
similarity index 100%
rename from packages/xo-server-transport-slack/USAGE.md
rename to packages/xo-server-transport-slack/.USAGE.md
diff --git a/packages/xo-server-transport-xmpp/USAGE.md b/packages/xo-server-transport-xmpp/.USAGE.md
similarity index 100%
rename from packages/xo-server-transport-xmpp/USAGE.md
rename to packages/xo-server-transport-xmpp/.USAGE.md
diff --git a/packages/xo-server-usage-report/USAGE.md b/packages/xo-server-usage-report/.USAGE.md
similarity index 100%
rename from packages/xo-server-usage-report/USAGE.md
rename to packages/xo-server-usage-report/.USAGE.md
diff --git a/packages/xo-server-web-hooks/USAGE.md b/packages/xo-server-web-hooks/.USAGE.md
similarity index 100%
rename from packages/xo-server-web-hooks/USAGE.md
rename to packages/xo-server-web-hooks/.USAGE.md
diff --git a/packages/xo-vmdk-to-vhd/USAGE.md b/packages/xo-vmdk-to-vhd/.USAGE.md
similarity index 100%
rename from packages/xo-vmdk-to-vhd/USAGE.md
rename to packages/xo-vmdk-to-vhd/.USAGE.md
diff --git a/scripts/normalize-packages b/scripts/normalize-packages
index bf962f5f2..2d4505766 100755
--- a/scripts/normalize-packages
+++ b/scripts/normalize-packages
@@ -124,7 +124,7 @@ require('exec-promise')(() =>
 
     return Promise.all([
       forceRelativeSymlink(NPMIGNORE_PATH, `${dir}/.npmignore`),
-      readFile(`${dir}/USAGE.md`, 'utf8')
+      readFile(`${dir}/.USAGE.md`, 'utf8')
         .then(content =>
           writeFile(
             `${dir}/README.md`,
diff --git a/scripts/npmignore b/scripts/npmignore
index 813df9e6f..adf2af52e 100644
--- a/scripts/npmignore
+++ b/scripts/npmignore
@@ -29,4 +29,3 @@ __snapshots__/
 
 /docs/
 /src/
-/USAGE.md