chore: publish from staged

eng/constants.mjs

@@ -180,8 +180,12 @@ const vscodeInstallImage =
 const vscodeInsidersInstallImage =
   "https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white";
 
-const repoBaseUrl =
-  "https://raw.githubusercontent.com/github/awesome-copilot/main";
+const SOURCE_CONTENT_BRANCH = "main";
+const PUBLISHED_ARTIFACT_BRANCH = "marketplace";
+const sourceContentBaseUrl =
+  `https://raw.githubusercontent.com/github/awesome-copilot/${SOURCE_CONTENT_BRANCH}`;
+const publishedArtifactBaseUrl =
+  `https://raw.githubusercontent.com/github/awesome-copilot/${PUBLISHED_ARTIFACT_BRANCH}`;
 
 const AKA_INSTALL_URLS = {
   instructions: "https://aka.ms/awesome-copilot/install/instructions",
@@ -218,13 +222,16 @@ export {
   INSTRUCTIONS_DIR,
   MAX_PLUGIN_ITEMS,
   PLUGINS_DIR,
-  repoBaseUrl,
+  PUBLISHED_ARTIFACT_BRANCH,
   ROOT_FOLDER,
+  SOURCE_CONTENT_BRANCH,
   SKILL_DESCRIPTION_MAX_LENGTH,
   SKILL_DESCRIPTION_MIN_LENGTH,
   SKILL_NAME_MAX_LENGTH,
   SKILL_NAME_MIN_LENGTH,
   SKILLS_DIR,
+  sourceContentBaseUrl,
+  publishedArtifactBaseUrl,
   TEMPLATES,
   vscodeInsidersInstallImage,
   vscodeInstallImage,

eng/update-readme.mjs

@@ -10,9 +10,10 @@ import {
   HOOKS_DIR,
   INSTRUCTIONS_DIR,
   PLUGINS_DIR,
-  repoBaseUrl,
+  publishedArtifactBaseUrl,
   ROOT_FOLDER,
   SKILLS_DIR,
+  sourceContentBaseUrl,
   TEMPLATES,
   vscodeInsidersInstallImage,
   vscodeInstallImage,
@@ -268,14 +269,16 @@ function formatTableCell(text) {
   return s.trim();
 }
 
-function makeBadges(link, type) {
+function makeBadges(link, type, linkIntent = "source") {
   const aka = AKA_INSTALL_URLS[type] || AKA_INSTALL_URLS.instructions;
+  const rawBaseUrl =
+    linkIntent === "published" ? publishedArtifactBaseUrl : sourceContentBaseUrl;
 
   const vscodeUrl = `${aka}?url=${encodeURIComponent(
-    `vscode:chat-${type}/install?url=${repoBaseUrl}/${link}`
+    `vscode:chat-${type}/install?url=${rawBaseUrl}/${link}`
   )}`;
   const insidersUrl = `${aka}?url=${encodeURIComponent(
-    `vscode-insiders:chat-${type}/install?url=${repoBaseUrl}/${link}`
+    `vscode-insiders:chat-${type}/install?url=${rawBaseUrl}/${link}`
   )}`;
 
   return `[![Install in VS Code](${vscodeInstallImage})](${vscodeUrl})<br />[![Install in VS Code Insiders](${vscodeInsidersInstallImage})](${insidersUrl})`;
@@ -325,7 +328,7 @@ function generateInstructionsSection(instructionsDir) {
     const customDescription = extractDescription(filePath);
 
     // Create badges for installation links
-    const badges = makeBadges(link, "instructions");
+    const badges = makeBadges(link, "instructions", "source");
 
     if (customDescription && customDescription !== "null") {
       // Use the description from frontmatter, table-safe
@@ -689,7 +692,7 @@ function generateUnifiedModeSection(cfg) {
   for (const { file, filePath, title } of entries) {
     const link = encodeURI(`${linkPrefix}/${file}`);
     const description = extractDescription(filePath);
-    const badges = makeBadges(link, badgeType);
+    const badges = makeBadges(link, badgeType, "source");
     let mcpServerCell = "";
     if (includeMcpServers) {
       const servers = extractMcpServerConfigs(filePath);
@@ -795,7 +798,15 @@ function generatePluginsSection(pluginsDir) {
     pluginsContent += `| [${displayName}](${link}) | ${description} | ${itemCount} items | ${keywords} |\n`;
   }
 
-  return `${TEMPLATES.pluginsSection}\n${TEMPLATES.pluginsUsage}\n\n${pluginsContent}`;
+  const publishedManifestUrl = `${publishedArtifactBaseUrl}/.github/plugin/marketplace.json`;
+  const sourceTreeUrl = "https://github.com/github/awesome-copilot/tree/HEAD/plugins";
+  const pluginLinkGuidance = [
+    "",
+    `- Published marketplace manifest (tool-facing): \`${publishedManifestUrl}\``,
+    `- Source plugin content (human-authored): \`${sourceTreeUrl}\``,
+  ].join("\n");
+
+  return `${TEMPLATES.pluginsSection}\n${TEMPLATES.pluginsUsage}${pluginLinkGuidance}\n\n${pluginsContent}`;
 }
 
 /**