diff --git a/SKILL.md b/SKILL.md
index 46639f02..f65c9176 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,6 +1,5 @@
 ---
 name: humanizer
-version: 2.5.1
 description: |
   Remove signs of AI-generated writing from text. Use when editing or reviewing
   text to make it sound more natural and human-written. Based on Wikipedia's
@@ -17,6 +16,8 @@ allowed-tools:
   - Grep
   - Glob
   - AskUserQuestion
+metadata:
+  version: 2.5.1
 ---
 
 # Humanizer: Remove AI Writing Patterns
diff --git a/WARP.md b/WARP.md
index 78a5b4c9..b207adfb 100644
--- a/WARP.md
+++ b/WARP.md
@@ -40,7 +40,7 @@ Invoke the skill:
 
 ## Making changes safely
 ### Versioning (keep in sync)
-- `SKILL.md` has a `version:` field in its YAML frontmatter.
+- `SKILL.md` has a `version:` field under `metadata:` in its YAML frontmatter.
 - `README.md` has a “Version History” section.
 
 If you bump the version, update both.
@@ -50,4 +50,4 @@ If you bump the version, update both.
 - Keep the pattern numbering stable unless you’re intentionally re-numbering (since the README table and examples reference the same numbering).
 
 ### Documenting non-obvious fixes
-If you change the prompt to handle a tricky failure mode (e.g., a repeated mis-edit or an unexpected tone shift), add a short note to `README.md`’s version history describing what was fixed and why.
\ No newline at end of file
+If you change the prompt to handle a tricky failure mode (e.g., a repeated mis-edit or an unexpected tone shift), add a short note to `README.md`’s version history describing what was fixed and why.