docs: beautify README (#13)

Author: SoonIter

README.md

@@ -1,61 +1,66 @@
 # Agent Skills
 
-A collection of Agent Skills for [Rstack](https://rspack.rs/guide/start/ecosystem#rstack).
+<p>
+  <a href="https://discord.gg/XsaKEEk4mW"><img src="https://img.shields.io/badge/chat-discord-blue?style=flat-square&logo=discord&colorA=564341&colorB=EDED91" alt="discord channel" /></a>
+  <a href="https://github.com/rstackjs/agent-skills/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square&colorA=564341&colorB=EDED91" alt="license" /></a>
+  <a href="https://github.com/rstackjs/agent-skills"><img src="https://img.shields.io/github/stars/rstackjs/agent-skills?style=flat-square&colorA=564341&colorB=EDED91" alt="stars" /></a>
+  <a href="https://github.com/rstackjs/agent-skills/issues"><img src="https://img.shields.io/github/issues/rstackjs/agent-skills?style=flat-square&colorA=564341&colorB=EDED91" alt="issues" /></a>
+</p>
 
-## Rspack Skills
+A collection of Agent Skills for [Rstack](https://rspack.rs/guide/start/ecosystem#rstack).
 
-### rspack-debugging
+> AI-powered skills for debugging, tracing, upgrading, and analyzing Rstack projects.
 
-```bash
-npx skills add rstackjs/agent-skills --skill rspack-debugging
-```
+## Table of Contents
 
-Helps Rspack users and developers debug crashes or deadlocks/hangs in the Rspack build process using LLDB.
+- [Usage](#usage)
+- [Skills](#skills)
+  - [Rspack](#rspack)
+  - [Rsbuild](#rsbuild)
+  - [Rspress](#rspress)
+  - [Rsdoctor](#rsdoctor)
+- [Contributing](#contributing)
+- [License](#license)
 
-Use this Skill when users encounter "Segmentation fault" errors during Rspack builds or when the build progress gets stuck.
+## Usage
 
-### rspack-tracing
+Install any skill with:
 
 ```bash
-npx skills add rstackjs/agent-skills --skill rspack-tracing
+npx skills add rstackjs/agent-skills --skill <skill-name>
 ```
 
-Comprehensive guide and toolkit for diagnosing Rspack build issues. Quickly identify where crashes/errors occur, or perform detailed performance profiling to resolve bottlenecks.
-
-Use when the user encounters build failures, slow builds, or wants to optimize Rspack performance.
-
-## Rsbuild Skills
-
-### rsbuild-v2-upgrade
+## Skills
 
-```bash
-npx skills add rstackjs/agent-skills --skill rsbuild-v2-upgrade
-```
+### Rspack
 
-Migrate Rsbuild projects from v1 to v2. Use when a user asks to upgrade Rsbuild, follow the v1-to-v2 guide, update configs/plugins, or validate the upgrade.
+| Skill              | Description                                                                      | Use When                                                 |
+| ------------------ | -------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| `rspack-debugging` | Debug crashes or deadlocks/hangs in Rspack builds using LLDB                     | Encountering "Segmentation fault" errors or build hangs  |
+| `rspack-tracing`   | Diagnose Rspack build issues with crash identification and performance profiling | Build failures, slow builds, or performance optimization |
 
-## Rspress Skills
+### Rsbuild
 
-### rspress-v2-upgrade
+| Skill                | Description                            | Use When                                                               |
+| -------------------- | -------------------------------------- | ---------------------------------------------------------------------- |
+| `rsbuild-v2-upgrade` | Migrate Rsbuild projects from v1 to v2 | Upgrading Rsbuild, updating configs/plugins, or validating the upgrade |
 
-```bash
-npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade
-```
+### Rspress
 
-Migrate Rspress projects from v1 to v2. Use when a user asks to upgrade Rspress, follow the v1-to-v2 guide, update packages/configs/themes, or validate the upgrade.
+| Skill                | Description                            | Use When                                                                       |
+| -------------------- | -------------------------------------- | ------------------------------------------------------------------------------ |
+| `rspress-v2-upgrade` | Migrate Rspress projects from v1 to v2 | Upgrading Rspress, updating packages/configs/themes, or validating the upgrade |
 
-## Rsdoctor Skills
+### Rsdoctor
 
-### rsdoctor-analysis
-
-```bash
-npx skills add rstackjs/agent-skills --skill rsdoctor-analysis
-```
+| Skill               | Description                                                   | Use When                                                                                                         |
+| ------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `rsdoctor-analysis` | Analyze Rspack/Webpack bundles for insights and optimizations | Analyzing bundle composition, duplicates, large chunks, side-effect modules, or for optimization recommendations |
 
-Analyze Rspack/Webpack bundles from local Rsdoctor build data. Provides intelligent analysis of chunk, module, package, and loader data. Provides evidence-based conclusions and actionable optimization recommendations.
+## Contributing
 
-Use when you need to analyze bundle composition, identify duplicate packages, detect similar packages, find large chunks, analyze side effects modules, or get comprehensive bundle optimization recommendations.
+Contributions are welcome! Feel free to open an [issue](https://github.com/rstackjs/agent-skills/issues) or submit a [pull request](https://github.com/rstackjs/agent-skills/pulls).
 
 ## License
 
-MIT licensed.
+[MIT](./LICENSE)