Consolidate 18 skills into 1 /impeccable skill with 20 commands

Biggest change in a while. Users previously had 18 standalone skill
entries cluttering their /menu; now they have one entry (/impeccable)
that routes to 20 specialized commands via argument dispatch. The pin
mechanism (/impeccable pin audit) restores standalone shortcuts on
demand for commands users hit all the time.

## Architecture

- Single /impeccable skill with command router section in SKILL.md
- 20 commands served via reference files under source/skills/impeccable/reference/
- /impeccable pin <command> creates a lightweight redirect shim so users
  who prefer /audit, /polish, etc. can still have them
- Context gathering (teach) auto-runs on first use
- command-metadata.json is the single source of truth for command
  descriptions, argument hints, and relationships

## Site rewrite

- Docs URL: /skills renamed to /docs (with /skills permanent redirects)
- Homepage hero frames Impeccable as "one skill with 20 commands"
- "Get Started" split into 50/50 install + how-to-use with editorial
  numbered steps, /impeccable shown as the home command with three modes
- New /docs overview: home command hero card + dense category rows
  matching the old cheatsheet density, with leads-to/pairs-with/
  combines-with relationship metadata served from a shared source
- Cheatsheet merged into /docs, /cheatsheet redirects
- Magazine spread and mobile cards show /impeccable as a stacked
  namespace label above the command name at full display size
- Periodic table updated with craft/teach/extract as first-class cells
- Skill detail pages generate from reference files, with an editorial
  wrapper per command for tagline + body
- Tutorials and anti-patterns pages updated to use /impeccable <cmd>

## Build system

- Dead code removed (scripts/lib/transformers/shared.js)
- Build log wording fixed ("1 skill" not "1 skills (1 user-invocable)")
- generateApiData fallback branch removed (throws loudly if metadata
  missing instead of silently degrading)
- Commands API includes editorial tagline alongside the long description;
  UI surfaces prefer tagline for human display, description for auto-
  trigger keyword matching

## Gitignore

- Added .claude/scheduled_tasks.lock, .claude/settings.local.json to
  ignore list (local Claude Code state that should not be tracked).
- Harness skill directories (.claude/skills/, .agents/skills/, etc.)
  remain tracked by design: npx skills reads them from this repo at
  install time and they enable clean submodule use.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

scripts/lib/transformers/factory.js

@@ -123,10 +123,10 @@ export function createTransformer(config) {
       }
     }
 
-    const userInvocableCount = skills.filter((s) => s.userInvocable).length;
+    const skillWord = skills.length === 1 ? 'skill' : 'skills';
     const refInfo = refCount > 0 ? ` (${refCount} reference files)` : '';
     const scriptInfo = scriptCount > 0 ? ` (${scriptCount} script files)` : '';
     const prefixInfo = prefix ? ` [${prefix}prefixed]` : '';
-    console.log(`✓ ${displayName}${prefixInfo}: ${skills.length} skills (${userInvocableCount} user-invocable)${refInfo}${scriptInfo}`);
+    console.log(`✓ ${displayName}${prefixInfo}: ${skills.length} ${skillWord}${refInfo}${scriptInfo}`);
   };
 }

scripts/lib/transformers/index.js

@@ -1,6 +1,9 @@
 import { createTransformer } from './factory.js';
 import { PROVIDERS } from './providers.js';
 
+// Named exports exist primarily as stable spy targets for the test suite
+// (build.test.js uses spyOn(transformers, 'transformCursor') etc.). build.js
+// itself uses createTransformer + PROVIDERS directly, not these.
 export const transformCursor = createTransformer(PROVIDERS.cursor);
 export const transformClaudeCode = createTransformer(PROVIDERS['claude-code']);
 export const transformGemini = createTransformer(PROVIDERS.gemini);

scripts/lib/transformers/shared.js

@@ -1,81 +0,0 @@
-import path from 'path';
-import { cleanDir, ensureDir, writeFile, generateYamlFrontmatter, replacePlaceholders, prefixSkillReferences } from '../utils.js';
-
-/**
- * Shared transformer logic for all providers.
- *
- * @param {Object} config - Provider-specific configuration
- * @param {string} config.provider - Provider key for placeholders (e.g., 'claude-code')
- * @param {string} config.displayName - Display name for logging (e.g., 'Claude Code')
- * @param {string} config.configDir - Dot-directory name (e.g., '.claude')
- * @param {Function} config.buildFrontmatter - (skill, skillName) => frontmatter object
- * @param {Function} [config.transformBody] - Optional (body, skill) => transformed body
- * @param {Array} skills - All skills
- * @param {string} distDir - Distribution output directory
- * @param {Object} options - Optional settings (prefix, outputSuffix)
- */
-export function transformProvider(config, skills, distDir, options = {}) {
-  const { provider, displayName, configDir, buildFrontmatter, transformBody } = config;
-  const { prefix = '', outputSuffix = '' } = options;
-  const providerDir = path.join(distDir, `${provider}${outputSuffix}`);
-  const skillsDir = path.join(providerDir, `${configDir}/skills`);
-
-  cleanDir(providerDir);
-  ensureDir(skillsDir);
-
-  const allSkillNames = skills.map(s => s.name);
-  const commandNames = skills.filter(s => s.userInvokable).map(s => `${prefix}${s.name}`);
-  let refCount = 0;
-  let scriptCount = 0;
-
-  for (const skill of skills) {
-    const skillName = `${prefix}${skill.name}`;
-    const skillDir = path.join(skillsDir, skillName);
-
-    const frontmatterObj = buildFrontmatter(skill, skillName);
-    const frontmatter = generateYamlFrontmatter(frontmatterObj);
-
-    let skillBody = replacePlaceholders(skill.body, provider, commandNames);
-
-    // Replace {{scripts_path}} with provider-aware path to skill's scripts directory
-    const scriptsPath = provider === 'claude-code'
-      ? '${CLAUDE_PLUGIN_ROOT}/scripts'
-      : `${configDir}/skills/${skillName}/scripts`;
-    skillBody = skillBody.replace(/\{\{scripts_path\}\}/g, scriptsPath);
-
-    if (prefix) skillBody = prefixSkillReferences(skillBody, prefix, allSkillNames);
-    if (transformBody) skillBody = transformBody(skillBody, skill);
-
-    const content = `${frontmatter}\n\n${skillBody}`;
-    writeFile(path.join(skillDir, 'SKILL.md'), content);
-
-    // Copy reference files if they exist
-    if (skill.references && skill.references.length > 0) {
-      const refDir = path.join(skillDir, 'reference');
-      ensureDir(refDir);
-      for (const ref of skill.references) {
-        writeFile(
-          path.join(refDir, `${ref.name}.md`),
-          replacePlaceholders(ref.content, provider)
-        );
-        refCount++;
-      }
-    }
-
-    // Copy script files if they exist
-    if (skill.scripts && skill.scripts.length > 0) {
-      const scriptsOutDir = path.join(skillDir, 'scripts');
-      ensureDir(scriptsOutDir);
-      for (const script of skill.scripts) {
-        writeFile(path.join(scriptsOutDir, script.name), script.content);
-        scriptCount++;
-      }
-    }
-  }
-
-  const userInvokableCount = skills.filter(s => s.userInvokable).length;
-  const refInfo = refCount > 0 ? ` (${refCount} reference files)` : '';
-  const scriptInfo = scriptCount > 0 ? ` (${scriptCount} script files)` : '';
-  const prefixInfo = prefix ? ` [${prefix}prefixed]` : '';
-  console.log(`✓ ${displayName}${prefixInfo}: ${skills.length} skills (${userInvokableCount} user-invokable)${refInfo}${scriptInfo}`);
-}