update skill

Author: weidongxu-microsoft

.github/skills/migrate-sdk-typespec/SKILL.md

@@ -18,6 +18,7 @@ The "<tsp-project>" would be a relative path to a folder in specs repo. A typica
 - For TypeSpec project, only update "client.tsp" file and "tspconfig.yaml" file.
 - When updating "client.tsp", always use "java" scope, and add new lines to the end of the file.
 - For SDK project, do not modify Java file that contains `// Code generated` in the header comment. These are Java files generated by the emitter from TypeSpec project, and should not be modified by agent individually.
+- Run `tsp format <tsp_file>` command, whenever you modify the .tsp file, to make sure the format is correct.
 
 ## Required repositories
 
@@ -104,6 +105,8 @@ in SDK repo root folder.
 
 This script will generate the Java code, and build the Java lib. It may encounter compile error that you need to fix in next step.
 
+PS: this script can take a while to run. If you wait for the command, wait a maximum of 20 minutes.
+
 #### Fix compile error
 
 See [Solve Compile Error](./solve-compile-error.md) for common compile errors and mitigation.
@@ -135,3 +138,50 @@ See [Solve Revapi Error](./solve-revapi-error.md) for mitigation.
 
 When you finished this step, pause and output report on remaining errors.
 Use the `git diff` with "main" branch, to provide the details on what you think be the cause of the error.
+
+### Update "CHANGELOG.md"
+
+This step should be invoked by user, not by agent.
+
+Remove all generated content in the section of latest lib version of "CHANGELOG.md" file. Also, update the date to "Unreleased".
+
+Then, add a new "Breaking Changes" sub section in this lib version section. The general items of this would be supplied by user.
+
+```
+### Breaking Changes
+
+- Removed `<class>` class. <reason>
+- Removed `<method>` method from `<class>` class. <reason>
+- Changed `<method>` method to `<new_method>` in class `<class>` class. <reason>
+etc.
+```
+
+### Create pull request and finalize the sdk lib
+
+This step should be invoked by user, not by agent.
+
+#### Verify filename is consistent on GitHub and on filesystem
+
+Make sure the filename on GitHub is consistent with the filename on filesystem (typical reason is that Windows filename is case-insensitive, but git is case-sensitive). If not, use `git mv` command to rename the file on git to make them consistent.
+
+#### Revert change to "eng/versioning/version_client.txt" file and "sdk/resourcemanager" folder
+
+Checkout the content from "main" branch. We are not releasing the lib, hence no need to update the versions.
+
+Use `git checkout main --no-overlay -- sdk/resourcemanager/azure-resourcemanager` to revert "sdk/resourcemanager" folder.
+
+#### Create pull request on specs repo
+
+Create a draft pull request in specs repo.
+
+#### Update "tsp-location.yaml" file, create pull request on sdk repo
+
+When the pull request on specs repo is ready, get the SHA of the last commit.
+
+Update the "commit" property of the "tsp-location.yaml" file in sdk repo, to make it point to this SHA.
+
+Commit the change, and create a draft pull request in sdk repo.
+
+#### Update "tsp-location.yaml" file the last time
+
+When the pull request on specs repo is merged, update the "commit" property of the "tsp-location.yaml" file in sdk repo to point to the SHA on latest "main" branch of specs repo.