diff --git a/CHANGELOG.md b/CHANGELOG.md
index 70d702b..092ff47 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.1
+
+- Improve README onboarding, install, initialization, configuration, and logging docs.
+- Update package and skill descriptions to avoid unclear repository-scope jargon.
+
 ## 0.2.0 (breaking)
 
 **Breaking API change — drop leases, polling, and worker identity.**
diff --git a/README.md b/README.md
index ca0a4bc..6fa6046 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # loopy-loop
 
-`loopy-loop` is a repo-local automation loop for long-running AI agent work.
+`loopy-loop` runs long-running AI agent workflows inside your repository.
 It turns a goal file in your repository into an inspectable sequence of agent
 iterations: plan, implement, evaluate, record evidence, and continue until the
 goal is met or the loop hits a terminal blocker.
diff --git a/pyproject.toml b/pyproject.toml
index 7db4a94..398580e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "loopy-loop"
-version = "0.2.0"
-description = "A repo-local automation loop for AI agents built on team-harness."
+version = "0.2.1"
+description = "Run long-running AI agent workflows inside your repository."
 readme = "README.md"
 requires-python = ">=3.12"
 license = "Apache-2.0"
diff --git a/skills/loopy-loop/SKILL.md b/skills/loopy-loop/SKILL.md
index f532f3b..25472b7 100644
--- a/skills/loopy-loop/SKILL.md
+++ b/skills/loopy-loop/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: loopy-loop
-description: Set up and run loopy-loop, a repo-local automation loop that drives AI agents toward a goal across many iterations via a FastAPI coordinator and one or more workers. Use this skill when the user wants to install loopy-loop in a target repo, scaffold its config, define workflows, configure workflow scheduling/cadence, use session-scoped project_state or eval checks, or operate the coordinator/worker pair (start, monitor, stop, resume).
+description: Set up and run loopy-loop, an automation loop inside a repository that drives AI agents toward a goal across many iterations via a FastAPI coordinator and one or more workers. Use this skill when the user wants to install loopy-loop in a target repo, scaffold its config, define workflows, configure workflow scheduling/cadence, use session-scoped project_state or eval checks, or operate the coordinator/worker pair (start, monitor, stop, resume).
 ---
 
 # loopy-loop
@@ -22,7 +22,7 @@ Use this skill when the user asks to:
 
 ## Install
 
-For end-user / repo-local use, install as a tool:
+For end-user use in a target repository, install as a tool:
 
 ```bash
 uv tool install loopy-loop
diff --git a/uv.lock b/uv.lock
index d1a66ae..ced7e93 100644
--- a/uv.lock
+++ b/uv.lock
@@ -258,7 +258,7 @@ wheels = [
 
 [[package]]
 name = "loopy-loop"
-version = "0.2.0"
+version = "0.2.1"
 source = { editable = "." }
 dependencies = [
     { name = "click" },