diff --git a/.changelog/ignore-finder-metadata.md b/.changelog/ignore-finder-metadata.md
new file mode 100644
index 0000000..7deb81b
--- /dev/null
+++ b/.changelog/ignore-finder-metadata.md
@@ -0,0 +1,6 @@
+---
+category: fixed
+type: patch
+---
+
+Remove tracked Finder metadata and ignore .DS_Store files throughout the repository.
diff --git a/.gitignore b/.gitignore
index a4cdf71..756d9dd 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,3 @@
 /vendor/
 /.agents/
+.DS_Store
diff --git a/DESIGN.md b/DESIGN.md
index aa0f080..f253376 100644
--- a/DESIGN.md
+++ b/DESIGN.md
@@ -32,7 +32,7 @@ Runtime images live in `data/` so excluding consumer documentation from a Compos
 
 ## Validation
 
-Install the development tool with `composer install --no-scripts`, then run `php tests/generate-fixture.php`. Composer allows only the official `phpdocumentor/shim` plugin, which installs the signed phpDocumentor PHAR; no runtime dependency is added to template consumers. The CI matrix renders the fixture with PHP 8.3, 8.4 and 8.5 from both the checkout and a Git archive, and actionlint validates the workflow. The PHAR's bundled dependencies are outside Composer's dependency-audit coverage; use this build tool only with trusted project sources.
+Install the development tool with `composer install --no-scripts`, then run `php tests/generate-fixture.php` and `php tests/verify-consumer-skill.php`. The specifically approved `phpdocumentor/shim` plugin installs the signed phpDocumentor PHAR; no runtime dependency is added to template consumers. The separately approved `llm/skills` plugin synchronizes the contribution skill according to `skills.json`, including when `--no-scripts` is used. The CI matrix renders both fixtures with PHP 8.3, 8.4 and 8.5 from the checkout and a Git archive, and actionlint validates the workflow. The PHAR's bundled dependencies are outside Composer's dependency-audit coverage; use this build tool only with trusted project sources.
 
 Generate the fixture from `tests/fixture` with phpDocumentor 3:
 
diff --git a/guides/.DS_Store b/guides/.DS_Store
deleted file mode 100644
index 7beed2e..0000000
Binary files a/guides/.DS_Store and /dev/null differ
diff --git a/guides/body/.DS_Store b/guides/body/.DS_Store
deleted file mode 100644
index 427fd02..0000000
Binary files a/guides/body/.DS_Store and /dev/null differ