feat(components/packages): add ai skills to workspace

libs/components/packages/collection.json

@@ -36,6 +36,11 @@
       "factory": "./src/schematics/ng-generate/remove-compat-stylesheets/remove-compat-stylesheets.schematic",
       "schema": "./src/schematics/ng-generate/remove-compat-stylesheets/schema.json"
     },
+    "add-ai-skills": {
+      "description": "Add SKY UX AI skills for Claude Code to your project.",
+      "factory": "./src/schematics/ng-generate/add-ai-skills/add-ai-skills.schematic",
+      "schema": "./src/schematics/ng-generate/add-ai-skills/schema.json"
+    },
     "standalone-migration": {
       "description": "Convert components to standalone using SKY UX modules.",
       "factory": "./src/schematics/ng-generate/standalone/standalone.schematic",

libs/components/packages/migrations.json

@@ -20,6 +20,11 @@
       "factory": "./src/schematics/migrations/all/workspace-check/workspace-check.schematic",
       "description": "Log warnings if the workspace is not configured correctly."
     },
+    "add-ai-skills": {
+      "version": "0.0.0-PLACEHOLDER",
+      "factory": "./src/schematics/migrations/update-14/add-ai-skills/add-ai-skills",
+      "description": "Add AI skills to the workspace"
+    },
     "uninstall-prettier-schematics": {
       "version": "14.0.0",
       "factory": "./src/schematics/migrations/update-14/uninstall-prettier-schematics/uninstall-prettier-schematics",

libs/components/packages/project.json

@@ -31,6 +31,7 @@
           "libs/components/packages/collection.json",
           "libs/components/packages/migrations.json",
           "libs/components/packages/src/polyfills.js",
+          "libs/components/packages/src/schematics/**/files/**/*",
           "libs/components/packages/src/schematics/**/schema.json",
           "libs/components/packages/src/schematics/**/*.template",
           "libs/components/packages/*.md"

libs/components/packages/src/schematics/migrations/update-14/add-ai-skills/add-ai-skills.ts

@@ -0,0 +1,5 @@
+import { Rule, externalSchematic } from '@angular-devkit/schematics';
+
+export default function addAiSkills(): Rule {
+  return externalSchematic('@skyux/packages', 'add-ai-skills', {});
+}

libs/components/packages/src/schematics/ng-generate/add-ai-skills/add-ai-skills.schematic.spec.ts

@@ -0,0 +1,236 @@
+import { SchematicTestRunner } from '@angular-devkit/schematics/testing';
+
+import { readFileSync, readdirSync, statSync } from 'fs';
+import { join, resolve } from 'path';
+
+import { createTestApp } from '../../testing/scaffold';
+
+describe('add-ai-skills', () => {
+  const runner = new SchematicTestRunner(
+    'schematics',
+    require.resolve('../../../../collection.json'),
+  );
+
+  it('should copy all skill files to .github/skills/', async () => {
+    const tree = await createTestApp(runner, { projectName: 'my-app' });
+
+    const resultTree = await runner.runSchematic('add-ai-skills', {}, tree);
+
+    // Verify all SKILL.md files exist.
+    expect(
+      resultTree.exists('.github/skills/skyux-migration-debugger/SKILL.md'),
+    ).toBe(true);
+    expect(
+      resultTree.exists(
+        '.github/skills/skyux-test-driven-development/SKILL.md',
+      ),
+    ).toBe(true);
+    expect(
+      resultTree.exists(
+        '.github/skills/skyux-verification-before-completion/SKILL.md',
+      ),
+    ).toBe(true);
+    expect(
+      resultTree.exists('.github/skills/skyux-project-modernization/SKILL.md'),
+    ).toBe(true);
+
+    // Verify all skyux-migration-debugger reference files are included.
+    expect(
+      resultTree.exists(
+        '.github/skills/skyux-migration-debugger/references/angular-debugging.md',
+      ),
+    ).toBe(true);
+    expect(
+      resultTree.exists(
+        '.github/skills/skyux-migration-debugger/references/condition-based-waiting.md',
+      ),
+    ).toBe(true);
+    expect(
+      resultTree.exists(
+        '.github/skills/skyux-migration-debugger/references/defense-in-depth.md',
+      ),
+    ).toBe(true);
+    expect(
+      resultTree.exists(
+        '.github/skills/skyux-migration-debugger/references/root-cause-tracing.md',
+      ),
+    ).toBe(true);
+
+    // Verify all skyux-project-modernization reference files are included.
+    expect(
+      resultTree.exists(
+        '.github/skills/skyux-project-modernization/references/available-schematics.md',
+      ),
+    ).toBe(true);
+    expect(
+      resultTree.exists(
+        '.github/skills/skyux-project-modernization/references/deprecated-patterns.md',
+      ),
+    ).toBe(true);
+    expect(
+      resultTree.exists(
+        '.github/skills/skyux-project-modernization/references/available-harnesses.md',
+      ),
+    ).toBe(true);
+
+    // Verify all TDD reference files are included.
+    expect(
+      resultTree.exists(
+        '.github/skills/skyux-test-driven-development/references/angular-testing-patterns.md',
+      ),
+    ).toBe(true);
+    expect(
+      resultTree.exists(
+        '.github/skills/skyux-test-driven-development/references/testing-antipatterns.md',
+      ),
+    ).toBe(true);
+  });
+
+  it('should preserve file content without template interpolation', async () => {
+    const tree = await createTestApp(runner, { projectName: 'my-app' });
+
+    const resultTree = await runner.runSchematic('add-ai-skills', {}, tree);
+
+    const skillContent = resultTree.readContent(
+      '.github/skills/skyux-migration-debugger/SKILL.md',
+    );
+    expect(skillContent).toContain(
+      'ExpressionChangedAfterItHasBeenCheckedError',
+    );
+    expect(skillContent).toContain(
+      '`TestbedHarnessEnvironment.documentRootLoader(fixture)`',
+    );
+  });
+
+  it('should preserve file content for TDD skill without template interpolation', async () => {
+    const tree = await createTestApp(runner, { projectName: 'my-app' });
+
+    const resultTree = await runner.runSchematic('add-ai-skills', {}, tree);
+
+    const tddContent = resultTree.readContent(
+      '.github/skills/skyux-test-driven-development/SKILL.md',
+    );
+    // Verify Mermaid diagram survives (contains brackets and special chars).
+    expect(tddContent).toContain('flowchart LR');
+    // Verify backtick-heavy code blocks are preserved.
+    expect(tddContent).toContain('`Sky*Harness`');
+  });
+
+  it('should preserve user-owned files in .github/skills/', async () => {
+    const tree = await createTestApp(runner, { projectName: 'my-app' });
+
+    // Simulate a user-owned skill file that exists before running the schematic.
+    tree.create('.github/skills/my-custom-skill/SKILL.md', '# My Custom Skill');
+
+    const resultTree = await runner.runSchematic('add-ai-skills', {}, tree);
+
+    // User file should still exist.
+    expect(resultTree.exists('.github/skills/my-custom-skill/SKILL.md')).toBe(
+      true,
+    );
+    expect(
+      resultTree.readContent('.github/skills/my-custom-skill/SKILL.md'),
+    ).toBe('# My Custom Skill');
+  });
+
+  it('should list all modernization schematics from collection.json', async () => {
+    const collectionPath = require.resolve('../../../../collection.json');
+    const collection = JSON.parse(readFileSync(collectionPath, 'utf-8'));
+    const allSchematics = Object.keys(collection.schematics);
+
+    // These schematics are setup/infrastructure, not modernization.
+    const excluded = [
+      'ng-add',
+      'add-skyux-to-project',
+      'add-ag-grid-styles',
+      'add-ai-skills',
+    ];
+
+    const modernizationSchematics = allSchematics.filter(
+      (name) => !excluded.includes(name),
+    );
+
+    const tree = await createTestApp(runner, { projectName: 'my-app' });
+    const resultTree = await runner.runSchematic('add-ai-skills', {}, tree);
+    const content = resultTree.readContent(
+      '.github/skills/skyux-project-modernization/references/available-schematics.md',
+    );
+
+    const missing = modernizationSchematics.filter(
+      (name) => !content.includes(name),
+    );
+
+    if (missing.length > 0) {
+      fail(
+        `These schematics exist in collection.json but are missing from available-schematics.md:\n${missing.join('\n')}`,
+      );
+    }
+  });
+
+  it('should list all exported harnesses from the monorepo', async () => {
+    // Scan all testing public-api.ts files for exported harness classes.
+    const componentsRoot = resolve(__dirname, '../../../../../../');
+    const harnessesByPackage: Record<string, string[]> = {};
+
+    for (const pkg of readdirSync(componentsRoot)) {
+      const testingApi = join(
+        componentsRoot,
+        pkg,
+        'testing',
+        'src',
+        'public-api.ts',
+      );
+      try {
+        if (!statSync(testingApi).isFile()) continue;
+      } catch {
+        continue;
+      }
+
+      const apiContent = readFileSync(testingApi, 'utf-8');
+      const harnessExports = apiContent
+        .match(/export\s*\{[^}]*\}/gs)
+        ?.flatMap((block) => {
+          const names = block.match(/\b(Sky\w+Harness)\b/g) || [];
+          return names.filter(
+            (n) => !n.endsWith('HarnessFilters') && !n.endsWith('Harnesses'),
+          );
+        });
+
+      if (harnessExports?.length) {
+        harnessesByPackage[pkg] = [...new Set(harnessExports)];
+      }
+    }
+
+    const allHarnesses = Object.values(harnessesByPackage).flat();
+
+    const tree = await createTestApp(runner, { projectName: 'my-app' });
+    const resultTree = await runner.runSchematic('add-ai-skills', {}, tree);
+    const content = resultTree.readContent(
+      '.github/skills/skyux-project-modernization/references/available-harnesses.md',
+    );
+
+    const missing = allHarnesses.filter((name) => !content.includes(name));
+
+    if (missing.length > 0) {
+      fail(
+        `These harnesses are exported from the monorepo but missing from available-harnesses.md:\n${missing.join('\n')}`,
+      );
+    }
+  });
+
+  it('should overwrite existing files on re-run', async () => {
+    const tree = await createTestApp(runner, { projectName: 'my-app' });
+
+    const firstTree = await runner.runSchematic('add-ai-skills', {}, tree);
+
+    const secondTree = await runner.runSchematic(
+      'add-ai-skills',
+      {},
+      firstTree,
+    );
+
+    expect(
+      secondTree.exists('.github/skills/skyux-migration-debugger/SKILL.md'),
+    ).toBe(true);
+  });
+});

libs/components/packages/src/schematics/ng-generate/add-ai-skills/add-ai-skills.schematic.ts

@@ -0,0 +1,17 @@
+import { normalize } from '@angular-devkit/core';
+import {
+  MergeStrategy,
+  Rule,
+  apply,
+  mergeWith,
+  move,
+  url,
+} from '@angular-devkit/schematics';
+
+export function addAiSkills(): Rule {
+  return mergeWith(
+    apply(url('./files'), [move(normalize('.github'))]),
+    MergeStrategy.Overwrite,
+  );
+}
+export default addAiSkills;