Update README and add CHANGELOG

Author: yashovardhan

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
 
@@ -17,4 +16,6 @@ Install with [Vercel's Skills CLI](https://skills.sh):
 npx skills add metaMask/agent-skills
 ```
 
-Select any one of the SKILLs upon prompt. 
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md) for skill updates and how to catch up from an older version.