diff --git a/README.md b/README.md
index 7bee142..44a3c31 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,12 @@
 # Agent Skills by @rodydavis
 
-### flutter-control-and-screenshot
-Guide on how to control a Flutter app using flutter_driver via MCP and capture screenshots.
+Install skills with https://skills.sh/
 
-```bash
-npx skills add rodydavis/flutter-control-and-screenshot
-```
-
-### install-flutter-from-git
-Install Flutter SDK via git clone and configure for all platforms
-
-```bash
-npx skills add rodydavis/install-flutter-from-git
+```
+npx skills add rodydavis/skills
 ```
 
+| Skill | Description | Command |
+|---|---|---|
+| [flutter-control-and-screenshot](./skills/flutter_driver_control/SKILL.md) | Guide on how to control a Flutter app using flutter_driver via MCP and capture screenshots. | `npx skills add rodydavis/flutter-control-and-screenshot` |
+| [install-flutter-from-git](./skills/install-flutter-from-git/SKILL.md) | Install Flutter SDK via git clone and configure for all platforms | `npx skills add rodydavis/install-flutter-from-git` |
diff --git a/scripts/update_readme.js b/scripts/update_readme.js
index ed648f7..d0d6794 100644
--- a/scripts/update_readme.js
+++ b/scripts/update_readme.js
@@ -60,6 +60,10 @@ let readmeContent = `# Agent Skills by @rodydavis
 
 Install skills with https://skills.sh/
 
+\`\`\`
+npx skills add rodydavis/skills
+\`\`\`
+
 `;
 
 function main() {
@@ -67,21 +71,22 @@ function main() {
     const skillFiles = findSkillFiles(skillsDir);
 
 
+
+    readmeContent += '| Skill | Description | Command |\n';
+    readmeContent += '|---|---|---|\n';
+
     skillFiles.forEach(file => {
         const content = fs.readFileSync(file, 'utf8');
         const frontmatter = parseFrontmatter(content);
 
         if (frontmatter && frontmatter.name) {
             console.log(`Found skill: ${frontmatter.name}`);
+            const relativePath = path.relative(path.dirname(readmePath), file);
 
-            readmeContent += `### ${frontmatter.name}\n`;
-            if (frontmatter.description) {
-                readmeContent += `${frontmatter.description}\n\n`;
-            }
+            // Escape pipes in description just in case
+            const description = (frontmatter.description || '').replace(/\|/g, '\\|');
 
-            readmeContent += '```bash\n';
-            readmeContent += `npx skills add rodydavis/${frontmatter.name}\n`;
-            readmeContent += '```\n\n';
+            readmeContent += `| [${frontmatter.name}](./${relativePath}) | ${description} | \`npx skills add rodydavis/${frontmatter.name}\` |\n`;
         }
     });