@open-agent-toolkit/cli 0.1.73 → 0.1.76

package/assets/docs/provider-sync/scope-and-surface.md

@@ -13,7 +13,8 @@ This capability is intentionally independent from OAT workflow artifacts. Teams
 
 - Canonical directories: `.agents/skills`, `.agents/agents`, `.agents/rules`
 - Managed provider views: `.claude/*`, `.cursor/*`, `.github/*`, `.copilot/*`, `.codex/*` (where applicable)
-- Native-read providers may use canonical `.agents/*` directly without mirrored provider directories (for example, Gemini and Codex canonical mappings)
+- Native-read mappings use canonical `.agents/*` directly without mirrored provider directories. Cursor skills, Gemini skills and agents, and Codex canonical mappings use this model.
+- Cursor's `.cursor/skills` and `~/.cursor/skills` directories are provider-local extension and adoption surfaces, not managed output directories.
 - Manifest tracking: `.oat/sync/manifest.json` (project) and `~/.oat/sync/manifest.json` (user)
 
 Rules are currently project-scoped canonical content. Unlike skills and agents, synced rule files for Claude, Cursor, and Copilot are rendered copies with provider-specific frontmatter and filename extensions.
@@ -24,6 +25,8 @@ Rules are currently project-scoped canonical content. Unlike skills and agents,
 - Explicit `--dry-run` for safe preview of mutations
 - Scoped destructive actions only for manifest-tracked entries
 - Cross-provider compatibility via adapters
+- Native-read assets stay canonical while provider-local adoption sources remain discoverable independently
+- Obsolete managed mappings are deleted only when their provider paths are verified clean; changed or unverified paths are preserved and detached from manifest ownership
 - Canonical `.agents/agents` is source of truth for subagents; provider views are derived
 - Canonical `.agents/rules` is source of truth for rules; provider rule files are derived rendered copies
 
@@ -47,6 +50,7 @@ Rules are currently project-scoped canonical content. Unlike skills and agents,
 - Project provider enablement is stored in `.oat/sync/config.json` (`providers.<name>.enabled`).
 - `oat init --scope project` (interactive) prompts for supported providers and persists explicit true/false values.
 - `oat sync --scope project` uses config-aware provider activation and can prompt to remediate detected mismatches.
+- Cursor provider enablement still controls agents, rules, migration discovery, and legacy cleanup even though Cursor reads canonical skills without a generated skill view.
 - Codex project-scope subagent sync writes `.codex/config.toml` and `.codex/agents/*.toml` at command layer after path-mapping sync. Every generated project Codex variant and registration is repository-owned, version-controlled provider output. OAT provides no automatic ignore mechanism for this project output; collaborators review and commit it like other project configuration.
 - Default Codex execution requires `root (0) → phase implementer (1)`. Sync and direct materialization continue to apply an `agents.max_depth` floor of `2` as optional nested-work capability without lowering a higher target value. A project write may read a higher lower-precedence user value and preserves it in project configuration; it writes only project `.codex/config.toml`. User scope writes only `~/.codex/config.toml` and does not read or change project configuration.
 - Missing depth or depth `1` does not block default phase execution. Invalid values or explicit values below `1` fail managed implementation preflight. `oat doctor` reports whether optional depth-two nesting is available and gives a scope-specific repair when the configured value is unusable.

package/assets/docs/reference/file-locations.md

@@ -14,6 +14,9 @@ For detailed `.oat/` tree semantics, see:
 - Skills: `.agents/skills/`
 - Agents/subagents: `.agents/agents/`
 - Rules: `.agents/rules/`
+- Cursor reads project skills directly from `.agents/skills/` and user skills
+  directly from `~/.agents/skills/`. `.cursor/skills/` remains a Cursor-only
+  extension and adoption surface, not generated output.
 
 ## OAT runtime/state
 
@@ -23,11 +26,12 @@ For detailed `.oat/` tree semantics, see:
 - Projects root config: `projects.root` in `.oat/config.json` (read via `oat config get projects.root`)
 - Archive config: `archive.s3Uri`, `archive.s3SyncOnComplete`, `archive.summaryExportPath`, `archive.wrapUpExportPath`, `archive.awsProfile`, and `archive.awsRegion` in `.oat/config.json`
 - Workflow gate config: `workflow.gates.skills` and `workflow.gates.execTargets` in `.oat/config.json`, `.oat/config.local.json`, or `~/.oat/config.json` (manage via `oat gate`)
-- Project manifests/config: `.oat/sync/`
+- Project sync manifest/config: `.oat/sync/`
+- User sync manifest/config: `~/.oat/sync/`
 
 Config discovery via CLI:
 
-- `oat config describe` lists the supported config surfaces and keys across `.oat/config.json`, `.oat/config.local.json`, `~/.oat/config.json`, and `.oat/sync/config.json`.
+- `oat config describe` lists the supported config surfaces and keys across `.oat/config.json`, `.oat/config.local.json`, `~/.oat/config.json`, `.oat/sync/config.json`, and `~/.oat/sync/config.json`.
 - `oat config describe <key>` shows file location, scope, default, mutability, and the owning command for one key.
 - `oat config list` shows the currently resolved values for the repo-local/shared command surface.
 
@@ -36,7 +40,9 @@ Config ownership note:
 - `.oat/config.json` is the canonical home for shared non-sync settings (for example, `worktrees.root`, `projects.root`).
 - `.oat/config.local.json` is the canonical home for per-developer lifecycle state (for example, `activeProject`, `lastPausedProject`, `activeIdea`).
 - `~/.oat/config.json` is the canonical home for user-level state (for example, `activeIdea` at global scope).
-- `.oat/sync/config.json` remains the sync/provider config contract.
+- `.oat/sync/config.json` owns project sync/provider settings and known strays.
+- `~/.oat/sync/config.json` owns user sync/provider settings and personal known
+  strays. OAT migrates the legacy `~/.oat/config.json#knownStrays` key here.
 - Legacy `.oat/active-project` / `.oat/projects-root` / `.oat/active-idea` files may still exist as inert compatibility artifacts in some repos/worktrees.
 
 ## OAT workflow

package/assets/docs/reference/oat-directory-structure.md

@@ -58,12 +58,16 @@ Project scope is used for project workflows and repo-local sync state. User scop
 | Path                      | Purpose                                                           |
 | ------------------------- | ----------------------------------------------------------------- |
 | `.oat/sync/manifest.json` | Records sync-managed provider entries and drift contract state    |
-| `.oat/sync/config.json`   | Sync behavior config (default strategy + provider-level settings) |
+| `.oat/sync/config.json`   | Project sync behavior, provider settings, and known-stray choices |
+
+The equivalent user files are `~/.oat/sync/manifest.json` and
+`~/.oat/sync/config.json`.
 
 `config.json` currently includes:
 
 - `version`
 - `defaultStrategy`
+- `knownStrays` (optional exact provider-local paths)
 - `providers.<provider>.enabled`
 - `providers.<provider>.strategy` (optional override)
 
@@ -79,7 +83,10 @@ Current config ownership:
 - `.oat/config.json` owns shared non-sync repo settings (including `worktrees.root`, `projects.root`, and `documentation.*`).
 - `.oat/config.local.json` owns per-developer project lifecycle state (`activeProject`, `lastPausedProject`, `activeIdea`).
 - `~/.oat/config.json` owns user-level state (`activeIdea` at global scope).
-- `.oat/sync/config.json` continues to own sync/provider behavior.
+- `.oat/sync/config.json` owns project sync/provider behavior and project known strays.
+- `~/.oat/sync/config.json` owns user sync/provider behavior and personal known
+  strays. OAT migrates legacy `~/.oat/config.json#knownStrays` entries here
+  without removing unrelated user config.
 
 CLI discovery surfaces:
 
@@ -255,13 +262,14 @@ Common user-scope entries:
   config.json
   ideas/
   sync/
+    config.json
     manifest.json
 ```
 
 User scope is primarily for:
 
 - User-level ideas
-- User-level provider sync state where applicable
+- User-level provider sync state and personal known-stray choices
 
 ## Practical guidance
 

package/assets/docs/reference/troubleshooting.md

@@ -20,6 +20,17 @@ description: 'Common issues and fixes for skills visibility, worktrees, sync, an
 
 Expected for native-read skill mappings. Codex can read canonical skills without mirrored provider writes.
 
+## Cursor appears detected but no skill sync actions are listed
+
+Expected for native-read skill mappings. Verify project skills under
+`.agents/skills` and personal skills under `~/.agents/skills`; Cursor reads
+those canonical directories directly. Sync will not create `.cursor/skills`
+mirrors.
+
+Use `.cursor/skills` only for intentionally Cursor-specific packages. Interactive
+`oat init` and `oat status` offer each unresolved Cursor-local skill for
+canonical adoption or a remembered Keep Cursor-only choice.
+
 ## `sync` reports provider config mismatch
 
 - For interactive runs, select detected providers to enable when prompted.

package/assets/docs/workflows/projects/artifacts.md

@@ -127,7 +127,7 @@ Each inner array is a group of phases that execute concurrently in their own wor
 - Each group must contain **2 or more** phases — singleton groups are rejected.
 - Every phase ID must exist in the plan body.
 - No phase may appear in more than one group.
-- Parallelism is only honored at Tier 1 (native subagents). Tier 2 degrades parallel groups to sequential target-preserving execution, not unconditional inline review. Concrete managed Claude and Cursor reviewers retain the exact resolver-returned `dispatchArgs.model` in the actual invocation and every retry; Codex retains its exact role or pinned child. Inline review requires verified equivalent host controls or an explicit inherit/default or managed-uncapped base-role exception, and otherwise blocks.
+- Parallelism is only honored at Tier 1 (native subagents). Tier 2 degrades parallel groups to sequential target-preserving execution, not unconditional inline review. Concrete managed Claude reviewers retain the exact resolver-returned `dispatchArgs.model`; Cursor reviewers retain the exact `providers.cursor.dispatchArgs.variant` native agent type; Codex retains its exact role or pinned child. Every retry preserves the complete target. Inline review requires verified equivalent host controls or an explicit inherit/default or managed-uncapped base-role exception, and otherwise blocks.
 
 **Authoring responsibility:**
 

package/assets/docs/workflows/projects/dispatch-ceiling.md

@@ -194,8 +194,10 @@ candidate in each tier:
   `max`.
 - **Claude:** `haiku`, `sonnet`, `opus`, and `fable` across the ordered named
   tiers.
-- **Cursor:** opaque strings corresponding to the same 13 configured positions.
-  OAT does not parse those strings to infer family, effort, cost, or capability.
+- **Cursor:** 12 verified multi-family flat IDs across Composer, Claude, GPT,
+  and Grok. The explicit materialization catalogue maps each flat ladder ID to
+  a separate bracket-form frontmatter model; OAT does not derive or normalize
+  either value.
 
 The final candidate in a named tier defines that tier's reviewer ceiling. Lower
 reviewer selection requires a separate reviewed contract; a normal reviewer
@@ -240,7 +242,7 @@ oat project dispatch-ceiling resolve \
   --provider cursor \
   --role implementer \
   --ceiling-tier high \
-  --candidate-model 'opaque:model/balanced [v2]' \
+  --candidate-model gpt-5.6-sol-high \
   --json
 ```
 
@@ -280,45 +282,39 @@ branch replaces, rather than supplements, preferred selection.
 | -------- | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
 | Codex    | Use `providers.codex.dispatchArgs.variant` as `agent_type`; otherwise launch a fresh child pinned to the returned model and effort | Block if neither exact route is usable    |
 | Claude   | Pass `providers.claude.dispatchArgs.model` as the actual Task `model`                                                              | Block if the model cannot be applied      |
-| Cursor   | Pass `providers.cursor.dispatchArgs.model` byte-for-byte as the actual invocation model; treat it as opaque                        | Block rather than normalize or substitute |
+| Cursor   | Launch `providers.cursor.dispatchArgs.variant` as the exact native agent type first                                                | Block rather than normalize or substitute |
 | Other    | Use a registered provider adapter when it can compile exact controls                                                               | Unsupported providers remain advisory     |
 
-Materialized Codex roles exist before phase dispatch after project/user sync.
-The supported catalogue is committed project output; custom Codex candidates
-materialize according to config ownership. Workflow correctness still keeps a
-fresh pinned-child fallback and does not require provider restart or hot reload.
+Materialized Codex and Cursor roles exist before phase dispatch after
+project/user sync. Cursor definitions carry `supported-catalogue`,
+`project-config`, or `user-config` ownership. Project and supported variants
+are tracked under `.cursor/agents`; user variants live under
+`~/.cursor/agents`. Cleanup stays within the current owner boundary.
 
 Reviewers use the final candidate at the configured review ceiling. Managed
 `Uncapped` and explicit inherit/default behavior retain their documented base
 reviewer behavior. A timeout retry preserves the same exact role or complete
-Claude/Cursor model payload.
+Claude model payload or Cursor native variant.
 
 ### Cursor evidence authority
 
-Cursor resolution and runtime evidence answer different questions. Resolution
-proves which opaque candidate OAT requested. A stream-JSON Task start and
-correlated completion prove launcher behavior only when the model argument is
-preserved byte-for-byte. An accepted Task plus the child sentinel establishes
-argument eligibility for that account and client; a structured rejection can
-establish `unknown-value`. Runtime producer identity remains `not-reported`
-unless trusted Cursor telemetry or Cursor support independently confirms it.
-
-The [2026-07-11 GPT-5.6 evidence record](https://github.com/voxmedia/open-agent-toolkit/blob/main/.oat/repo/reference/project-summaries/20260711-cursor-gpt-5-6-subagent-verification.md)
-ran positive and negative controls before candidate probes. Neither control
-emitted a Task event, so the harness stopped without probing the 13 recommended
-arguments or exploratory `gpt-5.6-sol-high-fast`. This is a harness/account
-boundary, not model rejection, and it supports no recommendation change.
-
-The tracked artifact's structured second-pass block exposes only an allowlisted
-event projection and non-reversible identifier hashes. Exact
-request/session/tool-call IDs and credential-redacted unprojected streams from
-that pass stay in gitignored local project storage for support diagnosis.
-
-The same public artifact intentionally preserves the sanitized historical v1
-text-mode record for provenance. That older section includes command arguments
-and prompts, stdout and stderr, exit and duration data, and capture-environment
-details such as user-specific binary paths; it is not limited to the structured
-second-pass projection.
+Cursor selection, pin mapping, catalogue availability, and runtime identity are
+separate evidence layers:
+
+- The candidate ladder and resolver use an opaque flat ID.
+- The materialized definition uses the mapping's explicit bracket-form
+  frontmatter model.
+- Mapping-specific native-launch evidence authorizes the shipped mapping data.
+- `oat doctor` checks current flat-ID catalogue availability, which can detect
+  drift but cannot prove a definition pin.
+- The launcher records the selected variant and mapped model with `configured`
+  provenance. Runtime identity remains `not-reported` without an independent
+  observation.
+
+Cursor can silently fallback when account, plan, or administration constraints
+prevent a requested definition pin. Native variant acceptance is therefore not
+runtime-model verification, and skills must not promote self-report or
+catalogue presence into observed identity.
 
 ## Phase and Optional-Worker Layers
 

package/assets/docs/workflows/projects/implementation-execution.md

@@ -126,10 +126,13 @@ needed, OAT does not probe or require third-tier capacity.
 
 Provider controls remain exact: Codex uses
 `providers.codex.dispatchArgs.variant`, Claude uses
-`providers.claude.dispatchArgs.model`, and Cursor treats
-`providers.cursor.dispatchArgs.model` as an opaque, byte-for-byte enforced model
-argument.
-For Cursor, opaque selection is enforced as a byte-for-byte model arg.
+`providers.claude.dispatchArgs.model`, and Cursor uses
+`providers.cursor.dispatchArgs.variant`. Cursor launches that exact
+resolver-selected native agent type first; the flat ID and bracket-form pin
+remain inside the explicit mapping and are never normalized by workflow prose.
+The launcher records this selection as `configured`, while runtime identity
+remains `not-reported` without independent observation. Only a pre-start native
+role-selection rejection permits another target-preserving route.
 
 See [Dispatch Policy](dispatch-ceiling.md) for configuration and
 [Orchestration Model](orchestration-model.md) for the complete role map.

package/assets/docs/workflows/projects/lifecycle.md

@@ -115,9 +115,10 @@ through the import-plan lane.
 
 A concrete managed reviewer remains bound across both tiers. Codex uses the
 exact registered role or a child pinned to the resolved model and effort;
-Claude and Cursor pass the exact resolver-returned `dispatchArgs.model` in the
-actual provider invocation, including retries. Tier 2 does not authorize a
-target downgrade. Inline review is allowed only with verified equivalent host
+Claude passes the exact resolver-returned `dispatchArgs.model`; Cursor launches
+the exact `providers.cursor.dispatchArgs.variant` native reviewer variant.
+Retries preserve that complete target. Tier 2 does not authorize a target
+downgrade. Inline review is allowed only with verified equivalent host
 controls, or for explicit inherit/default behavior or the documented
 managed-uncapped reviewer base-role exception; otherwise the review blocks.
 

package/assets/public-package-versions.json

@@ -1,6 +1,6 @@
 {
-  "cli": "0.1.73",
-  "docs-config": "0.1.73",
-  "docs-theme": "0.1.73",
-  "docs-transforms": "0.1.73"
+  "cli": "0.1.76",
+  "docs-config": "0.1.76",
+  "docs-theme": "0.1.76",
+  "docs-transforms": "0.1.76"
 }

package/assets/skills/create-agnostic-skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: create-agnostic-skill
-version: 1.4.0
+version: 1.4.1
 description: Use when adding a reusable workflow skill for AI coding agents. Scaffolds a new .agents/skills skill using the Agent Skills open standard.
 argument-hint: '[skill-name]'
 disable-model-invocation: true

package/assets/skills/create-agnostic-skill/references/docs/skills-guide.md

@@ -2,7 +2,7 @@
 
 Agent Skills ecosystem research and notes across providers.
 
-_Last updated: February 2026_
+_Last updated: July 2026_
 
 ---
 
@@ -194,15 +194,20 @@ Legend: ✅ documented support | ⚠️ provider-specific semantics | 💤 ignor
 **Skill locations:**
 
 - Project:
+  - `.agents/skills/<skill-name>/SKILL.md` (**portable canonical path**)
   - `.cursor/skills/<skill-name>/SKILL.md`
   - `.claude/skills/<skill-name>/SKILL.md` (**Claude compatibility**)
   - `.codex/skills/<skill-name>/SKILL.md` (**Codex compatibility**)
 - Personal:
+  - `~/.agents/skills/<skill-name>/SKILL.md` (**portable canonical path**)
   - `~/.cursor/skills/<skill-name>/SKILL.md`
   - `~/.claude/skills/<skill-name>/SKILL.md` (**Claude compatibility**)
   - `~/.codex/skills/<skill-name>/SKILL.md` (**Codex compatibility**)
 
-**Notable:** Cursor explicitly reads from `.claude/skills/` and `.codex/skills/` for cross-tool compatibility. This means skills authored in `.claude/skills/` are automatically available in Cursor without symlinking.
+**Notable:** Cursor reads `.agents/skills/` natively at project and user scope, so
+portable canonical skills need no Cursor mirror. `.cursor/skills/` remains a
+supported home for Cursor-only skills. Cursor also reads `.claude/skills/` and
+`.codex/skills/` for compatibility.
 
 **Documented frontmatter fields:**
 
@@ -341,13 +346,13 @@ Installs skills from GitHub repos, local paths, or GitLab URLs to any supported
 Author skills in `.agents/skills/` (canonical) and distribute to provider-specific directories:
 
 ```bash
-# Claude Code + Cursor (Cursor reads .claude/skills/ natively)
+# Claude Code
 ln -s ../../.agents/skills/my-skill .claude/skills/my-skill
 
 # GitHub Copilot
 ln -s ../../.agents/skills/my-skill .github/skills/my-skill
 
-# Codex reads .agents/skills/ natively at project level — no symlink needed
+# Cursor, Codex, and Gemini read .agents/skills/ natively — no symlink needed
 ```
 
 For automated distribution, use **OAT sync** (for local/internal skills) or **`npx skills add`** (for remote/community skills):
@@ -360,9 +365,11 @@ oat sync --scope all
 npx skills add github-user/skill-repo -a claude-code -a github-copilot
 ```
 
-**Result: one canonical source, two symlinks, four tools.**
+**Result: one canonical source, two symlinks, five tools.**
 
-**Note:** Cursor already reads `.claude/skills/` natively, so the Claude Code symlink covers both. Codex reads `.agents/skills/` at project level (per Vercel skills docs), eliminating its symlink entirely.
+**Note:** Cursor, Codex, and Gemini read `.agents/skills/` directly at project
+and user scope. Keep `.cursor/skills/` for intentionally Cursor-only skills,
+not as a generated mirror of canonical content.
 
 ---
 
@@ -516,31 +523,33 @@ The proposal has community interest but no official timeline or maintainer respo
 
 **Source:** https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices, https://github.com/agentskills/agentskills/tree/main/skills-ref
 
-### Q: Cursor reads `.claude/skills/` natively — does this make `.agents/skills/` + symlinks unnecessary?
+### Q: Does Cursor's native `.agents/skills/` support eliminate all provider views?
 
-**Answer:** No. While Cursor reading `.claude/skills/` is convenient, it only covers two of four required tools:
+**Answer:** No. Cursor, Codex, and Gemini need no skill mirror, but Claude Code
+and GitHub Copilot still use provider-specific paths:
 
 | Tool           | Native Path       | Reads `.claude/skills/`? | Reads `.agents/skills/`? |
 | -------------- | ----------------- | ------------------------ | ------------------------ |
 | Claude Code    | `.claude/skills/` | ✅ (native)              | ❌                       |
-| Cursor         | `.cursor/skills/` | ✅ (cross-compat)        | ❌                       |
+| Cursor         | `.agents/skills/` | ✅ (compatibility)       | ✅ (native)              |
 | Codex CLI      | `.agents/skills/` | ❌                       | ✅ (native)              |
-| GitHub Copilot | `.github/skills/` | ✅ (cross-compat)        | ❌                       |
-| Gemini CLI     | `.gemini/skills/` | ❌                       | ✅ (native alias)        |
+| GitHub Copilot | `.github/skills/` | ✅ (compatibility)       | ❌                       |
+| Gemini CLI     | `.agents/skills/` | ❌                       | ✅ (native alias)        |
 
 **Recommended approach:** Author skills in `.agents/skills/` (tool-agnostic canonical source), then symlink only where needed:
 
 ```bash
 # Two symlinks needed:
-ln -s ../../.agents/skills/my-skill .claude/skills/my-skill    # Claude Code + Cursor + Copilot
+ln -s ../../.agents/skills/my-skill .claude/skills/my-skill    # Claude Code + Copilot compatibility
 ln -s ../../.agents/skills/my-skill .github/skills/my-skill    # GitHub Copilot (native path)
-# Codex reads .agents/skills/ natively — no symlink needed
-# Gemini reads .agents/skills/ natively — no symlink needed
+# Cursor, Codex, and Gemini read .agents/skills/ natively — no symlink needed
 ```
 
 **One canonical source, two symlinks, five tools.** (Copilot reads `.claude/skills/` cross-compat, so the `.github/skills` symlink is optional but recommended for explicitness.)
 
-**Note (updated Feb 2026):** Codex now reads `.agents/skills/` natively at both project level (`$CWD/.agents/skills` up to `$REPO_ROOT/.agents/skills`) and user level (`$HOME/.agents/skills`). Gemini CLI also reads `.agents/skills/` natively at both workspace and user scopes. No symlinks needed for Codex or Gemini at any scope.
+**Note (updated July 2026):** Cursor, Codex, and Gemini read
+`.agents/skills/` natively at project and user scope. No skill symlinks are
+needed for those providers.
 
 **Source:** https://cursor.com/docs/context/skills, https://code.visualstudio.com/docs/copilot/customization/agent-skills, https://developers.openai.com/codex/skills, https://github.com/vercel-labs/skills
 

package/assets/skills/oat-agent-instructions-analyze/references/docs/provider-reference.md

@@ -2,7 +2,7 @@
 
 Quick reference for skills, subagents, hooks, and agent instructions across all major AI coding tools.
 
-_Last updated: February 2026_
+_Last updated: July 2026_
 
 ---
 
@@ -144,11 +144,17 @@ The package manager for the agent skills ecosystem. Installs skills across 27+ a
 
 **Skill locations:**
 
-- Project: `.cursor/skills/<skill-name>/SKILL.md`
-- Personal: `~/.cursor/skills/<skill-name>/SKILL.md`
+- **Portable project skills:** `.agents/skills/<skill-name>/SKILL.md`
+- **Portable personal skills:** `~/.agents/skills/<skill-name>/SKILL.md`
+- **Cursor-only project skills:** `.cursor/skills/<skill-name>/SKILL.md`
+- **Cursor-only personal skills:** `~/.cursor/skills/<skill-name>/SKILL.md`
 - **Claude compatibility:** `.claude/skills/` (project) and `~/.claude/skills/` (personal)
 - **Codex compatibility:** `.codex/skills/` (project) and `~/.codex/skills/` (personal)
 
+OAT keeps portable skills canonical under `.agents/skills`; it does not
+generate `.cursor/skills` mirrors. Cursor-specific skill directories remain
+supported as intentional local extensions and migration sources.
+
 ### Subagents
 
 | Resource                    | URL                                       |

package/assets/skills/oat-agent-instructions-apply/references/docs/provider-reference.md

@@ -2,7 +2,7 @@
 
 Quick reference for skills, subagents, hooks, and agent instructions across all major AI coding tools.
 
-_Last updated: February 2026_
+_Last updated: July 2026_
 
 ---
 
@@ -144,11 +144,17 @@ The package manager for the agent skills ecosystem. Installs skills across 27+ a
 
 **Skill locations:**
 
-- Project: `.cursor/skills/<skill-name>/SKILL.md`
-- Personal: `~/.cursor/skills/<skill-name>/SKILL.md`
+- **Portable project skills:** `.agents/skills/<skill-name>/SKILL.md`
+- **Portable personal skills:** `~/.agents/skills/<skill-name>/SKILL.md`
+- **Cursor-only project skills:** `.cursor/skills/<skill-name>/SKILL.md`
+- **Cursor-only personal skills:** `~/.cursor/skills/<skill-name>/SKILL.md`
 - **Claude compatibility:** `.claude/skills/` (project) and `~/.claude/skills/` (personal)
 - **Codex compatibility:** `.codex/skills/` (project) and `~/.codex/skills/` (personal)
 
+OAT keeps portable skills canonical under `.agents/skills`; it does not
+generate `.cursor/skills` mirrors. Cursor-specific skill directories remain
+supported as intentional local extensions and migration sources.
+
 ### Subagents
 
 | Resource                    | URL                                       |

package/assets/skills/oat-dispatch-subagents/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-dispatch-subagents
-version: 1.1.3
+version: 1.1.4
 description: Use when an OAT skill or workflow needs provider-neutral selection, launch, recovery, or evidence for bounded subagent work without project lifecycle policy.
 disable-model-invocation: true
 user-invocable: false

package/assets/skills/oat-dispatch-subagents/references/provider-cursor.md

@@ -6,24 +6,35 @@ volatile snapshot, never a durable inventory.
 
 ## Control Surfaces
 
-| Source                       | Establishes                                               | Does not establish                                             |
-| ---------------------------- | --------------------------------------------------------- | -------------------------------------------------------------- |
-| Native Task/Subagent schema  | Roles and opaque selectors for that dispatcher invocation | CLI account eligibility or another dispatcher's native catalog |
-| `cursor-agent --list-models` | Opaque selectors accepted by the account CLI              | Native Task eligibility                                        |
-| Cursor UI role configuration | User-selected defaults and role settings                  | Live root or nested schema without a new observation           |
+| Source                       | Establishes                                                    | Does not establish                                             |
+| ---------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- |
+| Native Task/Subagent schema  | Agent types available for that dispatcher invocation           | CLI account eligibility or another dispatcher's native catalog |
+| `cursor-agent --list-models` | Opaque flat model IDs accepted by the account CLI and resolver | Native Task eligibility or definition-pin acceptance           |
+| Cursor UI role configuration | User-selected defaults and role settings                       | Live root or nested schema without a new observation           |
 
 Root and nested catalogs are independent, volatile observations. Equality in
 one run does not establish equality in another run or nesting boundary.
 
 ## Native Selection
 
-1. Read the native model enum from the dispatcher that will launch the child.
-2. Intersect configured candidates with that exact snapshot.
-3. Pass the selected opaque string byte-for-byte.
-4. Treat an omitted model as deliberate parent inheritance, not generic
-   defaulting or evidence that a target was unavailable.
-5. Record requested selector, acceptance, outcome, and runtime identity
-   separately.
+Managed Cursor dispatch resolves an opaque flat model ID through OAT's explicit
+mapping and returns `providers.cursor.dispatchArgs.variant`. The mapping owns
+the bracket-form model pin inside the materialized definition; skills must
+never parse, normalize, or reconstruct either model string.
+
+1. Require a non-empty `providers.cursor.dispatchArgs.variant`.
+2. Launch that exact resolver-selected native agent type first.
+3. Treat native launch acceptance plus the complete launcher payload as
+   configured-invocation evidence, not observed runtime model identity.
+4. Permit a replacement route only after a recorded pre-start native
+   role-selection rejection of that exact variant, before any child starts.
+5. After acceptance, continue only through the existing handle. Timeout,
+   interruption, `BLOCKED`, missing telemetry, or self-report never authorizes
+   fallback or replacement.
+6. Treat an omitted variant as deliberate parent inheritance only when the
+   resolver selected no managed target.
+7. Record selected variant, mapped target, acceptance, outcome, and runtime
+   identity separately.
 
 Do not infer Cursor IDE behavior from a headless CLI surface. Keep bounded
 recon on economical explicit targets and reserve stronger targets for
@@ -52,12 +63,13 @@ verdict.
 
 ## Pre-Start CLI Routes
 
-When the current native intersection is absent or unsatisfactory, a caller may
-use a deliberate pre-start CLI route only when:
+When exact native role selection rejects the resolver-selected variant before
+launch, a caller may use a deliberate pre-start CLI route only when:
 
 - the caller's fallback policy allows it;
 - the exact CLI selector exists in the account catalog;
-- native mismatch, route, reason, and candidates are recorded before launch;
+- the native mismatch, rejected variant, route, reason, and candidates are
+  recorded before launch;
 - the prompt is self-contained and authority-bounded.
 
 Verify current CLI help before use. A typical shape is:

package/assets/skills/oat-project-autonomous/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-autonomous
-version: 1.0.3
+version: 1.0.4
 description: Use when a user explicitly asks to run an OAT project autonomously end-to-end. Activates session-only autonomy, resumes the correct lifecycle phase, and drives the existing OAT skills through final PR or a reported boundary.
 argument-hint: '<goal | project-slug | ticket-ref>'
 disable-model-invocation: true

package/assets/skills/oat-project-autonomous/references/gate-inventory.md

@@ -226,7 +226,7 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `oat-project-plan/SKILL.md`                                    | `5eb3949f32e1 -> NG`; `64a08153bb9e -> NG`; `655d61df0a8f -> NG`; `56b37486f09d -> PLAN-01`; `cf317c17c586 -> PLAN-02`; `781643b0f2c3 -> NG`; `01fd7cca8253 -> PLAN-04`; `7bc7fa3f2cbb -> NG`; `da28ce0a5f2e -> NG`; `e334f94c4d35 -> NG`; `1fa55762c038 -> NG`; `c0935b5484a2 -> NG`; `6008163054f8 -> PLAN-05`; `571271f4d71b -> PLAN-06`; `746b760289e4 -> PLAN-06`; `de195590ff83 -> NG`; `49640510829a -> PLAN-07`; `4bef7afa7a71 -> PLAN-08`; `e5886632533e -> PLAN-08`; `4cfe1df14372 -> NG`; `d116c97a500c -> PLAN-10`; `aa62facff547 -> PLAN-10`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> PLAN-11`; `1734b2c85c5d -> NG`; `b4af2220eb91 -> PLAN-11`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | `oat-project-import-plan/SKILL.md`                             | `f7ca8635452f -> NG`; `c2e5fa410069 -> NG`; `655d61df0a8f -> NG`; `b137f73db20c -> IMPORT-01`; `45b699c1c0b5 -> IMPORT-01`; `ba6d120791c1 -> IMPORT-01`; `070ebc5259af -> IMPORT-03`; `c11552696e2e -> IMPORT-03`; `cfe661966baf -> IMPORT-04`; `baa91c0a0bf8 -> NG`; `e364e84b2702 -> NG`; `39031985a945 -> IMPORT-06`; `f106aa29a217 -> IMPORT-07`; `65038450aee3 -> IMPORT-07`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> IMPORT-09`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `oat-project-implement/SKILL.md`                               | `853d44621b72 -> NG`; `ffb3af0ba8ef -> NG`; `e0355c7a05e9 -> IMPLEMENT-11+IMPLEMENT-13+IMPLEMENT-16`; `6296f41ae11c -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> IMPLEMENT-01`; `8ce8a09feca4 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| `oat-project-implement/references/completion-and-closeout.md`  | `105600fbd045 -> IMPLEMENT-11`; `3e6055aede6c -> IMPLEMENT-11`; `0705f7533039 -> IMPLEMENT-11`; `0c39746f3cb5 -> IMPLEMENT-11`; `14d89fe39c8c -> IMPLEMENT-11`; `378a75543a72 -> IMPLEMENT-11`; `c7b25627e674 -> IMPLEMENT-11`; `51ef9a453323 -> IMPLEMENT-11`; `c67145e3fb00 -> IMPLEMENT-11`; `64fbeac64811 -> IMPLEMENT-11`; `19b13c17bddb -> NG`; `f7dab9c1f96c -> IMPLEMENT-12`; `c69c17a069a8 -> IMPLEMENT-14`; `a97fa5634a68 -> IMPLEMENT-14`; `3af58881811c -> IMPLEMENT-14`; `4203e1f49d0f -> IMPLEMENT-14`; `c3bd2458a3d3 -> IMPLEMENT-13`; `95b5eafc070d -> IMPLEMENT-13`; `25ecbe9c998b -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f6f24fd71da4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f18283bc1cf9 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `2c1ffc4a82dd -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `3454a07aa843 -> IMPLEMENT-16`; `0d86e2098cfb -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d5fe597d266f -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `55a152e944c1 -> IMPLEMENT-16`; `effac7cbd573 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d2a34d8b148 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d27462aaed26 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d52ecb17268 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `5b91aabe3757 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `fd0ad919f702 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `63bf28df1474 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a4ed471dbc78 -> IMPLEMENT-16`; `6b7a64cec6e5 -> IMPLEMENT-16`; `0a4fdba0ebc0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a5033c2aada5 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `e77609eddba0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `351156e8dde4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `51d45bd2bbd1 -> IMPLEMENT-16`; `f7796ffcc804 -> IMPLEMENT-16`; `990d730cb494 -> IMPLEMENT-16`; `6ed28bb7d384 -> IMPLEMENT-16`; `8b7d4b5bcf1b -> IMPLEMENT-16`; `88aad500e6e9 -> IMPLEMENT-16`; `877e3e3f9eda -> IMPLEMENT-16`; `fc03c97f834e -> IMPLEMENT-16`; `12939a3da5e0 -> IMPLEMENT-16`; `bdb418335a88 -> IMPLEMENT-16`; `fba97e596ebd -> IMPLEMENT-16`; `3d0b5e2f14f0 -> IMPLEMENT-17`; `f56a9ce88461 -> IMPLEMENT-17`; `9ba67b50d0ba -> IMPLEMENT-17`; `39ff911760af -> IMPLEMENT-17`; `5b560b5bd6e3 -> IMPLEMENT-17`; `fa21df5e5e01 -> IMPLEMENT-17`; `0fed77bec55e -> IMPLEMENT-17`; `6d81cfb0483f -> IMPLEMENT-17`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> IMPLEMENT-18` |
+| `oat-project-implement/references/completion-and-closeout.md`  | `105600fbd045 -> IMPLEMENT-11`; `3e6055aede6c -> IMPLEMENT-11`; `0705f7533039 -> IMPLEMENT-11`; `0c39746f3cb5 -> IMPLEMENT-11`; `6d33ea58da2c -> IMPLEMENT-11`; `378a75543a72 -> IMPLEMENT-11`; `c7b25627e674 -> IMPLEMENT-11`; `51ef9a453323 -> IMPLEMENT-11`; `c67145e3fb00 -> IMPLEMENT-11`; `64fbeac64811 -> IMPLEMENT-11`; `19b13c17bddb -> NG`; `f7dab9c1f96c -> IMPLEMENT-12`; `c69c17a069a8 -> IMPLEMENT-14`; `a97fa5634a68 -> IMPLEMENT-14`; `3af58881811c -> IMPLEMENT-14`; `4203e1f49d0f -> IMPLEMENT-14`; `c3bd2458a3d3 -> IMPLEMENT-13`; `95b5eafc070d -> IMPLEMENT-13`; `25ecbe9c998b -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f6f24fd71da4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f18283bc1cf9 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `2c1ffc4a82dd -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `3454a07aa843 -> IMPLEMENT-16`; `0d86e2098cfb -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d5fe597d266f -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `55a152e944c1 -> IMPLEMENT-16`; `effac7cbd573 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d2a34d8b148 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d27462aaed26 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d52ecb17268 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `5b91aabe3757 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `fd0ad919f702 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `63bf28df1474 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a4ed471dbc78 -> IMPLEMENT-16`; `6b7a64cec6e5 -> IMPLEMENT-16`; `0a4fdba0ebc0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a5033c2aada5 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `e77609eddba0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `351156e8dde4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `51d45bd2bbd1 -> IMPLEMENT-16`; `f7796ffcc804 -> IMPLEMENT-16`; `990d730cb494 -> IMPLEMENT-16`; `6ed28bb7d384 -> IMPLEMENT-16`; `8b7d4b5bcf1b -> IMPLEMENT-16`; `88aad500e6e9 -> IMPLEMENT-16`; `877e3e3f9eda -> IMPLEMENT-16`; `fc03c97f834e -> IMPLEMENT-16`; `12939a3da5e0 -> IMPLEMENT-16`; `bdb418335a88 -> IMPLEMENT-16`; `fba97e596ebd -> IMPLEMENT-16`; `3d0b5e2f14f0 -> IMPLEMENT-17`; `f56a9ce88461 -> IMPLEMENT-17`; `9ba67b50d0ba -> IMPLEMENT-17`; `39ff911760af -> IMPLEMENT-17`; `5b560b5bd6e3 -> IMPLEMENT-17`; `fa21df5e5e01 -> IMPLEMENT-17`; `0fed77bec55e -> IMPLEMENT-17`; `6d81cfb0483f -> IMPLEMENT-17`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> IMPLEMENT-18` |
 | `oat-project-implement/references/dispatch-and-dry-run.md`     | `21b85f5e4daa -> IMPLEMENT-08`; `74c92b32bb2a -> IMPLEMENT-08`; `8efd2d0517ab -> IMPLEMENT-09`; `461ed9b3e495 -> IMPLEMENT-09`; `b5ad64fd744d -> NG`; `14ce436cfffa -> NG`; `043ca36da3e2 -> NG`; `a23e45c1dc8d -> NG`; `498143bb41a7 -> NG`; `4fe3eb179023 -> NG`; `7f75485e5a33 -> NG`; `8ec3a96df029 -> NG`; `16c3f96e758d -> NG`; `5915c41fe058 -> NG`; `f51e43eeac56 -> NG`; `fd41c25623cb -> NG`; `58a932ed6453 -> NG`; `4718bd3ce12d -> NG`; `58c444a2126b -> NG`; `2df3adae4120 -> NG`; `e75df892b55c -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `oat-project-implement/references/docs/autonomy-contract.md`   | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | `oat-project-implement/references/phase-execution.md`          | `27737e814790 -> NG`; `6dda2b8e62e2 -> IMPLEMENT-10`; `b3197086bb1e -> IMPLEMENT-10`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |