diff --git a/plugins/corgea/skills/corgea-scan/SKILL.md b/plugins/corgea/skills/corgea-scan/SKILL.md
index d0a30b0..4ef68f1 100644
--- a/plugins/corgea/skills/corgea-scan/SKILL.md
+++ b/plugins/corgea/skills/corgea-scan/SKILL.md
@@ -69,14 +69,21 @@ corgea login --url https://<instance>.corgea.app <TOKEN>  # single-tenant token
 ## Core commands
 
 ```bash
-corgea scan                                          # BLAST (AI), full project — the default
+corgea scan                                          # BLAST (AI), incremental when possible
 corgea scan --only-uncommitted                       # staged, modified, and untracked files
 corgea scan --target src/,pyproject.toml             # paths, globs, or git: selectors
 corgea scan --fail-on CR                             # exit 1 at or above critical (CR, HI, ME, LO)
+corgea scan --skip-if-commit-scanned-recently --ignore-dirty-worktree
 ```
 
 `corgea scan` blocks until the scan completes. `corgea wait [SCAN_ID]` is only
 for when nothing is blocking — you exited a scan early, or ran `corgea upload`.
+BLAST scans upload the whole project but, when possible, analyze only files
+changed since the last eligible scan and carry forward unchanged findings. Use
+`--disable-incremental` when every file needs fresh analysis. A dirty worktree
+normally falls back to analyzing every file; `--ignore-dirty-worktree` instead
+includes staged, modified, and untracked files in the incremental diff. With
+`--skip-if-commit-scanned-recently`, it can also permit reuse of a recent scan.
 
 ```bash
 corgea ls                                        # scans (alias: corgea list)