diff --git a/.claude/scheduled_tasks.lock b/.claude/scheduled_tasks.lock
deleted file mode 100644
index a9fcb25..0000000
--- a/.claude/scheduled_tasks.lock
+++ /dev/null
@@ -1 +0,0 @@
-{"sessionId":"3c40b50c-1a7d-4957-a8df-6dd80f691ee9","pid":29655,"acquiredAt":1776712915943}
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
index 82b5388..82c14ff 100644
--- a/.gitignore
+++ b/.gitignore
@@ -18,4 +18,10 @@ coverage/
 /_archive/
 .grepai/
 
-graphify-out/
\ No newline at end of file
+graphify-out/
+
+# AI coding agent local state (per-developer, not for git)
+.claude/
+.agents/
+CLAUDE.md
+skills-lock.json
\ No newline at end of file
diff --git a/README.md b/README.md
index 4c61660..3097faa 100644
--- a/README.md
+++ b/README.md
@@ -225,7 +225,7 @@ When `ANTHROPIC_API_KEY` isn't set, the dashboard renders a read-only banner —
 Designing an AgentForge workflow from scratch is a lot of YAML. The repo ships an [agent skill](https://skills.sh) that walks any Claude Code / Cursor / Codex session through the design — agents, phases, gates, loops, parallelism, wiring, nodes — and emits a working `.agentforge/` directory.
 
 ```bash
-npx skills add mandarnilange/agentforge/agentforge-workflow
+npx skills add mandarnilange/agentforge
 ```
 
 Then ask the agent something like *"help me design an AgentForge pipeline for PR triage"* and the skill kicks in. Catalog and authoring docs: [`skills/`](skills/).
diff --git a/skills/README.md b/skills/README.md
index a0377ab..0a88116 100644
--- a/skills/README.md
+++ b/skills/README.md
@@ -11,10 +11,10 @@ Install all skills from this repo into your agent runtime:
 npx skills add mandarnilange/agentforge
 ```
 
-Or install a single skill by path:
+The Vercel skills CLI scans the repo's `skills/` directory and installs every skill it finds. Want a single skill instead? Use the full GitHub tree URL:
 
 ```bash
-npx skills add mandarnilange/agentforge/agentforge-workflow
+npx skills add https://github.com/mandarnilange/agentforge/tree/main/skills/agentforge-workflow
 ```
 
 ## Available skills