You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
feat: Add custom agents and skills for Ignite UI CLI - #1840
Adds AI agent skills for maintaining the CLI's project and component templates.
Skills live in .agents/skills/<name>/SKILL.md (Agent Skills format). VS Code Copilot discovers them automatically: you ask for the task and it loads the matching skill. Any other assistant can use one when you name its file. .agents/README.md is the guide.
This PR changes documentation only. No CLI, template or MCP server code is touched.
Skills
Skill
Kind
What it does
igniteui-cli-template-version-update
Workflow
Updates the Ignite UI versions that ig new / ig add scaffold, for Angular, React and Web Components. Applies patch and minor updates only. Finds every pin (constants, project package.json files, hard-coded this.packages), checks peer ranges, and validates with the template specs and the smoke test. dry-run mode gives a read-only report of stale pins and peer conflicts.
igniteui-cli-component-template
Workflow
Adds a component template (ig add <id>) for Angular, React and/or Web Components. Checks every API it uses against the package version that is currently pinned, reuses the same id across frameworks, and validates with the template specs, the smoke test and checks inside the generated project (type-check, lint, test file).
igniteui-cli-changelog
Workflow
Drafts, or with write inserts, the CHANGELOG.md section for a release cut, built from the PRs merged since the previous cut and written in the existing style.
igniteui-cli-smoke-test
Reference
Build, running one spec file, the specs that guard templates, running scripts/smoke-test.sh, what a PASS proves per framework, checks inside a kept project, and failure triage.
igniteui-cli-template-anatomy
Reference
Template layout per framework, index.ts fields, placeholders, model templates to copy, every place a version is pinned (with search patterns), which package provides which component, and how to audit which templates exist in which framework.
Other changes
AGENTS.md (new): build/test/lint, architecture, MCP server notes, conventions, and the Maintenance Workflows rules. It is based on the previous CLAUDE.md content, updated so that:
npm run build is listed as also building the MCP server;
running a single spec uses npx jasmine <compiled spec> instead of editing spec/jasmine-runner.ts.
CLAUDE.md now only imports AGENTS.md (@AGENTS.md).
.agents/README.md (new): what each skill does, how the skills fit together, example requests, and how to maintain or add skills.
…oke testing, template anatomy, and version updates
- Introduced `igniteui-cli-changelog` skill for drafting changelog sections based on merged PRs.
- Added `igniteui-cli-component-template` skill to create component templates for Angular, React, and Web Components.
- Created `igniteui-cli-smoke-test` skill to verify the installation and build process of generated projects.
- Developed `igniteui-cli-template-anatomy` skill to outline the structure and version pinning of templates across frameworks.
- Implemented `igniteui-cli-template-version-update` skill to manage and audit Ignite UI package versions in templates.
all is advertised as a valid framework input, but this parser leaves it as ["all"], after which the unknown-framework check exits with an error. Expand that value to every source framework before validation.
Validate main package peer ranges during targeted runs
When --package narrows the run (for example to igniteui-grid-lite), inScope excludes the framework's main package, so this loop never checks igniteui-angular's peer range. That contradicts the workflow's requirement to validate the main package even when it is not changing and can allow a targeted update that violates its peer dependency. Include main-package pins in metadata/peer validation while keeping them out of the apply set.
Correct PR classification for executable workflow changes
The PR description states that this is documentation-only, but this executable script can rewrite template pins with --apply (and the PR also adds an active GitHub Actions workflow). Update the description, change classification, and validation notes so reviewers and release tooling assess the operational changes accurately.
This issue also appears on line 31 of the same file.
Remove or correct the ineffective agent rules document
.claude/agent-rules.md:4
The linked .claude/agents/ directory does not exist, and .agents/README.md explicitly says there are no custom agent files. This new rules document therefore has no actual agent scope; remove it or point it at the real .agents/skills/ scope and align its commit policy with AGENTS.md.
Removed duplicate deletion and pruning of empty directories.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Adds AI agent skills for maintaining the CLI's project and component templates.
Skills live in
.agents/skills/<name>/SKILL.md(Agent Skills format). VS Code Copilot discovers them automatically: you ask for the task and it loads the matching skill. Any other assistant can use one when you name its file..agents/README.mdis the guide.This PR changes documentation only. No CLI, template or MCP server code is touched.
Skills
igniteui-cli-template-version-updateig new/ig addscaffold, for Angular, React and Web Components. Applies patch and minor updates only. Finds every pin (constants, projectpackage.jsonfiles, hard-codedthis.packages), checks peer ranges, and validates with the template specs and the smoke test.dry-runmode gives a read-only report of stale pins and peer conflicts.igniteui-cli-component-templateig add <id>) for Angular, React and/or Web Components. Checks every API it uses against the package version that is currently pinned, reuses the same id across frameworks, and validates with the template specs, the smoke test and checks inside the generated project (type-check, lint, test file).igniteui-cli-changelogwriteinserts, theCHANGELOG.mdsection for a release cut, built from the PRs merged since the previous cut and written in the existing style.igniteui-cli-smoke-testscripts/smoke-test.sh, what a PASS proves per framework, checks inside a kept project, and failure triage.igniteui-cli-template-anatomyindex.tsfields, placeholders, model templates to copy, every place a version is pinned (with search patterns), which package provides which component, and how to audit which templates exist in which framework.Other changes
AGENTS.md(new): build/test/lint, architecture, MCP server notes, conventions, and the Maintenance Workflows rules. It is based on the previousCLAUDE.mdcontent, updated so that:npm run buildis listed as also building the MCP server;npx jasmine <compiled spec>instead of editingspec/jasmine-runner.ts.CLAUDE.mdnow only importsAGENTS.md(@AGENTS.md)..agents/README.md(new): what each skill does, how the skills fit together, example requests, and how to maintain or add skills.Related Issue
Closes #1839
Type of Change
Affected Packages
igniteui-cli(packages/cli)@igniteui/cli-core(packages/core)@igniteui/angular-templates(packages/igx-templates)@igniteui/angular-schematics(packages/ng-schematics)@igniteui/mcp-server(packages/igniteui-mcp)Checklist
npm run test)npm run build)npm run lint)Additional Context