{
  "slug": "netlify-init-installs-and-syncs-netlify-agent-skills-d275e7df847a",
  "title": "netlify init installs and syncs Netlify agent skills",
  "tools": [
    "netlify"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-10-08T18:35:08.000Z",
  "announced_at": "2026-10-08T18:35:08.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When initializing a repository or syncing installed Netlify skills, run `netlify init`; use `--skip-agent-setup` to skip skill installation or `--reset-context` to replace edited skills and migrate or delete edited copies under renamed or deprecated names.",
    "examples": [
      "netlify init",
      "netlify init --skip-agent-setup",
      "netlify init --reset-context"
    ],
    "gotchas": [
      "Version: v27.12.0",
      "--skip-agent-setup: Boolean flag; skip installing Netlify skills for AI coding agents into the project.",
      "--reset-context: Boolean flag; replace locally edited Netlify skills with the latest release, and migrate or delete edited copies under renamed or deprecated names.",
      "Prerequisite: Netlify CLI requires Node.js version 22.13.0 or above.",
      "A failed download warns and lets `init` continue.",
      "Locally edited copies are kept and listed unless `--reset-context` is used.",
      "A directory is removed only when its tree hash matches a shipped release and is re-hashed immediately before removal, or under `--reset-context` when it has a manifest name.",
      "Unknown directories, symlinks, and directories that differ from a skill name only by case on macOS are left alone, with or without `--reset-context`.",
      "Each request times out after 10 seconds."
    ]
  },
  "why_it_matters": "Initialize a repository with current Netlify skills for AI coding agents, or reconcile its installed skills with the hosted manifest.",
  "before": "Copy Netlify skills into the project manually; rerunning `init` left skills under prior or deprecated names in place and provided no way to restore an edited skill to the shipped release.",
  "sources": [
    "https://github.com/netlify/cli/releases/tag/v27.12.0",
    "https://github.com/netlify/cli/pull/8555",
    "https://github.com/netlify/cli/pull/8556",
    "https://github.com/netlify/cli/blob/v27.12.0/docs/commands/init.md",
    "https://github.com/netlify/cli/blob/v27.12.0/README.md"
  ],
  "rank": 0.92042,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2a-20261017",
    "verdict_id": "wave2a-20261017:wave2a-20261017-de9392684e6cfd44-0:gate",
    "evidence_hash": "053825ee4c6a6f864dd389ac89777953b57ef791ff99862ce28d7a29687d958c"
  },
  "review": {
    "draft_hash": "b2bb77292ad55bc4a0c4c8ffff0322cfe548d82c315737c0bc8eca5e3dd07847",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-08T18:35:08.000Z",
    "decision": "wave2a-20261017:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.92 >= 0.9; 2 needed) and Jev gave 0.71 (>= 0.6 needed)."
  }
}