From 5a7c4bfcd0b6d8defbc79eaa4480d1f704fd59c1 Mon Sep 17 00:00:00 2001 From: "Shams Zakhour (ignore Sfshaza)" Date: Wed, 11 Mar 2026 11:34:25 -0700 Subject: [PATCH 1/4] Adding a staging skill --- .agents/skills/stage-site/SKILL.md | 54 ++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 .agents/skills/stage-site/SKILL.md diff --git a/.agents/skills/stage-site/SKILL.md b/.agents/skills/stage-site/SKILL.md new file mode 100644 index 0000000000..6e61bad0df --- /dev/null +++ b/.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 +``` From 24906be7713996ed92c5549555351d51f6555c00 Mon Sep 17 00:00:00 2001 From: "Shams Zakhour (ignore Sfshaza)" Date: Wed, 11 Mar 2026 11:59:53 -0700 Subject: [PATCH 2/4] Reordering --- .agents/skills/stage-site/SKILL.md | 32 +++++++++++++++--------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/.agents/skills/stage-site/SKILL.md b/.agents/skills/stage-site/SKILL.md index 6e61bad0df..bcf0664762 100644 --- a/.agents/skills/stage-site/SKILL.md +++ b/.agents/skills/stage-site/SKILL.md @@ -11,40 +11,40 @@ 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 +## 1. Sync code excerpts -Run the following command to check for any unlinked or broken -Markdown link references in the site output: +Ensure that any changed code excerpts are properly run and synced to the Markdown files: ```bash -dart run dash_site check-link-references +dart run dash_site refresh-excerpts ``` -Alternatively, to verify all links between pages on the site work: +## 2. Update formatting + +Update the formatting of the site examples and tools to ensure +they follow the official Dart format: ```bash -dart run dash_site check-links +dart run dash_site format-dart ``` -If any broken links are found, try to patch them or alert the user. - -## 2. Sync code excerpts +## 3. Check for broken links -Ensure that any changed code excerpts are properly run and synced to the Markdown files: +Run the following command to check for any unlinked or broken +Markdown link references in the site output: ```bash -dart run dash_site refresh-excerpts +dart run dash_site check-link-references ``` -## 3. Update formatting - -Update the formatting of the site examples and tools to ensure -they follow the official Dart format: +Alternatively, to verify all links between pages on the site work: ```bash -dart run dash_site format-dart +dart run dash_site check-links ``` +If any broken links are found, try to patch them or alert the user. + ## 4. Stage the site locally Finally, serve a local development server of the site so the user can preview the changes: From 49d91e10a21cecad17340c1b5e0934775bfc6f88 Mon Sep 17 00:00:00 2001 From: "Shams Zakhour (ignore Sfshaza)" Date: Wed, 11 Mar 2026 12:01:19 -0700 Subject: [PATCH 3/4] Incorporating feedback --- .agents/skills/stage-site/SKILL.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/.agents/skills/stage-site/SKILL.md b/.agents/skills/stage-site/SKILL.md index bcf0664762..e660ecbdbe 100644 --- a/.agents/skills/stage-site/SKILL.md +++ b/.agents/skills/stage-site/SKILL.md @@ -37,12 +37,6 @@ Markdown link references in the site output: 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. ## 4. Stage the site locally From bb9f62f3f68cfdda8139aa620d9d73188088da1e Mon Sep 17 00:00:00 2001 From: "Shams Zakhour (ignore Sfshaza)" Date: Fri, 13 Mar 2026 10:14:47 -0700 Subject: [PATCH 4/4] Incorporating tweaks after talking to Parker --- .agents/skills/{stage-site => validate-pr}/SKILL.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) rename .agents/skills/{stage-site => validate-pr}/SKILL.md (96%) diff --git a/.agents/skills/stage-site/SKILL.md b/.agents/skills/validate-pr/SKILL.md similarity index 96% rename from .agents/skills/stage-site/SKILL.md rename to .agents/skills/validate-pr/SKILL.md index e660ecbdbe..1e27a3362b 100644 --- a/.agents/skills/stage-site/SKILL.md +++ b/.agents/skills/validate-pr/SKILL.md @@ -1,5 +1,5 @@ --- -name: stage-site +name: validate-pr description: >- Stages the Flutter site locally. This includes checking for broken links, verifying excerpts, updating formatting, and serving the dev site. @@ -13,7 +13,8 @@ Follow these steps to stage the site: ## 1. Sync code excerpts -Ensure that any changed code excerpts are properly run and synced to the Markdown files: +Ensure that any changed code excerpts are properly run and synced to the +Markdown files: ```bash dart run dash_site refresh-excerpts