Adding a staging skill

.agents/skills/stage-site/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: stage-site
+description: >-
+  Stages the Flutter site locally. This includes checking for broken links,
+  verifying excerpts, updating formatting, and serving the dev site.
+---
+
+# Stage the Flutter site
+
+Before committing changes or reviewing a PR locally,
+it is important to stage the site and ensure everything works correctly. 
+Follow these steps to stage the site:
+
+## 1. Check for broken links
+
+Run the following command to check for any unlinked or broken
+Markdown link references in the site output:
+
+```bash
+dart run dash_site check-link-references
+```
+
+Alternatively, to verify all links between pages on the site work:
+
+```bash
+dart run dash_site check-links
+```
+
+If any broken links are found, try to patch them or alert the user.
+
+## 2. Sync code excerpts
+
+Ensure that any changed code excerpts are properly run and synced to the Markdown files:
+
+```bash
+dart run dash_site refresh-excerpts
+```
+
+## 3. Update formatting
+
+Update the formatting of the site examples and tools to ensure
+they follow the official Dart format:
+
+```bash
+dart run dash_site format-dart
+```
+
+## 4. Stage the site locally
+
+Finally, serve a local development server of the site so the user can preview the changes:
+
+```bash
+dart run dash_site serve
+```