plugin: add Safari extension control skill

plugins/agent-plugin-skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-plugin-skills",
-  "version": "6.7.26",
+  "version": "6.8.0",
   "description": "Installable maintainer skills for skills-export repositories.",
   "author": {
     "name": "Gale",

plugins/agent-plugin-skills/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-plugin-skills-maintenance"
-version = "6.7.26"
+version = "6.8.0"
 description = "Maintainer-only Python tooling baseline for agent-plugin-skills."
 requires-python = ">=3.11"
 dependencies = []

plugins/apple-dev-skills/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "apple-dev-skills",
-  "version": "6.7.26",
-  "description": "Apple development workflows for Codex, including SwiftUI architecture and DocC authoring guidance.",
+  "version": "6.8.0",
+  "description": "Apple development workflows for Codex, including SwiftUI architecture, Safari extensions, and DocC authoring guidance.",
   "author": {
     "name": "Gale",
     "email": "mail@galewilliams.com",
@@ -18,15 +18,16 @@
     "xcode",
     "mcp",
     "swiftui",
+    "safari",
     "ios",
     "macos"
   ],
   "skills": "./skills/",
   "mcpServers": "./.mcp.json",
   "interface": {
     "displayName": "Apple Dev Skills",
-    "shortDescription": "Apple, Swift, Xcode, SwiftUI, and DocC workflows for Codex.",
-    "longDescription": "Bundle Apple-platform development skills for Swift, SwiftUI architecture, Xcode, SwiftPM, DocC authoring and review, testing, formatting, and repository guidance work across iOS, macOS, and related Apple tooling. Most workflows work standalone; bootstrap and guidance-sync workflows that install or refresh repo-maintenance files require the companion Productivity Skills plugin, or the socket marketplace that installs both.",
+    "shortDescription": "Apple, Swift, Xcode, SwiftUI, Safari, and DocC workflows for Codex.",
+    "longDescription": "Bundle Apple-platform development skills for Swift, SwiftUI architecture, Safari extension, Safari Web Inspector, and SafariServices integration, Xcode, SwiftPM, DocC authoring and review, testing, formatting, and repository guidance work across iOS, macOS, and related Apple tooling. Most workflows work standalone; bootstrap and guidance-sync workflows that install or refresh repo-maintenance files require the companion Productivity Skills plugin, or the socket marketplace that installs both.",
     "developerName": "Gale",
     "category": "Developer Tools",
     "capabilities": [
@@ -36,6 +37,7 @@
     "websiteURL": "https://github.com/gaelic-ghost/apple-dev-skills",
     "defaultPrompt": [
       "Explore the relevant Apple docs first, then explain the right SwiftUI or Xcode path for this repository.",
+      "Choose the right Safari extension, Safari Web Inspector, SafariServices, messaging, content blocker, or automation fallback path for this Mac app.",
       "Help me build, test, or debug this Swift or Xcode project using the repo's Apple workflows.",
       "Write or review DocC symbol comments, articles, extension files, and landing-page structure for this Swift repository.",
       "Sync the Apple project guidance in this repo without hand-editing Xcode project files, using Productivity Skills when repo-maintenance files must be installed or refreshed."

plugins/apple-dev-skills/.github/scripts/sync_shared_snippets.sh

@@ -33,6 +33,7 @@ sync_one \
   "$ROOT_DIR/skills/bootstrap-xcode-app-project/references/snippets/apple-xcode-project-core.md" \
   "$ROOT_DIR/skills/format-swift-sources/references/snippets/apple-xcode-project-core.md" \
   "$ROOT_DIR/skills/explore-apple-swift-docs/references/snippets/apple-xcode-project-core.md" \
+  "$ROOT_DIR/skills/safari-extension-control-workflow/references/snippets/apple-xcode-project-core.md" \
   "$ROOT_DIR/skills/swiftui-app-architecture-workflow/references/snippets/apple-xcode-project-core.md" \
   "$ROOT_DIR/skills/sync-xcode-project-guidance/references/snippets/apple-xcode-project-core.md"
 

plugins/apple-dev-skills/.github/scripts/validate_repo_docs.sh

@@ -113,6 +113,7 @@ active_skill_mds=(
   "./skills/swift-package-testing-workflow/SKILL.md"
   "./skills/swift-package-workflow/SKILL.md"
   "./skills/author-swift-docc-docs/SKILL.md"
+  "./skills/safari-extension-control-workflow/SKILL.md"
   "./skills/swiftui-app-architecture-workflow/SKILL.md"
   "./skills/apple-ui-accessibility-workflow/SKILL.md"
   "./skills/explore-apple-swift-docs/SKILL.md"
@@ -123,7 +124,7 @@ active_skill_mds=(
   "./skills/sync-xcode-project-guidance/SKILL.md"
   "./skills/sync-swift-package-guidance/SKILL.md"
 )
-[[ ${#active_skill_mds[@]} -eq 16 ]] || fail "Expected exactly 16 active skills, found ${#active_skill_mds[@]}."
+[[ ${#active_skill_mds[@]} -eq 17 ]] || fail "Expected exactly 17 active skills, found ${#active_skill_mds[@]}."
 
 shared_xcode_snippet="./shared/agents-snippets/apple-xcode-project-core.md"
 shared_package_snippet="./shared/agents-snippets/apple-swift-package-core.md"
@@ -209,6 +210,7 @@ for file in \
   "skills/xcode-testing-workflow/SKILL.md" \
   "skills/xcode-build-run-workflow/SKILL.md" \
   "skills/author-swift-docc-docs/SKILL.md" \
+  "skills/safari-extension-control-workflow/SKILL.md" \
   "skills/swiftui-app-architecture-workflow/SKILL.md" \
   "skills/sync-swift-package-guidance/SKILL.md" \
   "skills/sync-xcode-project-guidance/SKILL.md" \

plugins/apple-dev-skills/README.md

@@ -1,6 +1,6 @@
 # apple-dev-skills
 
-Apple, Swift, SwiftUI, Xcode, DocC, and `Dash.app` workflows for Codex.
+Apple, Swift, SwiftUI, Safari, Xcode, DocC, and `Dash.app` workflows for Codex.
 
 ![Codex plugin directory filtered to the Socket marketplace, showing Apple Dev Skills listed alongside companion plugins below a Productivity Skills suggestion.](./docs/media/codex-plugin-directory-socket-apple-dev-skills.png)
 
@@ -57,6 +57,7 @@ Use Apple Dev Skills when an agent is helping with:
 
 - Swift and SwiftUI implementation
 - Xcode build, run, test, and project workflows
+- Safari extension and SafariServices integration choices
 - Swift package bootstrap, build, and testing
 - Apple UI accessibility work
 - DocC comments, articles, and documentation catalogs
@@ -116,6 +117,7 @@ uv run pytest
 - `bootstrap-xcode-app-project`
 - `explore-apple-swift-docs`
 - `format-swift-sources`
+- `safari-extension-control-workflow`
 - `structure-swift-sources`
 - `swift-package-build-run-workflow`
 - `swift-package-testing-workflow`

plugins/apple-dev-skills/ROADMAP.md

@@ -17,6 +17,7 @@
 - [Milestone 39: Swift Package Index Workflow](#milestone-39-swift-package-index-workflow)
 - [Milestone 40: SwiftUI UI Architecture Workflow](#milestone-40-swiftui-ui-architecture-workflow)
 - [Milestone 41: Swift Package Extension Workflow](#milestone-41-swift-package-extension-workflow)
+- [Milestone 42: Safari Extension And Control Workflow](#milestone-42-safari-extension-and-control-workflow)
 - [Backlog Candidates](#backlog-candidates)
 - [History](#history)
 
@@ -47,6 +48,7 @@
 - Milestone 39: Swift Package Index Workflow - Planned
 - Milestone 40: SwiftUI UI Architecture Workflow - Completed
 - Milestone 41: Swift Package Extension Workflow - Planned
+- Milestone 42: Safari Extension And Control Workflow - Completed
 
 ## Milestone 21: Swift Cleanup Automation Exploration
 
@@ -391,12 +393,39 @@ Planned
 - [ ] Bootstrap and guidance-sync outputs encode the Swift `6.3.x` / `6.2.x` support window.
 - [ ] The skill is covered by repo validation and targeted tests.
 
+## Milestone 42: Safari Extension And Control Workflow
+
+### Status
+
+Completed
+
+### Scope
+
+- [x] Add a dedicated Safari workflow for choosing between Safari Web Extensions, Safari Web Inspector Extensions, Safari App Extensions, content blockers, SafariServices APIs, app-to-extension messaging, authentication surfaces, and external automation fallbacks.
+- [x] Keep the workflow docs-first and explicit about Apple-documented Safari behavior before implementation choices.
+- [x] Teach agents to treat "control Safari from a macOS app" as a scoped integration question rather than assuming unrestricted browser control.
+- [x] Keep Xcode target, signing, entitlement, build, run, and testing work routed into the existing Xcode skills.
+
+### Tickets
+
+- [x] Add `safari-extension-control-workflow` with repo-standard skill metadata, OpenAI interface metadata, customization contract files, and shared Xcode policy snippet coverage.
+- [x] Add references for extension-shape choice, Safari Web Inspector Extensions, SafariServices control surfaces, messaging and shared data, permissions, testing, debugging, and distribution.
+- [x] Add targeted pytest coverage for extension-shape boundaries, supported control surfaces, messaging contexts, privacy posture, and explicit handoffs.
+- [x] Update the active skill inventory, repo validator, shared-snippet sync script, README, and customization review counts.
+
+### Exit Criteria
+
+- [x] The repository ships `safari-extension-control-workflow` as the explicit owner for Safari extension and SafariServices integration-shape guidance.
+- [x] The workflow keeps WebExtension, Safari Web Inspector Extension, Safari App Extension, content blocker, authentication, and external automation paths distinct.
+- [x] The skill is covered by repo validation and targeted tests.
+
 ## Backlog Candidates
 
 - [ ] Record plausible future work that is not yet committed to a milestone.
 
 ## History
 
+- Added `safari-extension-control-workflow` as the explicit owner for Safari Web Extension, Safari Web Inspector Extension, Safari App Extension, SafariServices, messaging, content blocker, authentication, and external automation decision guidance.
 - Tightened Xcode project guidance so tracked `.pbxproj` diffs produced by Xcode, XcodeGen, or other project-aware workflows are treated as critical project state that must be reviewed, staged, and committed before push, merge, release, or cleanup.
 - Updated standalone install guidance so `apple-dev-skills` defaults to Codex's Git-backed marketplace add/upgrade flow without an explicit ref, documents the optional `socket` marketplace path for Gale's broader plugin set, and keeps manual local clone marketplaces as development and fallback paths.
 - Tightened the Swift public API guidance across shared snippets, skill-local snippet copies, and generated `AGENTS.md` templates so public call sites default to streamlined typed APIs, optional defaulted parameters over overloads, request/options structs at four or more public parameters, and enum-backed choice modeling.

plugins/apple-dev-skills/docs/maintainers/customization-consolidation-review.md

@@ -8,8 +8,8 @@ Record the Milestone 20 audit of the current customization system, decide whethe
 
 ## Current State Summary
 
-- The active skill surface ships `16` separate `references/customization.template.yaml` files.
-- The active skill surface ships `16` separate `scripts/customization_config.py` entrypoints.
+- The active skill surface ships `17` separate `references/customization.template.yaml` files.
+- The active skill surface ships `17` separate `scripts/customization_config.py` entrypoints.
 - Those `customization_config.py` files are functionally identical and exist only because installed skills are expected to keep runtime resources inside the skill directory.
 - The current templates expose `21` knobs total:
   - `20` are documented as `runtime-enforced`
@@ -30,7 +30,7 @@ Milestone 20 audited a larger surface before the implementation pass landed.
 - Milestone 27 applied the approved reduction so the live surface now reflects the smaller counts in the current-state summary above.
 - Milestone 38 later added the narrower `author-swift-docc-docs` skill with one runtime-enforced tutorial-handling knob, which is included in the current-state counts above.
 - The current-state counts also include `structure-swift-sources`, which now ships runtime-enforced header-policy and split-threshold knobs for the structural-cleanup workflow.
-- The current-state counts now also include the policy-only `apple-ui-accessibility-workflow` and `swiftui-app-architecture-workflow` surfaces, both of which keep the customization-file contract without introducing runtime knobs.
+- The current-state counts now also include the policy-only `apple-ui-accessibility-workflow`, `safari-extension-control-workflow`, and `swiftui-app-architecture-workflow` surfaces, all of which keep the customization-file contract without introducing runtime knobs.
 
 ## Decision
 

plugins/apple-dev-skills/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "apple-dev-skills-maintainer"
-version = "6.7.26"
+version = "6.8.0"
 description = "Maintainer tooling for the apple-dev-skills repository"
 requires-python = ">=3.9"
 dependencies = []