chore: update CI with validate-skills and markdown checks (#58)

Author: ryzizub

.github/PULL_REQUEST_TEMPLATE.md

@@ -11,4 +11,4 @@
 - [ ] Code refactor (`refactor`)
 - [ ] Documentation (`docs`)
 - [ ] CI change (`ci`)
-- [ ] Chore (`chore`)
+- [ ] Chore (`chore`)

.github/workflows/ci.yaml

@@ -6,34 +6,76 @@ on:
       - main
 
 jobs:
+  markdown:
+    name: 📝 Markdown Quality
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Lint Markdown
+        uses: DavidAnson/markdownlint-cli2-action@v19
+        with:
+          globs: '**/*.md'
+          config: 'config/custom.markdownlint.jsonc'
   spelling:
-      name: ✍️ Spelling Check
-      runs-on: ubuntu-latest
-      steps:
-        - uses: actions/checkout@v4
-        - name: Spell Check
-          uses: streetsidesoftware/cspell-action@v6
-          with:
-            files: '**/*.md'
-            config: 'config/cspell.json'
-  structure:
-    name: 🏗️ Structure Validation
+    name: ✍️ Spelling Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Spell Check Code
+        uses: streetsidesoftware/cspell-action@v6
+        with:
+          files: '**/*.md'
+          config: 'config/cspell.json'
+  detect-changed-skills:
+    name: 🔎 Detect Changed Skills
     runs-on: ubuntu-latest
+    outputs:
+      skills: ${{ steps.changed-skills.outputs.skills }}
     steps:
       - uses: actions/checkout@v4
-      - name: Check For Large Files (under 50KB)
-        run: bash ./scripts/check_large_files.sh
-  skill-validation:
-    name: 📋 Skill Validation
+        with:
+          fetch-depth: 0
+      - name: Get changed skills
+        id: changed-skills
+        run: |
+          BASE=${{ github.event.pull_request.base.sha }}
+          HEAD=${{ github.event.pull_request.head.sha }}
+          SKILLS=$(git diff --name-only $BASE $HEAD | \
+            { grep 'SKILL.md' || true; } | \
+            xargs -I {} dirname {} | \
+            sort -u | \
+            jq -R -s -c 'split("\n") | map(select(length > 0))')
+          echo "skills=$SKILLS" >> "$GITHUB_OUTPUT"
+          echo "Changed skills: $SKILLS"
+  validate-skills:
+    name: 🔍 Validate Skills
+    needs: detect-changed-skills
+    if: needs.detect-changed-skills.outputs.skills != '[]'
     runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        skill: ${{ fromJson(needs.detect-changed-skills.outputs.skills) }}
     steps:
       - uses: actions/checkout@v4
-      - name: Validate SKILL.md Files
-        run: bash ./scripts/validate_skills.sh
+      - name: Validate ${{ matrix.skill }}
+        id: validate
+        uses: Flash-Brew-Digital/validate-skill@v1
+        with:
+          path: ${{ matrix.skill }}
+          validate-references: 'true'
+          fail-on-warning: 'true'
+          ignore-rules: 'name-match-directory,unknown-field'
+      - name: Check results
+        if: always()
+        run: |
+          echo "Valid: ${{ steps.validate.outputs.valid }}"
+          echo "Errors: ${{ steps.validate.outputs.errors }}"
+          echo "Warnings: ${{ steps.validate.outputs.warnings }}"
   manifest-validation:
     name: 📦 Manifest Validation
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - name: Validate Plugin Manifest
-        run: bash ./scripts/validate_plugin_manifest.sh
+        run: bash ./scripts/validate_plugin_manifest.sh

CLAUDE.md

@@ -8,7 +8,7 @@ Very Good AI Flutter Plugin is a Claude Code plugin that provides best-practices
 
 ## Repository Structure
 
-```
+```text
 .mcp.json                # MCP server configuration (Very Good CLI)
 .claude-plugin/
   plugin.json          # Plugin manifest (name, version, tags)

CODE_OF_CONDUCT.md

@@ -55,7 +55,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at hello@verygood.ventures. All
+reported by contacting the project team at <hello@verygood.ventures>. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.
@@ -68,9 +68,9 @@ members of the project's leadership.
 ## Attribution
 
 This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+available at <https://www.contributor-covenant.org/version/1/4/code-of-conduct.html>
 
 [homepage]: https://www.contributor-covenant.org
 
 For answers to common questions about this code of conduct, see
-https://www.contributor-covenant.org/faq/
+<https://www.contributor-covenant.org/faq/>

CONTRIBUTING.md

@@ -86,7 +86,7 @@ If the spelling check flags a legitimate word, add it to `config/cspell.json` in
 
 Use [Conventional Commits](https://www.conventionalcommits.org/) with the format:
 
-```
+```text
 type(scope): description
 ```
 

README.md

@@ -119,4 +119,4 @@ The `.mcp.json` file at the project root registers a `very-good-cli` MCP server
 [very_good_ventures_link_dark]: https://verygood.ventures#gh-dark-mode-only
 [very_good_ventures_link_light]: https://verygood.ventures#gh-light-mode-only
 [logo_black]: https://raw.githubusercontent.com/VGVentures/very_good_brand/main/styles/README/vgv_logo_black.png#gh-light-mode-only
-[logo_white]: https://raw.githubusercontent.com/VGVentures/very_good_brand/main/styles/README/vgv_logo_white.png#gh-dark-mode-only
+[logo_white]: https://raw.githubusercontent.com/VGVentures/very_good_brand/main/styles/README/vgv_logo_white.png#gh-dark-mode-only

config/cspell.json

@@ -17,6 +17,7 @@
     "jailbroken",
     "LTRB",
     "mapbox",
+    "microtasks",
     "mocktail",
     "monorepo",
     "Mundo",

config/custom.markdownlint.jsonc

@@ -0,0 +1,8 @@
+{
+  "MD009": false,
+  "MD013": false,
+  "MD032": false,
+  "MD033": false,
+  "MD036": false,
+  "MD041": false
+}