Restore prefix toggle for i- prefixed skill bundles

Re-adds the toggle in the install section that lets users download bundles
with all user-invokable skills prefixed with i- (e.g. /i-audit) to avoid
naming conflicts. Build now produces both unprefixed and prefixed variants
for all providers and universal ZIP.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

scripts/build.js

@@ -130,8 +130,8 @@ async function buildStaticSite() {
 /**
  * Assemble universal directory from all provider outputs
  */
-function assembleUniversal(distDir) {
-  const universalDir = path.join(distDir, 'universal');
+function assembleUniversal(distDir, suffix = '') {
+  const universalDir = path.join(distDir, `universal${suffix}`);
 
   // Clean and recreate
   if (fs.existsSync(universalDir)) {
@@ -147,7 +147,7 @@ function assembleUniversal(distDir) {
   ];
 
   for (const { provider, configDir } of providerMappings) {
-    const src = path.join(distDir, provider, configDir);
+    const src = path.join(distDir, `${provider}${suffix}`, configDir);
     const dest = path.join(universalDir, configDir);
     if (fs.existsSync(src)) {
       copyDirSync(src, dest);
@@ -156,10 +156,11 @@ function assembleUniversal(distDir) {
 
   // Add a visible README so macOS users don't see an empty folder
   // (all provider dirs are dotfiles, hidden by default in Finder)
+  const prefixNote = suffix ? '\nSkills in this bundle are prefixed with i- (e.g. /i-audit) to avoid conflicts.\n' : '';
   fs.writeFileSync(path.join(universalDir, 'README.txt'),
 `Impeccable — Design fluency for AI harnesses
 https://impeccable.style
-
+${prefixNote}
 This folder contains skills for all supported tools:
 
   .cursor/    → Cursor
@@ -172,7 +173,8 @@ To install, copy the relevant folder(s) into your project root.
 These are hidden folders (dotfiles) — press Cmd+Shift+. in Finder to see them.
 `);
 
-  console.log(`✓ Assembled universal directory (${providerMappings.length} providers)`);
+  const label = suffix ? ' (prefixed)' : '';
+  console.log(`✓ Assembled universal${label} directory (${providerMappings.length} providers)`);
 }
 
 /**
@@ -210,8 +212,17 @@ async function build() {
   transformCodex(skills, DIST_DIR, patterns);
   transformAgents(skills, DIST_DIR, patterns);
 
-  // Assemble universal directory
+  // Transform for each provider (prefixed with i-)
+  const prefixOptions = { prefix: 'i-', outputSuffix: '-prefixed' };
+  transformCursor(skills, DIST_DIR, patterns, prefixOptions);
+  transformClaudeCode(skills, DIST_DIR, patterns, prefixOptions);
+  transformGemini(skills, DIST_DIR, patterns, prefixOptions);
+  transformCodex(skills, DIST_DIR, patterns, prefixOptions);
+  transformAgents(skills, DIST_DIR, patterns, prefixOptions);
+
+  // Assemble universal directory (unprefixed and prefixed)
   assembleUniversal(DIST_DIR);
+  assembleUniversal(DIST_DIR, '-prefixed');
 
   // Create ZIP bundles (individual + universal)
   await createAllZips(DIST_DIR);

scripts/lib/transformers/agents.js

@@ -13,7 +13,8 @@ import { cleanDir, ensureDir, writeFile, generateYamlFrontmatter, replacePlaceho
  * @param {Object} options - Optional settings
  */
 export function transformAgents(skills, distDir, patterns = null, options = {}) {
-  const agentsDir = path.join(distDir, 'agents');
+  const { prefix = '', outputSuffix = '' } = options;
+  const agentsDir = path.join(distDir, `agents${outputSuffix}`);
   const skillsDir = path.join(agentsDir, '.agents/skills');
 
   cleanDir(agentsDir);
@@ -21,7 +22,7 @@ export function transformAgents(skills, distDir, patterns = null, options = {})
 
   let refCount = 0;
   for (const skill of skills) {
-    const skillName = skill.name;
+    const skillName = skill.userInvokable ? `${prefix}${skill.name}` : skill.name;
     const skillDir = path.join(skillsDir, skillName);
 
     const frontmatterObj = {
@@ -60,5 +61,6 @@ export function transformAgents(skills, distDir, patterns = null, options = {})
 
   const userInvokableCount = skills.filter(s => s.userInvokable).length;
   const refInfo = refCount > 0 ? ` (${refCount} reference files)` : '';
-  console.log(`✓ Agents: ${skills.length} skills (${userInvokableCount} user-invokable)${refInfo}`);
+  const prefixInfo = prefix ? ` [${prefix}prefixed]` : '';
+  console.log(`✓ Agents${prefixInfo}: ${skills.length} skills (${userInvokableCount} user-invokable)${refInfo}`);
 }

scripts/lib/zip.js

@@ -53,13 +53,24 @@ export async function createAllZips(distDir) {
 
   const providers = ['cursor', 'claude-code', 'gemini', 'codex', 'agents'];
 
-  // Create individual provider ZIPs
+  // Create unprefixed ZIPs
   for (const provider of providers) {
     const providerDir = path.join(distDir, provider);
     await createProviderZip(providerDir, distDir, provider);
   }
 
-  // Create universal ZIP
+  // Create unprefixed universal ZIP
   const universalDir = path.join(distDir, 'universal');
   await createProviderZip(universalDir, distDir, 'universal');
+
+  // Create prefixed ZIPs
+  console.log('  --- prefixed variants ---');
+  for (const provider of providers) {
+    const providerDir = path.join(distDir, `${provider}-prefixed`);
+    await createProviderZip(providerDir, distDir, `${provider}-prefixed`);
+  }
+
+  // Create prefixed universal ZIP
+  const universalPrefixedDir = path.join(distDir, 'universal-prefixed');
+  await createProviderZip(universalPrefixedDir, distDir, 'universal-prefixed');
 }