agentic-skill-mill 1.0.5 → 1.0.7

package/install-local.ps1

@@ -0,0 +1,385 @@
+$ErrorActionPreference = 'Stop'
+
+$ProjectName = 'agentic-skill-mill'
+$CliBinName = 'skillmill'
+$ManagedMarker = 'managed_by: agentic-skill-mill'
+$Skills = @('agentic-skill-mill')
+$SkillDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$UserHome = [Environment]::GetFolderPath('UserProfile')
+$AppData = [Environment]::GetFolderPath('ApplicationData')
+$CodeXHomeDir = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $UserHome '.codex' }
+
+$ClaudeSkillsDir = Join-Path $UserHome '.claude\skills'
+$CursorRulesDir = Join-Path $UserHome '.cursor\rules'
+$CursorSkillsDir = Join-Path $UserHome '.cursor\skills'
+$WindsurfRulesDir = Join-Path $UserHome '.windsurf\rules'
+$WindsurfSkillsDir = Join-Path $UserHome '.codeium\windsurf\skills'
+$OpenCodeAgentsDirs = @(
+  Join-Path $AppData 'opencode\agents',
+  Join-Path $UserHome '.opencode\agents'
+)
+$CodeXSkillsDir = Join-Path $CodeXHomeDir 'skills'
+$CompiledDir = Join-Path $SkillDir 'compiled'
+
+function Show-Help {
+  Write-Host 'Usage: powershell -ExecutionPolicy Bypass -File .\install-local.ps1 [options]'
+  Write-Host ''
+  Write-Host 'Options:'
+  Write-Host '  --claude        Install skills for Claude Code'
+  Write-Host '  --cursor        Install skills for Cursor'
+  Write-Host '  --windsurf      Install skills for Windsurf'
+  Write-Host '  --opencode      Install skills for OpenCode'
+  Write-Host '  --codex         Install skills for Codex'
+  Write-Host '  --all           Install for all five tools'
+  Write-Host '  --skills-only   Skip npm install/build/link (just copy skills)'
+  Write-Host '  --uninstall     Remove installed skills from target tools'
+  Write-Host '  --compile-only  Generate compiled/ output directory (no install)'
+  Write-Host '  -h, --help      Show this help'
+  Write-Host ''
+  Write-Host 'No flags = auto-detect installed tools.'
+}
+
+function Invoke-Step {
+  param(
+    [Parameter(Mandatory = $true)][string]$FilePath,
+    [string[]]$Arguments = @(),
+    [string]$WorkingDirectory = $SkillDir,
+    [switch]$AllowFailure
+  )
+
+  $argText = if ($Arguments.Count -gt 0) { ' ' + ($Arguments -join ' ') } else { '' }
+  Write-Host ("> {0}{1}" -f $FilePath, $argText)
+  Push-Location $WorkingDirectory
+  try {
+    & $FilePath @Arguments
+    if (-not $AllowFailure -and $LASTEXITCODE -ne 0) {
+      throw "Command failed with exit code $LASTEXITCODE: $FilePath$argText"
+    }
+  }
+  finally {
+    Pop-Location
+  }
+}
+
+function Ensure-Directory {
+  param([Parameter(Mandatory = $true)][string]$Path)
+  New-Item -ItemType Directory -Force -Path $Path | Out-Null
+}
+
+function Remove-ManagedFiles {
+  param([Parameter(Mandatory = $true)][string]$Path)
+
+  if (-not (Test-Path -LiteralPath $Path -PathType Container)) {
+    return
+  }
+
+  Get-ChildItem -LiteralPath $Path -Recurse -File | ForEach-Object {
+    $file = $_
+    $matches = Select-String -Path $file.FullName -SimpleMatch -Pattern $ManagedMarker -Quiet -ErrorAction SilentlyContinue
+    if ($matches) {
+      Remove-Item -LiteralPath $file.FullName -Force
+      Write-Host "    Removed: $($file.FullName)"
+      $parent = Split-Path -Parent $file.FullName
+      if ($parent -and ([IO.Path]::GetFullPath($parent) -ne [IO.Path]::GetFullPath($Path))) {
+        try {
+          Remove-Item -LiteralPath $parent -Force -ErrorAction Stop
+        }
+        catch {
+        }
+      }
+    }
+  }
+}
+
+function Install-Claude {
+  param([Parameter(Mandatory = $true)][string]$SkillName)
+  $src = Join-Path $CompiledDir "claude\$SkillName\SKILL.md"
+  $destDir = Join-Path $ClaudeSkillsDir $SkillName
+  Ensure-Directory -Path $destDir
+  Copy-Item -LiteralPath $src -Destination (Join-Path $destDir 'SKILL.md') -Force
+  Write-Host "    Claude:   $(Join-Path $destDir 'SKILL.md')"
+}
+
+function Install-Cursor {
+  param([Parameter(Mandatory = $true)][string]$SkillName)
+  $srcRule = Join-Path $CompiledDir "cursor\rules\$SkillName.mdc"
+  Ensure-Directory -Path $CursorRulesDir
+  Copy-Item -LiteralPath $srcRule -Destination (Join-Path $CursorRulesDir "$SkillName.mdc") -Force
+  Write-Host "    Cursor (rule):  $(Join-Path $CursorRulesDir "$SkillName.mdc")"
+  $srcSkill = Join-Path $CompiledDir "cursor\skills\$SkillName\SKILL.md"
+  $destDir = Join-Path $CursorSkillsDir $SkillName
+  Ensure-Directory -Path $destDir
+  Copy-Item -LiteralPath $srcSkill -Destination (Join-Path $destDir 'SKILL.md') -Force
+  Write-Host "    Cursor (skill): $(Join-Path $destDir 'SKILL.md')"
+}
+
+function Install-Windsurf {
+  param([Parameter(Mandatory = $true)][string]$SkillName)
+  $srcRule = Join-Path $CompiledDir "windsurf\rules\$SkillName.md"
+  Ensure-Directory -Path $WindsurfRulesDir
+  Copy-Item -LiteralPath $srcRule -Destination (Join-Path $WindsurfRulesDir "$SkillName.md") -Force
+  Write-Host "    Windsurf (rule):  $(Join-Path $WindsurfRulesDir "$SkillName.md")"
+  $srcSkill = Join-Path $CompiledDir "windsurf\skills\$SkillName\SKILL.md"
+  $destDir = Join-Path $WindsurfSkillsDir $SkillName
+  Ensure-Directory -Path $destDir
+  Copy-Item -LiteralPath $srcSkill -Destination (Join-Path $destDir 'SKILL.md') -Force
+  Write-Host "    Windsurf (skill): $(Join-Path $destDir 'SKILL.md')"
+}
+
+function Install-OpenCode {
+  param([Parameter(Mandatory = $true)][string]$SkillName)
+  $src = Join-Path $CompiledDir "opencode\$SkillName.md"
+  $destRoot = $OpenCodeAgentsDirs[0]
+  Ensure-Directory -Path $destRoot
+  Copy-Item -LiteralPath $src -Destination (Join-Path $destRoot "$SkillName.md") -Force
+  Write-Host "    OpenCode: $(Join-Path $destRoot "$SkillName.md")"
+}
+
+function Install-Codex {
+  param([Parameter(Mandatory = $true)][string]$SkillName)
+  $src = Join-Path $CompiledDir "codex\$SkillName\SKILL.md"
+  $destDir = Join-Path $CodeXSkillsDir $SkillName
+  Ensure-Directory -Path $destDir
+  Copy-Item -LiteralPath $src -Destination (Join-Path $destDir 'SKILL.md') -Force
+  Write-Host "    Codex:    $(Join-Path $destDir 'SKILL.md')"
+}
+
+function Uninstall-Claude {
+  foreach ($skill in $Skills) {
+    $path = Join-Path $ClaudeSkillsDir $skill
+    if (Test-Path -LiteralPath $path) {
+      Remove-Item -LiteralPath $path -Recurse -Force
+    }
+  }
+  Write-Host '    Claude:   removed'
+}
+
+function Uninstall-Cursor {
+  foreach ($skill in $Skills) {
+    $rulePath = Join-Path $CursorRulesDir "$skill.mdc"
+    $skillPath = Join-Path $CursorSkillsDir $skill
+    if (Test-Path -LiteralPath $rulePath) {
+      Remove-Item -LiteralPath $rulePath -Force
+    }
+    if (Test-Path -LiteralPath $skillPath) {
+      Remove-Item -LiteralPath $skillPath -Recurse -Force
+    }
+  }
+  Write-Host '    Cursor:   removed'
+}
+
+function Uninstall-Windsurf {
+  foreach ($skill in $Skills) {
+    $rulePath = Join-Path $WindsurfRulesDir "$skill.md"
+    $skillPath = Join-Path $WindsurfSkillsDir $skill
+    if (Test-Path -LiteralPath $rulePath) {
+      Remove-Item -LiteralPath $rulePath -Force
+    }
+    if (Test-Path -LiteralPath $skillPath) {
+      Remove-Item -LiteralPath $skillPath -Recurse -Force
+    }
+  }
+  Write-Host '    Windsurf: removed'
+}
+
+function Uninstall-OpenCode {
+  foreach ($root in $OpenCodeAgentsDirs) {
+    foreach ($skill in $Skills) {
+      $path = Join-Path $root "$skill.md"
+      if (Test-Path -LiteralPath $path) {
+        Remove-Item -LiteralPath $path -Force
+      }
+    }
+  }
+  Write-Host '    OpenCode: removed'
+}
+
+function Uninstall-Codex {
+  foreach ($skill in $Skills) {
+    $path = Join-Path $CodeXSkillsDir $skill
+    if (Test-Path -LiteralPath $path) {
+      Remove-Item -LiteralPath $path -Recurse -Force
+    }
+  }
+  Write-Host '    Codex:    removed'
+}
+
+function Get-DetectedEditors {
+  $detected = New-Object System.Collections.Generic.List[string]
+  if (Test-Path -LiteralPath (Join-Path $UserHome '.claude')) { $detected.Add('claude') }
+  if (Test-Path -LiteralPath (Join-Path $UserHome '.cursor')) { $detected.Add('cursor') }
+  if ((Test-Path -LiteralPath (Join-Path $UserHome '.windsurf')) -or (Test-Path -LiteralPath (Join-Path $UserHome '.codeium\windsurf'))) { $detected.Add('windsurf') }
+  foreach ($root in $OpenCodeAgentsDirs) {
+    $parent = Split-Path -Parent $root
+    if (Test-Path -LiteralPath $parent) {
+      $detected.Add('opencode')
+      break
+    }
+  }
+  if ($env:CODEX_HOME -or (Test-Path -LiteralPath $CodeXHomeDir)) { $detected.Add('codex') }
+  return $detected.ToArray()
+}
+
+$targets = New-Object System.Collections.Generic.List[string]
+$doBuild = $true
+$doUninstall = $false
+$doCompileOnly = $false
+
+for ($i = 0; $i -lt $args.Count; $i++) {
+  switch ($args[$i]) {
+    '--claude' { $targets.Add('claude'); continue }
+    '--cursor' { $targets.Add('cursor'); continue }
+    '--windsurf' { $targets.Add('windsurf'); continue }
+    '--opencode' { $targets.Add('opencode'); continue }
+    '--codex' { $targets.Add('codex'); continue }
+    '--all' {
+      $targets.Clear()
+      @('claude', 'cursor', 'windsurf', 'opencode', 'codex') | ForEach-Object { $targets.Add($_) }
+      continue
+    }
+    '--skills-only' { $doBuild = $false; continue }
+    '--uninstall' { $doUninstall = $true; continue }
+    '--compile-only' { $doCompileOnly = $true; continue }
+    '--help' { Show-Help; exit 0 }
+    '-h' { Show-Help; exit 0 }
+    default {
+      Write-Error "Unknown option: $($args[$i])`nRun: powershell -ExecutionPolicy Bypass -File .\install-local.ps1 --help"
+    }
+  }
+}
+
+if ($doCompileOnly) {
+  Write-Host '==> Delegating to compile.mjs...'
+  Invoke-Step -FilePath 'node' -Arguments @((Join-Path $SkillDir 'skill\build\compile.mjs'))
+  exit 0
+}
+
+if ($targets.Count -eq 0) {
+  (Get-DetectedEditors) | ForEach-Object { $targets.Add($_) }
+}
+
+if ($targets.Count -eq 0) {
+  throw 'ERROR: No supported tools detected. Use --claude, --cursor, --windsurf, --opencode, or --codex.'
+}
+
+Write-Host "==> $ProjectName setup"
+Write-Host "    Project: $SkillDir"
+Write-Host "    Targets: $($targets -join ' ')"
+Write-Host ''
+
+if ($doUninstall) {
+  Write-Host "==> Uninstalling $ProjectName"
+  Write-Host "    Targets: $($targets -join ' ')"
+  Write-Host ''
+
+  foreach ($target in $targets) {
+    switch ($target) {
+      'claude' { Uninstall-Claude }
+      'cursor' { Uninstall-Cursor }
+      'windsurf' { Uninstall-Windsurf }
+      'opencode' { Uninstall-OpenCode }
+      'codex' { Uninstall-Codex }
+    }
+  }
+
+  Write-Host "--> Removing $CliBinName CLI..."
+  Invoke-Step -FilePath 'npm' -Arguments @('unlink', $ProjectName) -AllowFailure
+  $skillmillCmd = Get-Command $CliBinName -ErrorAction SilentlyContinue
+  if ($skillmillCmd) {
+    Write-Host "    WARNING: $CliBinName still in PATH at $($skillmillCmd.Source)"
+  }
+  else {
+    Write-Host "    $CliBinName removed"
+  }
+
+  Write-Host ''
+  Write-Host '==> Done. Skills and CLI removed.'
+  exit 0
+}
+
+if ($doBuild) {
+  Write-Host '--> Installing dependencies...'
+  Invoke-Step -FilePath 'npm' -Arguments @('install')
+
+  Write-Host '--> Cleaning previous build...'
+  $distDir = Join-Path $SkillDir 'dist'
+  if (Test-Path -LiteralPath $distDir) {
+    Remove-Item -LiteralPath $distDir -Recurse -Force
+  }
+
+  Write-Host '--> Building TypeScript...'
+  Invoke-Step -FilePath 'npm' -Arguments @('run', 'build')
+
+  Write-Host '--> Compiling skills...'
+  Invoke-Step -FilePath 'npm' -Arguments @('run', 'compile')
+
+  Write-Host "--> Installing $CliBinName CLI globally..."
+  Invoke-Step -FilePath 'npm' -Arguments @('link')
+
+  $npmPrefix = (& npm prefix -g).Trim()
+  if ($LASTEXITCODE -ne 0) {
+    throw 'Failed to determine npm global prefix.'
+  }
+  $candidateBins = @(
+    Join-Path $npmPrefix "$CliBinName.cmd",
+    Join-Path $npmPrefix $CliBinName,
+    Join-Path (Join-Path $npmPrefix 'bin') "$CliBinName.cmd",
+    Join-Path (Join-Path $npmPrefix 'bin') $CliBinName
+  )
+  $cliPath = $candidateBins | Where-Object { Test-Path -LiteralPath $_ } | Select-Object -First 1
+  if ($cliPath) {
+    Write-Host "    $CliBinName: $cliPath"
+    $cliVersion = (& $cliPath --version 2>$null)
+    if ($LASTEXITCODE -eq 0 -and $cliVersion) {
+      Write-Host "    version:  $cliVersion"
+    }
+    else {
+      Write-Host '    version:  unknown'
+    }
+  }
+  else {
+    Write-Host "    WARNING: $CliBinName not found under npm global prefix after npm link."
+    Write-Host '    Try running: npm link'
+  }
+}
+
+Write-Host "--> Cleaning stale $ProjectName files..."
+foreach ($target in $targets) {
+  switch ($target) {
+    'claude' { Remove-ManagedFiles -Path $ClaudeSkillsDir }
+    'cursor' {
+      Remove-ManagedFiles -Path $CursorRulesDir
+      Remove-ManagedFiles -Path $CursorSkillsDir
+    }
+    'windsurf' {
+      Remove-ManagedFiles -Path $WindsurfRulesDir
+      Remove-ManagedFiles -Path $WindsurfSkillsDir
+    }
+    'opencode' {
+      foreach ($root in $OpenCodeAgentsDirs) {
+        Remove-ManagedFiles -Path $root
+      }
+    }
+    'codex' { Remove-ManagedFiles -Path $CodeXSkillsDir }
+  }
+}
+
+Write-Host '--> Installing skills...'
+foreach ($skill in $Skills) {
+  Write-Host "  ${skill}:"
+  foreach ($target in $targets) {
+    switch ($target) {
+      'claude' { Install-Claude -SkillName $skill }
+      'cursor' { Install-Cursor -SkillName $skill }
+      'windsurf' { Install-Windsurf -SkillName $skill }
+      'opencode' { Install-OpenCode -SkillName $skill }
+      'codex' { Install-Codex -SkillName $skill }
+    }
+  }
+}
+
+Write-Host ''
+Write-Host '==> Done.'
+Write-Host ''
+Write-Host "Skills installed for: $($targets -join ' ')"
+Write-Host "CLI available as: $CliBinName"

package/install.ps1

@@ -0,0 +1,48 @@
+$ErrorActionPreference = 'Stop'
+
+$PackageName = if ($env:SKILLMILL_PACKAGE_NAME) { $env:SKILLMILL_PACKAGE_NAME } else { 'agentic-skill-mill' }
+$PackageVersion = if ($env:SKILLMILL_PACKAGE_VERSION) { $env:SKILLMILL_PACKAGE_VERSION } else { 'latest' }
+
+if ($args.Count -gt 0 -and ($args[0] -eq '--help' -or $args[0] -eq '-h')) {
+  Write-Host 'Usage: powershell -ExecutionPolicy Bypass -File .\install.ps1 [tool flags]'
+  Write-Host ''
+  Write-Host "This script installs ${PackageName}@${PackageVersion} globally and then"
+  Write-Host 'runs install-local.ps1 --skills-only with the flags you provide.'
+  Write-Host ''
+  Write-Host 'Examples:'
+  Write-Host '  powershell -ExecutionPolicy Bypass -File .\install.ps1 --all'
+  Write-Host '  powershell -ExecutionPolicy Bypass -File .\install.ps1 --cursor'
+  Write-Host ''
+  Write-Host 'Environment overrides:'
+  Write-Host '  SKILLMILL_PACKAGE_NAME    Package to install (default: agentic-skill-mill)'
+  Write-Host '  SKILLMILL_PACKAGE_VERSION Version tag (default: latest)'
+  exit 0
+}
+
+Write-Host "==> Installing utility library: ${PackageName}@${PackageVersion}"
+& npm install -g "${PackageName}@${PackageVersion}"
+if ($LASTEXITCODE -ne 0) {
+  throw 'npm install -g failed.'
+}
+
+$globalNodeModules = (& npm root -g).Trim()
+if ($LASTEXITCODE -ne 0 -or -not $globalNodeModules) {
+  throw 'Failed to resolve npm global node_modules directory.'
+}
+
+$packageDir = Join-Path $globalNodeModules $PackageName
+$localInstaller = Join-Path $packageDir 'install-local.ps1'
+
+if (-not (Test-Path -LiteralPath $localInstaller -PathType Leaf)) {
+  throw "ERROR: Could not find install-local.ps1 at: $localInstaller`nCheck the package 'files' list to ensure install-local.ps1 is published."
+}
+
+Write-Host '==> Installing skills via local installer (skills-only mode)'
+& powershell -ExecutionPolicy Bypass -File $localInstaller --skills-only @args
+if ($LASTEXITCODE -ne 0) {
+  throw 'The local PowerShell installer failed.'
+}
+
+Write-Host ''
+Write-Host '==> Done.'
+Write-Host 'Utility and skills installed.'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-skill-mill",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Forge and refine agent skill projects -- fragment-composed skills compiled to 7 IDE targets with a companion CLI",
   "type": "module",
   "bin": {
@@ -20,7 +20,9 @@
     "skill",
     "README.md",
     "install.sh",
-    "install-local.sh"
+    "install-local.sh",
+    "install.ps1",
+    "install-local.ps1"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
@@ -31,8 +33,12 @@
     "typecheck": "tsc --noEmit",
     "setup": "bash install-local.sh",
     "setup:all": "bash install-local.sh --all",
+    "setup:windows": "powershell -ExecutionPolicy Bypass -File ./install-local.ps1",
+    "setup:windows:all": "powershell -ExecutionPolicy Bypass -File ./install-local.ps1 --all",
     "install-skills": "bash install-local.sh --skills-only",
+    "install-skills:windows": "powershell -ExecutionPolicy Bypass -File ./install-local.ps1 --skills-only",
     "uninstall-skills": "bash install-local.sh --uninstall",
+    "uninstall-skills:windows": "powershell -ExecutionPolicy Bypass -File ./install-local.ps1 --uninstall",
     "compile": "node skill/build/compile.mjs",
     "compile:validate": "node skill/build/compile.mjs --validate",
     "compile:watch": "node skill/build/compile.mjs --watch"

package/skill/build/manifest.json

@@ -13,6 +13,7 @@
       "source": "skills/agentic-skill-mill/agentic-skill-mill.md",
       "fragments": [
         "meta/architecture-overview.md",
+        "meta/distribution-and-ci.md",
         "meta/research-to-code.md",
         "meta/core-module-pattern.md",
         "meta/cli-command-pattern.md",

package/skill/fragments/meta/architecture-overview.md

@@ -6,9 +6,15 @@ Skills (what to do)          CLI Companion (tools to do it with)
   skill/fragments/*.md         src/core/*.ts
           |                            |
           v                            v
-  compiled/ (7 IDE formats)    dist/ (npm link -> global CLI)
+  compiled/ (7 IDE formats)    dist/ (npm -> npx or global CLI)
           |                            |
           +---------> Agent <----------+
+                        ^
+                        |
+  Distribution: npm publish + agenticskillmill.com
+    .github/workflows/release.yml    (build, test, version, publish)
+    .github/workflows/deploy-pages.yml (site/ -> GitHub Pages)
+    site/install.sh                  (curl-friendly bootstrap)
 ```
 
 **Skills** are step-by-step runbooks in markdown with YAML frontmatter. They tell the agent *what* to do. Skills reference the CLI by name so the agent can invoke structured commands.
@@ -34,4 +40,7 @@ Skills (what to do)          CLI Companion (tools to do it with)
 | Add a CLI command | `src/core/<name>.ts`, `src/cli/commands/<name>.ts`, `src/cli/index.ts`, `src/index.ts` |
 | Add a fragment | `skill/fragments/<category>/<name>.md`, `skill/build/manifest.json`, skill source |
 | Add a skill | `skill/skills/<name>/<name>.md`, `skill/build/manifest.json`, `install-local.sh` SKILLS array |
+| Change installer behavior | `install.sh` (repo root) then copy to `site/install.sh` |
+| Update the landing page | `site/index.html`, `site/style.css` |
+| Change CI secrets or workflow | `.github/workflows/release.yml` or `deploy-pages.yml`, repo settings |
 | Rename the project | See the rename workflow |

package/skill/fragments/meta/distribution-and-ci.md

@@ -0,0 +1,77 @@
+### Distribution model
+
+The project is published to npmjs as a public package and hosted at `https://agenticskillmill.com`. There are three ways users consume it:
+
+| Method | Command | Who uses it |
+|--------|---------|-------------|
+| Remote install (no clone) | `bash <(curl -fsSL https://agenticskillmill.com/install.sh) --all` | End users who want skills installed into their IDE tools |
+| npx (no install) | `npx --yes agentic-skill-mill@latest <command>` | Users running CLI commands without global install |
+| Local development | `git clone` then `bash install-local.sh --all` | Contributors working on the project itself |
+
+### Two installer scripts
+
+**`install-local.sh`** is the full local installer. It runs from a cloned repo and handles:
+- `npm install` + `npm run build` + `npm run compile`
+- `npm link` to make `skillmill` available globally
+- Copies compiled skill outputs to IDE-specific directories (~/.claude/skills, ~/.cursor/rules, etc.)
+- Supports `--skills-only` (skip build, just copy), `--uninstall`, `--compile-only`, and per-tool flags (`--cursor`, `--claude`, etc.)
+- Auto-detects installed tools when no flags are provided
+
+**`install.sh`** is the remote bootstrap installer. It is hosted at `https://agenticskillmill.com/install.sh` (source: `site/install.sh`) and bundled in the npm package. It:
+1. Runs `npm install -g agentic-skill-mill@latest`
+2. Locates `install-local.sh` inside the globally installed package
+3. Delegates to `install-local.sh --skills-only` with the user's flags
+
+Both scripts respect environment overrides `SKILLMILL_PACKAGE_NAME` and `SKILLMILL_PACKAGE_VERSION`.
+
+### npm package contents
+
+The `files` array in `package.json` controls what ships to npm:
+
+| Entry | Purpose |
+|-------|---------|
+| `dist` | Compiled TypeScript CLI and library |
+| `compiled` | Pre-compiled skill outputs for all 7 IDE targets |
+| `skill` | Skill sources, fragments, compiler, and manifest |
+| `README.md` | Package documentation |
+| `install.sh` | Bootstrap installer (bundled for remote delegation) |
+| `install-local.sh` | Full local installer (used by bootstrap in --skills-only mode) |
+
+The `bin` field maps `skillmill` to `dist/cli/index.js`, so `npx agentic-skill-mill` and global install both expose the `skillmill` command.
+
+### GitHub Actions workflows
+
+**Release to npm** (`.github/workflows/release.yml`):
+- Triggers on push to `main` or `workflow_dispatch`
+- Skips runs caused by its own release commits (loop guard via `chore(release):` in commit message)
+- Steps: `npm ci` -> `npm run build` -> `npm run test -- --passWithNoTests` -> `npm run compile` -> `npm run compile:validate` -> version bump -> `git push --follow-tags` -> `npm publish --access public`
+- Version bump finds the next available patch tag to avoid collisions with existing tags
+- Required secrets: `AGENT_TOKEN` (PAT with repo scope for push), `AGENT_NPM_TOKEN` (npm automation token for publish)
+
+**Deploy GitHub Pages** (`.github/workflows/deploy-pages.yml`):
+- Triggers on push to `main` when files in `site/` change, or `workflow_dispatch`
+- Uploads `site/` directory as the Pages artifact
+- Deploys to the `github-pages` environment at `agenticskillmill.com`
+
+### The `site/` directory
+
+Static site served via GitHub Pages at `https://agenticskillmill.com`:
+
+| File | Purpose |
+|------|---------|
+| `site/CNAME` | Custom domain binding |
+| `site/index.html` | Landing page with architecture, CLI commands, and install instructions |
+| `site/style.css` | Site styles |
+| `site/install.sh` | Bootstrap installer served at `https://agenticskillmill.com/install.sh` |
+
+When updating the bootstrap installer logic, edit `install.sh` at the repo root and copy it to `site/install.sh` to keep both in sync. The release workflow publishes the repo-root copy to npm; the Pages workflow serves the site copy to the domain.
+
+### Modifying distribution touchpoints
+
+| Change | Files to update |
+|--------|----------------|
+| Add a new skill | `install-local.sh` SKILLS array, `skill/build/manifest.json` |
+| Change package name | `package.json` name + bin, `install.sh` default, `site/install.sh` default, `install-local.sh` PROJECT_NAME + CLI_BIN_NAME + MANAGED_MARKER, `site/index.html`, README |
+| Change bootstrap behavior | `install.sh` (repo root), then copy to `site/install.sh` |
+| Add a GitHub Actions secret | Repo settings, document in README |
+| Update domain | `site/CNAME`, README, skill source, architecture fragment |

package/skill/fragments/meta/rename-workflow.md

@@ -22,17 +22,23 @@ When the project, skill, or CLI needs a new name, update all touchpoints in one
 
 4. **Compiler marker** (`skill/build/compile.mjs`) -- update the `MANAGED_BY` constant
 
-5. **Installer** (`install-local.sh`) -- update `PROJECT_NAME`, `CLI_BIN_NAME`, `MANAGED_MARKER`, `SKILLS` array
+5. **Local installer** (`install-local.sh`) -- update `PROJECT_NAME`, `CLI_BIN_NAME`, `MANAGED_MARKER`, `SKILLS` array
 
-6. **Package metadata** (`package.json`) -- update `name` and `bin` key
+6. **Bootstrap installer** (`install.sh`) -- update the default `PACKAGE_NAME`, then copy to `site/install.sh`
 
-7. **CLI metadata** (`src/cli/index.ts`) -- update `.name()` and `.description()` calls
+7. **Package metadata** (`package.json`) -- update `name`, `bin` key, and `description`
 
-8. **README** -- update title, CLI references, project layout example
+8. **CLI metadata** (`src/cli/index.ts`) -- update `.name()` and `.description()` calls
 
-9. **Any docs** referencing the old name (translation-map, lessons-learned, etc.)
+9. **README** -- update title, CLI references, project layout, npx examples, install URLs
 
-10. **Regenerate everything:**
+10. **Landing page** (`site/index.html`) -- update title, CLI references, install commands, GitHub link
+
+11. **GitHub Actions secrets** -- if the npm package name changed, verify `AGENT_NPM_TOKEN` still works for the new package scope
+
+12. **Any docs** referencing the old name (translation-map, lessons-learned, etc.)
+
+13. **Regenerate everything:**
     ```bash
     rm -rf compiled
     npm install          # regenerates package-lock.json
@@ -45,7 +51,7 @@ When the project, skill, or CLI needs a new name, update all touchpoints in one
 After renaming, run this sweep to confirm no stale references remain:
 
 ```bash
-grep -r "<old-name>" --include="*.md" --include="*.json" --include="*.mjs" --include="*.ts" --include="*.sh" .
+grep -r "<old-name>" --include="*.md" --include="*.json" --include="*.mjs" --include="*.ts" --include="*.sh" --include="*.html" --include="*.yml" .
 ```
 
 The grep should return zero results (excluding node_modules and dist).

package/skill/skills/agentic-skill-mill/agentic-skill-mill.md

@@ -15,6 +15,12 @@ Forge and refine skill projects that follow the skill-system-template architectu
 
 ---
 
+## Distribution and CI
+
+{{include:meta/distribution-and-ci.md}}
+
+---
+
 ## Workflow
 
 ### Step 1: Understand the Goal