feat: Add skill structure validation script and CI job (#389)

* docs(plans): add skill structure validation implementation plan

Refs: #388

* feat(scripts): add skill structure validation foundation

Refs: #388

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat(scripts): add required file validation

Validates SKILL.md, *.test.md, and references/README.md existence.

Refs: #388

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat(scripts): add frontmatter validation

Validates name and description fields, ensures name matches directory.

Refs: #388

* feat(scripts): add required section validation

Validates Overview, When to Use, and Core Workflow sections exist.
Note: Some skills don't currently meet this standard.

Refs: #388

* feat(package): add validate:skills npm script

Refs: #388

* feat(ci): add skill structure validation job

Validates all skills have required files, frontmatter, and sections.

Refs: #388

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* chore(ci): make skill-validation non-blocking temporarily

Until existing skills are updated to comply with SKILL-FORMAT.md,
the validation job should not block PRs.

Refs: #388

* chore: trigger CI rerun

Refs: #388

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: mcj-coder

.github/workflows/ci.yml

@@ -42,6 +42,25 @@ jobs:
           find . -name '*.md' -not -path './node_modules/*' -not -path './.git/*' -not -path './.worktrees/*' | \
           xargs -n 1 npx markdown-link-check --config .markdown-link-check.json --quiet
 
+  skill-validation:
+    name: Skill Structure Validation
+    runs-on: ubuntu-latest
+    continue-on-error: true # TODO: Remove once skills comply with SKILL-FORMAT.md
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Validate skill structure
+        run: npm run validate:skills
+
   danger:
     name: DangerJS PR Validation
     runs-on: ubuntu-latest