Update skills for v4

CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+All notable changes to the MetaMask Agent CLI Skills are documented here.
+
+These skills track the [`@metamask/agentic-cli`](https://github.com/MetaMask/agentic) releases.
+Each entry lists the skill `version` (frontmatter) and the CLI `cliVersion` it targets,
+along with the user-facing CLI changes that motivated the skill update. Use this log to
+catch up if you are on an older skill version — apply the entries above yours in order.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and the skills follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [5.0.1] — targets CLI v4.0.1
+
+### Removed
+
+- **`metamask-agent-workflows` skill.** Its workflow templates were a subset of the
+  `metamask-agent-wallet` skill's `workflows/` directory (the wallet copies were also more
+  up-to-date). The repo now ships a single `metamask-agent-wallet` skill that bundles both the
+  reference docs and the workflow templates. Install it with
+  `npx skills add metaMask/agent-skills`.
+
+### Changed
+
+- `references/doctor.md`: document that `mm doctor` now detects **project-local** MetaMask AI
+  skills when the global skill lock file (`~/.agents/.skill-lock.json`) exists but lacks
+  MetaMask entries. ([agentic#263](https://github.com/MetaMask/agentic/pull/263))
+- Bumped `cliVersion` to `4.0.1` across both skills and updated README.
+
+### Notes
+
+- CLI v4.0.1 also improved Sentry error reporting and surfaced reportable failures in
+  Segment analytics ([agentic#264](https://github.com/MetaMask/agentic/pull/264)); these are
+  internal telemetry changes with no impact on the command surface, so no skill docs changed.
+
+## [5.0.0] — targets CLI v4.0.0
+
+### Added
+
+- BYOK (bring-your-own-key) parity for `mm init` and `mm wallet create`: persisted BYOK
+  wallets are registered server-side, prompt for a trading mode, and apply the server trading
+  policy — matching the server-wallet flow. ([agentic#246](https://github.com/MetaMask/agentic/pull/246))
+
+### Fixed
+
+- `mm predict` deposit-wallet setup no longer stalls with contradictory relayer errors when a
+  cached address was derived as legacy UUPS instead of BeaconProxy.
+  ([agentic#259](https://github.com/MetaMask/agentic/pull/259))
+
+## Earlier CLI history
+
+For CLI releases prior to v4.0.0, see the upstream
+[`packages/agentic-cli/CHANGELOG.md`](https://github.com/MetaMask/agentic/blob/main/packages/agentic-cli/CHANGELOG.md).
+Highlights that shaped the current skill surface:
+
+- **v3.2.0** — confirmation prompts (with `--yes`) before `mm logout` / `mm reset`; npm update
+  notifier; `mm wallet list` refreshes the remote roster before listing.
+- **v3.0.0** — **breaking:** `mm login google` / `mm login email` removed; use
+  `mm login browser` (Google or email via the MetaMask dashboard). Bridge `--refuel` added;
+  deposit preflight checks; auto-rehydrate on login.
+- **v2.0.0** — **breaking:** wallet policy moved to `mm wallet policy get|set|template`
+  (`mm wallet show` / `create` return `policyYaml` instead of `policies`). Added `mm doctor`,
+  `mm transaction` history, and major CLI startup performance work.
+- **v1.0.0** — `mm wallet add-fund` (QR funding), trading-mode get/set commands, and
+  `mm swap`/`mm predict` recipient support.

README.md

@@ -1,13 +1,12 @@
 # MetaMask Agent CLI Skills
 
-SKILLs for the MetaMask Agent CLI (`@metamask/agentic-cli` v4.0.0). These skills enable AI agents to authenticate, manage wallets, swap tokens, bridge across chains, trade perpetual futures, and more using the MetaMask Agent CLI.
+SKILLs for the MetaMask Agent CLI (`@metamask/agentic-cli` v4.0.1). These skills enable AI agents to authenticate, manage wallets, swap tokens, bridge across chains, trade perpetual futures, and more using the MetaMask Agent CLI.
 
 ## Skills
 
 | Skill | Description |
 | --- | --- |
-| [`metamask-agent-wallet`](./skills/metamask-agent-wallet/SKILL.md) | Full CLI reference skill that routes the agent to topic-specific reference docs for all MetaMask Agent CLI commands — auth, wallets, transfers, signing, swaps, bridges, perps, prediction markets, market data, and calldata decoding. |
-| [`metamask-agent-workflows`](./skills/metamask-agent-workflows/SKILL.md) | Multistep workflow templates for complex operations like onboarding, swaps, bridges, and perps trading. It doesn't include reference docs — relies on `--help` for command details instead. |
+| [`metamask-agent-wallet`](./skills/metamask-agent-wallet/SKILL.md) | Full CLI skill that routes the agent to topic-specific reference docs (`references/`) for all MetaMask Agent CLI commands — auth, wallets, transfers, signing, swaps, bridges, perps, prediction markets, Aave V3, market data, x402 payments, and calldata decoding — plus multistep workflow templates (`workflows/`) for onboarding, swaps, bridges, perps, prediction markets, and Aave. |
 
 ## Installation
 
@@ -16,5 +15,3 @@ Install with [Vercel's Skills CLI](https://skills.sh):
 ```bash
 npx skills add metaMask/agent-skills
 ```
-
-Select any one of the SKILLs upon prompt. 

skills/metamask-agent-wallet/SKILL.md

@@ -4,8 +4,8 @@ description: Use when the user asks anything about blockchain wallets, transacti
 license: MIT
 metadata:
   author: metamask
-  version: "5.0.0"
-  cliVersion: "4.0.0"
+  version: "5.0.1"
+  cliVersion: "4.0.1"
 ---
 
 # MetaMask Agentic CLI Skill
@@ -155,7 +155,7 @@ Run these checks before the first CLI operation in a session, in order.
 
 ### 1. Version compatibility
 
-This skill is written for `@metamask/agentic-cli` **v4.0.0** (see `cliVersion` in the frontmatter). Check the installed version:
+This skill is written for `@metamask/agentic-cli` **v4.0.1** (see `cliVersion` in the frontmatter). Check the installed version:
 
 ```bash
 mm --version
@@ -169,7 +169,7 @@ npm view @metamask/agentic-cli version
 
 If the installed `major.minor` differs from the pinned `cliVersion`, or the installed version is behind the latest release, warn the user once and continue:
 
-> Version mismatch: installed CLI `<installed>`, this skill is pinned to `4.0.0`, latest release is `<latest>`. Command syntax in this skill may be inaccurate until they are aligned. Update the CLI with `npm install -g @metamask/agentic-cli@latest`, then re-install the skills with `npx skills add metaMask/agent-skills`.
+> Version mismatch: installed CLI `<installed>`, this skill is pinned to `4.0.1`, latest release is `<latest>`. Command syntax in this skill may be inaccurate until they are aligned. Update the CLI with `npm install -g @metamask/agentic-cli@latest`, then re-install the skills with `npx skills add metaMask/agent-skills`.
 
 Run this check once per session. Do not block operations on it.
 

skills/metamask-agent-wallet/references/doctor.md

@@ -28,7 +28,7 @@ This command does not support additional flags beyond output format options.
 
 ### Skill detection
 
-`mm doctor` detects installed skills from the global skills lock file (`~/.agents/.skill-lock.json` or `$XDG_STATE_HOME/skills/.skill-lock.json`). It parses `SKILL.md` frontmatter for the skill `version` and `cliVersion` metadata, then checks the CLI `major.minor` against the skill `cliVersion` requirement.
+`mm doctor` detects installed skills from the global skills lock file (`~/.agents/.skill-lock.json` or `$XDG_STATE_HOME/skills/.skill-lock.json`). When the lock file exists but contains no MetaMask entries, it falls back to scanning the current project for installed `metamask-agent-wallet` / `metamask-agent-workflows` skills. It parses `SKILL.md` frontmatter for the skill `version` and `cliVersion` metadata, then checks the CLI `major.minor` against the skill `cliVersion` requirement.
 
 ### Example