Improve scripts and provide instructions

[leahjlou]

• provide instructions to run scripts properly, possibly run them automatically on a pre-commit hook
• scripts/generate-metadata should output the metadata.json file always at the root of the project