Revise README for better guidance and organization

Author: alexbit-codemod

README.md

@@ -1,37 +1,43 @@
-<div align="center">
-  <img src=".github/assets/migrations-template.png" alt="<ECOSYSTEM_NAME> Codemods" />
-</div>
-
 > **Remove this section once the repo is customized**
-> Framework/SDK maintainers: This template comes with setup guides, utilities, and a GitHub Action to help you and your community build and publish codemods with ease. Once you, the repo maintainers, approve codemod PRs, they’ll be automatically published as official codemods to the [Codemod Registry](https://app.codemod.com/registry) under your org scope. Check out the [Node.js codemods](https://codemod.link/nodejs-official) for an example. See [AUTO_PUBLISH_SETUP.md](.github/AUTO_PUBLISH_SETUP.md) for setup instructions.
+> 
+> Framework/SDK maintainers: This template comes with setup guides, utilities, and a GitHub Action to help you and your community build and publish codemods with ease. After the set up, once you approve codemod PRs, they’ll be automatically published as official codemods to the [Codemod Registry](https://app.codemod.com/registry) under your org scope. Check out the [Node.js codemods](https://codemod.link/nodejs-official) for an example. See [AUTO_PUBLISH_SETUP.md](.github/AUTO_PUBLISH_SETUP.md) for setup instructions.
+
+Official <FRAMEWORK_OR_SDK_OR_ORG> codemods to help users adopt new features and handle breaking changes with ease.
 
-This repository contains codemods for <FRAMEWORK_OR_SDK_NAME>. These codemods facilitate adopting new features and upgrading across breaking changes.
+Community contributions are welcome and appreciated! Check open issues for codemods to build, or open a new one if something’s missing. See the [contribution guide](./CONTRIBUTING.md) for details.
 
 
 ## Running codemods
 > [!CAUTION]
-> Codemods edit your code. Run them only on files tracked by Git, and make sure to commit or stash your changes first.
+> Caution: Codemods modify code! Run them only on Git-tracked files, and commit or stash changes first.
+### From the registry 
+Recommended for better UX, downloads the package from [registry](https://app.codemod.com/registry).
 
-Run codemods from the registry by using the names defined in their codemod.yaml:
 ```bash
 npx codemod@latest <codemod-name>
 ```
 For example: 
 ```
 npx codemod@latest @nodejs/tmpDir-to-tmpdir
 ```
-See the [Codemod documentation](https://go.codemod.com/cli-docs) for a full list of available CLI commands and options.
+### From the source 
+```bash
+npx codemod workflow run -w /path/to/folder/containing/workflow.yaml
+```
 
-## Contributing
+> [!NOTE]
+> By default, codemods run in the current folder. Add `-t /target/path` to your command to change it.
+
+
+See the [Codemod docs](https://go.codemod.com/cli-docs) for all CLI commands and options.
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md).
 
 ## Security
 
 See [SECURITY.md](./SECURITY.md).
 
+
 ## License
 
 MIT
 
-