+ * Can be disabled via the {@code azure.skills.autoconfigure.disabled} registry key. + */ +@Slf4j +public class AzureSkillsInitializer implements ProjectActivity, DumbAware { + private static final String COPILOT_PLUGIN_ID = "com.github.copilot"; + private static final String NOTIFICATION_GROUP_ID = "Azure Toolkit"; + private static final String CONSENT_KEY = "azure-skills-install-consent"; + private static final String CONSENT_ACCEPTED = "accepted"; + private static final String CONSENT_DECLINED = "declined"; + private static final String[] NPX_ADD_ARGS = { + "-y", "skills", "add", + "https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills", + "--all", "github-copilot", "-g" + }; + private static final String[] NPX_UPDATE_ARGS = { + "-y", "skills", "update", "-g" + }; + private static final Duration UPDATE_INTERVAL = Duration.ofHours(24); + private static final String TIMESTAMP_FILE_NAME = "azure-skills-last-update"; + // This timeout should account for time required to clone the repo and install all the skills. + private static final long TIMEOUT_IN_MINUTES = 5; + + @Override + public Object execute(@NotNull Project project, @NotNull Continuation continuation) { + try { + initializeAzureSkills(null, project); + } catch (Exception e) { + log.error("Error initializing Azure Skills: " + e.getMessage(), e); + } + return null; + } + + private void initializeAzureSkills(final AnActionEvent event, final Project project) { + if (Registry.is("azure.skills.autoconfigure.disabled", false)) { + logTelemetryEvent("azure-skills-initialization-disabled"); + return; + } + + logTelemetryEvent("azure-skills-initialization-started"); + log.info("Running Azure Skills initializer"); + try { + if (!isCopilotPluginInstalled()) { + log.info("GitHub Copilot plugin is not installed, skipping Azure Skills initialization"); + logTelemetryEvent("azure-skills-copilot-not-installed"); + return; + } + + if (!isCopilotSkillsEnabled()) { + log.info("Agent skills are not enabled in GitHub Copilot settings, skipping Azure Skills initialization"); + logTelemetryEvent("azure-skills-copilot-skills-disabled"); + return; + } + + final String npxPath = findNpxExecutable(); + if (npxPath == null) { + log.warn("npx is not installed or not found on PATH"); + logTelemetryEvent("azure-skills-npx-not-found"); + return; + } + + if (isSkillsInstalled()) { + updateSkills(npxPath, project); + } else { + final String consent = getConsentState(); + if (CONSENT_DECLINED.equals(consent)) { + log.info("User previously declined Azure Skills installation, skipping"); + logTelemetryEvent("azure-skills-user-declined"); + return; + } + if (CONSENT_ACCEPTED.equals(consent)) { + installAzureSkills(npxPath, project); + } else { + promptForConsent(project, npxPath); + } + } + } catch (final Exception ex) { + log.error("Error initializing Azure Skills: " + ex.getMessage(), ex); + logErrorTelemetryEvent("azure-skills-initialization-failed", ex); + } + } + + private void installAzureSkills(final String npxPath, final Project project) { + log.info("Azure Skills not found, running fresh install"); + final boolean success = runNpxCommand(npxPath, NPX_ADD_ARGS); + if (success) { + writeTimestamp(); + log.info("Azure Skills installed successfully."); + logTelemetryEvent("azure-skills-install-success"); + } else { + log.error("Azure Skills npx add command failed"); + logTelemetryEvent("azure-skills-install-failed"); + } + } + + private void updateSkills(final String npxPath, final Project project) { + if (!isUpdateDue()) { + log.info("Azure Skills is up to date, skipping update"); + return; + } + + log.info("Azure Skills update is due, running update"); + final boolean success = runNpxCommand(npxPath, NPX_UPDATE_ARGS); + if (success) { + writeTimestamp(); + log.info("Azure Skills updated successfully."); + logTelemetryEvent("azure-skills-update-success"); + } else { + log.error("Azure Skills npx update command failed"); + logTelemetryEvent("azure-skills-update-failed"); + } + } + + /** + * Shows a notification asking the user whether to install Azure Skills. + * The user's choice is persisted so they won't be asked again. + * The preference can be changed later under Settings → Tools → Azure. + */ + private void promptForConsent(final Project project, final String npxPath) { + final Notification notification = new Notification( + NOTIFICATION_GROUP_ID, + "Install Azure Skills?", + "Azure Toolkit can install Azure Skills for GitHub Copilot to enhance your AI-assisted Azure development experience.", + NotificationType.INFORMATION); + + notification.addAction(new NotificationAction("Install") { + @Override + public void actionPerformed(@NotNull AnActionEvent e, @NotNull Notification notification) { + notification.expire(); + setConsentState(CONSENT_ACCEPTED); + logTelemetryEvent("azure-skills-user-accepted"); + ApplicationManager.getApplication().executeOnPooledThread(() -> installAzureSkills(npxPath, project)); + } + }); + + notification.addAction(new NotificationAction("Don\u2019t Install") { + @Override + public void actionPerformed(@NotNull AnActionEvent e, @NotNull Notification notification) { + notification.expire(); + setConsentState(CONSENT_DECLINED); + logTelemetryEvent("azure-skills-user-declined"); + } + }); + + Notifications.Bus.notify(notification, project); + } + + private String getConsentState() { + return IntellijStore.getInstance().getProperty(null, CONSENT_KEY); + } + + private void setConsentState(final String value) { + IntellijStore.getInstance().setProperty(null, CONSENT_KEY, value); + } + + private void showNotification(final Project project, final String title, final String content) { + final Notification notification = new Notification(NOTIFICATION_GROUP_ID, title, content, NotificationType.INFORMATION); + Notifications.Bus.notify(notification, project); + } + + /** + * Checks whether the GitHub Copilot plugin is installed and enabled. + */ + private boolean isCopilotPluginInstalled() { + final IdeaPluginDescriptor copilotPlugin = PluginManagerCore.getPlugin(PluginId.getId(COPILOT_PLUGIN_ID)); + return copilotPlugin != null && copilotPlugin.isEnabled(); + } + + /** + * Checks whether the "Agent Skills" option is enabled in GitHub Copilot settings + * (Settings → Tools → GitHub Copilot → Chat → {@code enableSkills}). + *
+ * Uses reflection because the Copilot plugin is an optional runtime dependency.
+ * Returns {@code true} if the setting cannot be read (fail-open).
+ */
+ private boolean isCopilotSkillsEnabled() {
+ try {
+ final Class settingsClass = Class.forName(
+ "com.github.copilot.settings.CopilotApplicationSettings");
+ final Object settingsInstance = ApplicationManager.getApplication().getService(settingsClass);
+ if (settingsInstance == null) {
+ log.warn("CopilotApplicationSettings service not found, assuming skills enabled");
+ return true;
+ }
+ final Object state = settingsClass.getMethod("getState").invoke(settingsInstance);
+ if (state == null) {
+ log.warn("CopilotApplicationSettings state is null, assuming skills enabled");
+ return true;
+ }
+ final java.lang.reflect.Field enableSkillsField = state.getClass().getDeclaredField("enableSkills");
+ enableSkillsField.setAccessible(true);
+ return enableSkillsField.getBoolean(state);
+ } catch (final Exception ex) {
+ log.warn("Failed to read Copilot enableSkills setting, assuming skills enabled: " + ex.getMessage());
+ return true;
+ }
+ }
+
+ /**
+ * Checks whether Azure Skills are already installed by looking for
+ * skill subdirectories under {@code ~/.agents/skills/}.
+ */
+ private boolean isSkillsInstalled() {
+ final Path skillsDir = getSkillsDir();
+ if (!Files.isDirectory(skillsDir)) {
+ return false;
+ }
+ try (final var entries = Files.list(skillsDir)) {
+ return entries.anyMatch(Files::isDirectory);
+ } catch (final IOException ex) {
+ log.warn("Failed to check skills directory: " + ex.getMessage());
+ return false;
+ }
+ }
+
+ /**
+ * Determines whether an update should be attempted based on the last
+ * install/update timestamp stored in the IntelliJ config directory.
+ */
+ private boolean isUpdateDue() {
+ final Path timestampFile = getTimestampFile();
+ if (!Files.exists(timestampFile)) {
+ return true;
+ }
+ try {
+ final String content = Files.readString(timestampFile).trim();
+ final Instant lastUpdate = Instant.parse(content);
+ return Duration.between(lastUpdate, Instant.now()).compareTo(UPDATE_INTERVAL) > 0;
+ } catch (final Exception ex) {
+ log.warn("Failed to read skills timestamp file, treating as update due: " + ex.getMessage());
+ return true;
+ }
+ }
+
+ /**
+ * Writes the current UTC timestamp to the marker file so subsequent
+ * startups can decide whether an update is needed.
+ */
+ private void writeTimestamp() {
+ try {
+ final Path timestampFile = getTimestampFile();
+ Files.createDirectories(timestampFile.getParent());
+ Files.writeString(timestampFile, Instant.now().toString());
+ } catch (final IOException ex) {
+ log.warn("Failed to write skills timestamp file: " + ex.getMessage());
+ }
+ }
+
+ private Path getSkillsDir() {
+ return Paths.get(System.getProperty("user.home"), ".agents", "skills");
+ }
+
+ private Path getTimestampFile() {
+ return Paths.get(PathManager.getConfigPath(), TIMESTAMP_FILE_NAME);
+ }
+
+ /**
+ * Finds the npx executable on the system PATH.
+ * On Windows, tries npx.cmd first (npm shim), then npx.
+ *
+ * @return the npx command string if found, null otherwise
+ */
+ @Nullable
+ private String findNpxExecutable() {
+ final String[] candidates = SystemInfo.isWindows
+ ? new String[]{"npx.cmd", "npx"}
+ : new String[]{"npx"};
+
+ for (final String candidate : candidates) {
+ final ProcessBuilder pb = new ProcessBuilder(candidate, "--version");
+ pb.redirectErrorStream(true);
+ final int exitCode = handleProcessExecution(pb);
+ if (exitCode == 0) {
+ return candidate;
+ }
+ }
+ return null;
+ }
+
+ private int handleProcessExecution(ProcessBuilder pb) {
+ try {
+ final Process process = pb.start();
+ try (final BufferedReader reader = new BufferedReader(new InputStreamReader(process.getInputStream()))) {
+ String line;
+ while ((line = reader.readLine()) != null) {
+ log.debug(line);
+ }
+ }
+ final boolean completed = process.waitFor(TIMEOUT_IN_MINUTES, TimeUnit.MINUTES);
+ if (completed) {
+ return process.exitValue();
+ } else {
+ process.destroyForcibly();
+ log.warn("Process timed out and was killed: " + pb.command());
+ return -1;
+ }
+ } catch (final IOException | InterruptedException ex) {
+ log.info("Error executing process command " + pb.command() + ": " + ex.getMessage());
+ return -1;
+ }
+ }
+
+ /**
+ * Runs an npx command with the given arguments.
+ *
+ * @param npxPath the path/name of the npx executable
+ * @param args the arguments to pass after npx
+ * @return true if the command completed successfully
+ */
+ private boolean runNpxCommand(final String npxPath, final String[] args) {
+ final String[] command = new String[args.length + 1];
+ command[0] = npxPath;
+ System.arraycopy(args, 0, command, 1, args.length);
+
+ final ProcessBuilder pb = new ProcessBuilder(command);
+ final int exitCode = handleProcessExecution(pb);
+ log.info("npx skills command exited with code: " + exitCode);
+ return exitCode == 0;
+ }
+
+}
diff --git a/PluginsAndFeatures/azure-toolkit-for-intellij/azure-intellij-plugin-azuremcp/src/main/resources/META-INF/azure-intellij-plugin-azuremcp.xml b/PluginsAndFeatures/azure-toolkit-for-intellij/azure-intellij-plugin-azuremcp/src/main/resources/META-INF/azure-intellij-plugin-azuremcp.xml
index f7f4e2d576..43db61d57c 100644
--- a/PluginsAndFeatures/azure-toolkit-for-intellij/azure-intellij-plugin-azuremcp/src/main/resources/META-INF/azure-intellij-plugin-azuremcp.xml
+++ b/PluginsAndFeatures/azure-toolkit-for-intellij/azure-intellij-plugin-azuremcp/src/main/resources/META-INF/azure-intellij-plugin-azuremcp.xml
@@ -6,6 +6,9 @@