Add the vercel-labs/skills/skills/find-skills skill (#1569)

nathanjmcdougall · web-flow · commit 25840a9adc45 · 2026-03-27T14:27:58.000+13:00
diff --git a/.agents/skills/usethis-qa-static-checks/SKILL.md b/.agents/skills/usethis-qa-static-checks/SKILL.md
@@ -4,7 +4,7 @@ description: Perform static code checks
 compatibility: usethis, Python, prek, basedpyright
 license: MIT
 metadata:
-  version: "1.4"
+  version: "1.5"
 ---
 
 # Static Checks
@@ -21,3 +21,7 @@ Note that we are interested in both errors and warnings from these tools - we sh
 ## When to run these checks
 
 Before submitting changes for review, **always** run these static checks. This should be done every time, even for small changes, to avoid slowing down the code review process unnecessarily.
+
+## What to do when prek checks fail
+
+It's quite common for minor cosmetic changes to be made automatically when running the prek checks, even by linters such as Ruff and mkdownlint-cli2. Since auto-fixes may have been applied during the first run, if checks fail, you should re-run a second time to see if any issues remain. Only then should you proceed to fix any remaining issues manually.
diff --git a/.agents/skills/usethis-skills-external-add/SKILL.md b/.agents/skills/usethis-skills-external-add/SKILL.md
@@ -4,7 +4,7 @@ description: Add an external (community) skill to the project from a third-party
 compatibility: usethis, agent skills, npx, markdown
 license: MIT
 metadata:
-  version: "1.1"
+  version: "1.2"
 ---
 
 # Adding External Skills
@@ -17,7 +17,7 @@ External skills are sourced from third-party repositories rather than written lo
 2. Install the skills using `npx skills add <source> --skill '*' --agent github-copilot --yes` (e.g. `npx skills add CodSpeedHQ/codspeed --skill '*' --agent github-copilot --yes`).
 3. Note the skill name(s) added to `skills-lock.json`.
 4. Add each new skill to the external skills registry in `AGENTS.md`.
-5. Verify the hook passes: `python hooks/check-skills-documented.py`.
+5. Verify the hook passes: `uv run prek check-skills-documented`.
 
 ## Line endings and reproducible hashes
 
diff --git a/AGENTS.md b/AGENTS.md
@@ -43,14 +43,16 @@ The `.agents/skills` directory contains agent skills.
 
 External skills can be installed if they are not present — see the `usethis-skills-external-install` skill.
 
-| Skill                    | Source                | Description                                                             |
-| ------------------------ | --------------------- | ----------------------------------------------------------------------- |
-| `codspeed-optimize`      | `CodSpeedHQ/codspeed` | Optimize code for performance using CodSpeed benchmarks and flamegraphs |
-| `codspeed-setup-harness` | `CodSpeedHQ/codspeed` | Set up performance benchmarks and the CodSpeed harness for a project    |
+| Skill                    | Source                | Description                                                                           |
+| ------------------------ | --------------------- | ------------------------------------------------------------------------------------- |
+| `codspeed-optimize`      | `CodSpeedHQ/codspeed` | Optimize code for performance using CodSpeed benchmarks and flamegraphs               |
+| `codspeed-setup-harness` | `CodSpeedHQ/codspeed` | Set up performance benchmarks and the CodSpeed harness for a project                  |
+| `find-skills`            | `vercel-labs/skills`  | Discover and install agent skills from the open skills ecosystem for new capabilities |
 
 ### Important Instructions about Skills usage
 
 - ALWAYS use possibly relevant agent skills when they are available. Eagerly use skills, if in doubt, assume a skill is relevant.
+- ALWAYS use `find-skills` to research new skill capabilities if there are difficult tasks, tasks in an unfamiliar domain, if you believe there is a lack of clarity or direction around precisely how to proceed, or if you get stuck or find something surprisingly challenging. When using this skill, please be sure to use the `usethis-skills-external-install` skill when deciding to install a new external skill.
 - ALWAYS consider the `usethis-qa-static-checks` to be relevant: if you think your task
   is complete, always run this skill to check for any issues before finishing.
 - ALWAYS mention which skills you've used after completing any task, in PR descriptions, and comments.
diff --git a/skills-lock.json b/skills-lock.json
@@ -10,6 +10,11 @@
       "source": "CodSpeedHQ/codspeed",
       "sourceType": "github",
       "computedHash": "587a58bc7498635347ee7a7eba66ac17c75430db7543be4af7eaab74533a6714"
+    },
+    "find-skills": {
+      "source": "vercel-labs/skills",
+      "sourceType": "github",
+      "computedHash": "d31e234f0c90694a670222cdd1dafa853e051d7066beda389f1097c22dadd461"
     }
   }
 }

Original file line number	Diff line number	Diff line change
`@@ -10,6 +10,11 @@`
`10`	`10`	`"source": "CodSpeedHQ/codspeed",`
`11`	`11`	`"sourceType": "github",`
`12`	`12`	`"computedHash": "587a58bc7498635347ee7a7eba66ac17c75430db7543be4af7eaab74533a6714"`
	`13`	`+ },`
	`14`	`+ "find-skills": {`
	`15`	`+ "source": "vercel-labs/skills",`
	`16`	`+ "sourceType": "github",`
	`17`	`+ "computedHash": "d31e234f0c90694a670222cdd1dafa853e051d7066beda389f1097c22dadd461"`
`13`	`18`	`}`
`14`	`19`	`}`
`15`	`20`	`}`