From 3b23777b02ed1a4f2fe674f2741f4a78d632f322 Mon Sep 17 00:00:00 2001
From: Cameron <cameron@pfiffer.org>
Date: Tue, 3 Mar 2026 11:16:29 -0800
Subject: [PATCH] docs: note that skills CLI commands are directory-scoped
 (#473)

---
 docs/skills.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/skills.md b/docs/skills.md
index baecede..1128a4a 100644
--- a/docs/skills.md
+++ b/docs/skills.md
@@ -140,6 +140,8 @@ lettabot skills sync
 lettabot skills status
 ```
 
+> **Important:** These commands discover skills relative to the current working directory. Run them from the lettabot project root to ensure all project-level skills (`.skills/`) and bundled skills (`skills/`) are found. Running from a different directory will only show globally installed skills.
+
 External skill sources:
 
 - [Clawdhub](https://clawdhub.com/) -- `npx clawdhub@latest install <skill>`