diff --git a/tools/installer/core/manifest-generator.js b/tools/installer/core/manifest-generator.js
index 1b081f35f..1ec669d38 100644
--- a/tools/installer/core/manifest-generator.js
+++ b/tools/installer/core/manifest-generator.js
@@ -247,6 +247,8 @@ class ManifestGenerator {
       const moduleYamlPath = await resolveInstalledModuleYaml(moduleName);
       if (!moduleYamlPath) {
         if (await this._isSkillOnlyModule(moduleName)) {
+          // Pure source-root skill bundles intentionally ship no module.yaml,
+          // so there is no agent roster to emit and no warning to surface.
           continue;
         }
         // External modules live in ~/.bmad/cache/external-modules, not src/modules.
@@ -445,6 +447,8 @@ class ManifestGenerator {
       const moduleYamlPath = await resolveInstalledModuleYaml(moduleName);
       if (!moduleYamlPath) {
         if (await this._isSkillOnlyModule(moduleName)) {
+          // Pure source-root skill bundles intentionally ship no module.yaml,
+          // so there is no installer config schema to read or warning to surface.
           continue;
         }
         console.warn(