Add AI coding skills prompt to cli-config schematic with conditional agent selection

.gitignore

@@ -12,6 +12,7 @@
 # ignore compiled files in packages
 /packages/**/*.js.map
 /packages/**/*.js
+/packages/**/*.d.ts
 /scripts/**/*.js.map
 /scripts/**/*.js
 /spec/**/*.js.map

packages/ng-schematics/src/cli-config/index.ts

@@ -1,3 +1,4 @@
+import * as path from "path";
 import * as ts from "typescript";
 import { DependencyNotFoundException } from "@angular-devkit/core";
 import { chain, FileDoesNotExistException, Rule, SchematicContext, Tree } from "@angular-devkit/schematics";
@@ -7,6 +8,12 @@ import { createCliConfig } from "../utils/cli-config";
 import { setVirtual } from "../utils/NgFileSystem";
 import { addFontsToIndexHtml, getProjects, importDefaultTheme } from "../utils/theme-import";
 
+interface CliConfigOptions {
+	addAISkills?: boolean;
+	aiSkillsTargets?: string[];
+	aiSkillsCustomPath?: string;
+}
+
 function getDependencyVersion(pkg: string, tree: Tree): string {
 	const targetFile = "/package.json";
 	if (tree.exists(targetFile)) {
@@ -117,16 +124,94 @@ function importStyles(): Rule {
 	};
 }
 
+/** Agent target → destination path mapping */
+const AGENT_DEST_MAP: Record<string, string> = {
+	copilot: ".github/copilot-instructions.md",
+	claude: "CLAUDE.md",
+	cursor: ".cursor/skills",
+	agents: ".agents/skills"
+};
+
+function copySkillFile(tree: Tree, sourcePath: string, destPath: string, context: SchematicContext): void {
+	if (!tree.exists(sourcePath)) {
+		context.logger.debug(`Source skill file not found: ${sourcePath}`);
+		return;
+	}
+	if (tree.exists(destPath)) {
+		context.logger.info(`${destPath} already exists. Skipping.`);
+		return;
+	}
+	const content = tree.read(sourcePath);
+	if (!content) {
+		context.logger.debug(`Could not read source skill file: ${sourcePath}`);
+		return;
+	}
+	tree.create(destPath, content);
+	context.logger.info(`Created ${destPath}`);
+}
+
+function addAISkillsFiles(options: CliConfigOptions): Rule {
+	return (tree: Tree, context: SchematicContext) => {
+		const igxPackage = resolvePackage(NPM_ANGULAR);
+		const skillsSourceDir = `/node_modules/${igxPackage}/skills`;
+		const skillsDir = tree.getDir(skillsSourceDir);
+		const skillFiles = skillsDir.subfiles;
+
+		if (!skillFiles.length) {
+			context.logger.warn(`No skill files found in ${skillsSourceDir}. Skipping AI skills setup.`);
+			return;
+		}
+
+		const targets = options.aiSkillsTargets || [];
+
+		for (const target of targets) {
+			let destDir: string;
+			if (target === "custom") {
+				if (!options.aiSkillsCustomPath) {
+					context.logger.warn("Custom AI skills path was selected but no path was provided. Skipping.");
+					continue;
+				}
+				destDir = options.aiSkillsCustomPath;
+			} else {
+				const dest = AGENT_DEST_MAP[target];
+				if (!dest) {
+					context.logger.warn(`Unknown AI agent target: ${target}. Skipping.`);
+					continue;
+				}
+				destDir = dest;
+			}
+
+			// Check if the dest is a specific file path (has .md extension) or a directory
+			if (destDir.endsWith(".md")) {
+				// For single-file destinations (Copilot, Claude), copy first skill file
+				const sourcePath = path.posix.join(skillsSourceDir, skillFiles[0]);
+				copySkillFile(tree, sourcePath, destDir, context);
+			} else {
+				// For directory destinations (Cursor, Custom), copy all skill files
+				for (const file of skillFiles) {
+					const sourcePath = path.posix.join(skillsSourceDir, file);
+					const destPath = path.posix.join(destDir, file);
+					copySkillFile(tree, sourcePath, destPath, context);
+				}
+			}
+		}
+	};
+}
+
 // tslint:disable-next-line:space-before-function-paren
-export default function (): Rule {
+export default function (options: CliConfigOptions = {}): Rule {
 	return (tree: Tree) => {
 		setVirtual(tree);
-		return chain([
+		const rules: Rule[] = [
 			importStyles(),
 			addTypographyToProj(),
 			importBrowserAnimations(),
 			createCliConfig(),
 			displayVersionMismatch()
-		]);
+		];
+		if (options.addAISkills !== false && options.aiSkillsTargets && options.aiSkillsTargets.length > 0) {
+			rules.push(addAISkillsFiles(options));
+		}
+		return chain(rules);
 	};
 }

packages/ng-schematics/src/cli-config/index_spec.ts

@@ -309,4 +309,181 @@ export const appConfig: ApplicationConfig = {
 		await runner.runSchematic("cli-config", {}, tree);
 		expect(warns).toContain(jasmine.stringMatching(pattern));
 	});
+
+	describe("addAISkills", () => {
+		const mockSkillContent = "# Ignite UI for Angular - AI Skills\nBest practices...";
+		const copilotDest = ".github/copilot-instructions.md";
+		const claudeDest = "CLAUDE.md";
+		const cursorDest = ".cursor/skills";
+		const agentsDest = ".agents/skills";
+
+		function createSkillFiles(igxPkg = NPM_ANGULAR) {
+			const dir = `node_modules/${igxPkg}/skills`;
+			tree.create(`${dir}/igniteui-angular.md`, mockSkillContent);
+		}
+
+		it("should copy skill file to .github/copilot-instructions.md for copilot target", async () => {
+			createSkillFiles();
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["copilot"]
+			}, tree);
+			expect(tree.exists(copilotDest)).toBeTruthy();
+			expect(tree.readContent(copilotDest)).toEqual(mockSkillContent);
+		});
+
+		it("should copy skill file to CLAUDE.md for claude target", async () => {
+			createSkillFiles();
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["claude"]
+			}, tree);
+			expect(tree.exists(claudeDest)).toBeTruthy();
+			expect(tree.readContent(claudeDest)).toEqual(mockSkillContent);
+		});
+
+		it("should copy skill files to .cursor/skills/ for cursor target", async () => {
+			createSkillFiles();
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["cursor"]
+			}, tree);
+			expect(tree.exists(`${cursorDest}/igniteui-angular.md`)).toBeTruthy();
+			expect(tree.readContent(`${cursorDest}/igniteui-angular.md`)).toEqual(mockSkillContent);
+		});
+
+		it("should copy skill files to .agents/skills/ for agents target", async () => {
+			createSkillFiles();
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["agents"]
+			}, tree);
+			expect(tree.exists(`${agentsDest}/igniteui-angular.md`)).toBeTruthy();
+			expect(tree.readContent(`${agentsDest}/igniteui-angular.md`)).toEqual(mockSkillContent);
+		});
+
+		it("should copy skill files to custom path", async () => {
+			createSkillFiles();
+			const customPath = "my-custom/ai-skills";
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["custom"],
+				aiSkillsCustomPath: customPath
+			}, tree);
+			expect(tree.exists(`${customPath}/igniteui-angular.md`)).toBeTruthy();
+			expect(tree.readContent(`${customPath}/igniteui-angular.md`)).toEqual(mockSkillContent);
+		});
+
+		it("should handle multiple targets at once", async () => {
+			createSkillFiles();
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["copilot", "claude", "cursor", "agents"]
+			}, tree);
+			expect(tree.exists(copilotDest)).toBeTruthy();
+			expect(tree.exists(claudeDest)).toBeTruthy();
+			expect(tree.exists(`${cursorDest}/igniteui-angular.md`)).toBeTruthy();
+			expect(tree.exists(`${agentsDest}/igniteui-angular.md`)).toBeTruthy();
+		});
+
+		it("should NOT create skill files when addAISkills is false", async () => {
+			createSkillFiles();
+			await runner.runSchematic("cli-config", {
+				addAISkills: false,
+				aiSkillsTargets: ["copilot", "claude"]
+			}, tree);
+			expect(tree.exists(copilotDest)).toBeFalsy();
+			expect(tree.exists(claudeDest)).toBeFalsy();
+		});
+
+		it("should NOT create skill files when aiSkillsTargets is empty", async () => {
+			createSkillFiles();
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: []
+			}, tree);
+			expect(tree.exists(copilotDest)).toBeFalsy();
+			expect(tree.exists(claudeDest)).toBeFalsy();
+		});
+
+		it("should not overwrite existing copilot-instructions.md", async () => {
+			createSkillFiles();
+			const existingContent = "# Existing instructions";
+			tree.create(copilotDest, existingContent);
+
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["copilot"]
+			}, tree);
+			expect(tree.readContent(copilotDest)).toEqual(existingContent);
+		});
+
+		it("should not overwrite existing CLAUDE.md", async () => {
+			createSkillFiles();
+			const existingContent = "# Existing CLAUDE.md";
+			tree.create(claudeDest, existingContent);
+
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["claude"]
+			}, tree);
+			expect(tree.readContent(claudeDest)).toEqual(existingContent);
+		});
+
+		it("should not overwrite existing cursor skill files", async () => {
+			createSkillFiles();
+			const existingContent = "# Existing cursor skill";
+			tree.create(`${cursorDest}/igniteui-angular.md`, existingContent);
+
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["cursor"]
+			}, tree);
+			expect(tree.readContent(`${cursorDest}/igniteui-angular.md`)).toEqual(existingContent);
+		});
+
+		it("should not overwrite existing agents skill files", async () => {
+			createSkillFiles();
+			const existingContent = "# Existing agents skill";
+			tree.create(`${agentsDest}/igniteui-angular.md`, existingContent);
+
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["agents"]
+			}, tree);
+			expect(tree.readContent(`${agentsDest}/igniteui-angular.md`)).toEqual(existingContent);
+		});
+
+		it("should warn when custom target has no path", async () => {
+			createSkillFiles();
+			const warns: string[] = [];
+			runner.logger.subscribe(entry => {
+				if (entry.level === "warn") {
+					warns.push(entry.message);
+				}
+			});
+
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["custom"]
+			}, tree);
+			expect(warns).toContain(jasmine.stringMatching(/Custom AI skills path was selected but no path was provided/));
+		});
+
+		it("should work with FEED_ANGULAR package", async () => {
+			// Run schematic first to create ignite-ui-cli.json (required by resetTree)
+			await runner.runSchematic("cli-config", {}, tree);
+
+			resetTree();
+			createIgPkgJson(FEED_ANGULAR);
+			populatePkgJson(FEED_ANGULAR);
+			createSkillFiles(FEED_ANGULAR);
+
+			await runner.runSchematic("cli-config", {
+				addAISkills: true,
+				aiSkillsTargets: ["copilot"]
+			}, tree);
+			expect(tree.exists(copilotDest)).toBeTruthy();
+		});
+	});
 });

packages/ng-schematics/src/cli-config/schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "igniteui-angular-cli-config",
+  "title": "Ignite UI for Angular CLI Config Options Schema",
+  "type": "object",
+  "properties": {
+    "addAISkills": {
+      "type": "boolean",
+      "description": "Add AI coding skills for your IDE",
+      "default": true,
+      "x-prompt": "Would you like to add AI coding skills for your IDE?"
+    },
+    "aiSkillsTargets": {
+      "type": "array",
+      "description": "AI agent targets for skill files",
+      "items": {
+        "type": "string",
+        "enum": ["copilot", "claude", "cursor", "agents", "custom"]
+      },
+      "x-prompt": {
+        "message": "Which AI coding assistant(s) would you like to add skills for?",
+        "type": "list",
+        "multiselect": true,
+        "items": [
+          { "value": "copilot", "label": "GitHub Copilot (.github/copilot-instructions.md)" },
+          { "value": "claude", "label": "Claude (CLAUDE.md)" },
+          { "value": "cursor", "label": "Cursor (.cursor/skills/)" },
+          { "value": "agents", "label": "VS Code Agents (.agents/skills/)" },
+          { "value": "custom", "label": "Add custom path" }
+        ]
+      }
+    },
+    "aiSkillsCustomPath": {
+      "type": "string",
+      "description": "Custom path for AI skill files",
+      "x-prompt": {
+        "message": "Enter the custom path for AI skill files:",
+        "type": "input"
+      }
+    }
+  },
+  "required": []
+}

packages/ng-schematics/src/collection.json

@@ -31,7 +31,8 @@
     },
     "cli-config": {
       "description": "Installs the needed dependencies onto the host application.",
-      "factory": "./cli-config/index"
+      "factory": "./cli-config/index",
+      "schema": "./cli-config/schema.json"
     },
     "upgrade-packages": {
       "description": "Upgrades to the licensed Ignite UI for Angular packages",