From d04e05d8e16879fb508f39848a05ecaba651d158 Mon Sep 17 00:00:00 2001
From: Ahmed Mohammed <7650147+amElnagdy@users.noreply.github.com>
Date: Sat, 20 Jun 2026 23:36:15 +0300
Subject: [PATCH] README: add Updating section

Skills install as a copy, so explain how to refresh them with the Skills CLI
(update/upgrade, --global/--project, or re-running add) after the repo changes.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index 9e80409..6be183c 100644
--- a/README.md
+++ b/README.md
@@ -46,6 +46,17 @@ npx skills add amElnagdy/guard-skills --global
 
 Works with Claude Code, Codex, Cursor, OpenCode, and other supported agents via the [Skills CLI](https://github.com/vercel-labs/skills).
 
+## Updating
+
+Skills install as a copy, so a new version here does not reach your agent until you update. Refresh them with the Skills CLI:
+
+```bash
+npx skills update                 # all installed skills (alias: upgrade)
+npx skills update clean-code-guard
+```
+
+Add `--global` for global installs or `--project` for project installs. Re-running `npx skills add amElnagdy/guard-skills` also re-fetches the latest.
+
 ## How to use them
 
 Run a guard after your agent produces work: