Conversation
The PR template and CONTRIBUTING both required updating `plugin/skills/beardrive/SKILL.md` on a CLI behavior change. That tree was deleted deliberately — CLAUDE.md states there is no Claude Code plugin and no bundled skill — so every PR carried a checkbox nobody could tick, which trains contributors to tick without reading. Both now name the three surfaces CLAUDE.md's own "Docs to keep in sync" section lists: README.md, INSTALL_FOR_AGENTS.md, and web/docs/src/content/docs/. The CONTRIBUTING justification clause about the skill making agents beardrive-aware goes with it — it described nothing. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
TL;DR
CONTRIBUTING.mdboth demanded you updateplugin/skills/beardrive/SKILL.md— a file deleted on purpose, in aplugin/directory that doesn't exist.The change
One substitution, applied in the two places the stale path survived:
The CONTRIBUTING justification clause goes with the path. "The skill is what makes agents beardrive-aware and must match the binary" described nothing that exists — the agent integration is
internal/agenthooksplusINSTALL_FOR_AGENTS.md, which is what CLAUDE.md says too.Why these three surfaces
They aren't a judgment call. CLAUDE.md's "Docs to keep in sync" section already names exactly them, so the edit is a substitution rather than an invention:
README.mdINSTALL_FOR_AGENTS.mdweb/docs/src/content/docs/reference/cli.md,reference/hub-config.md,reference/project-files.md,self-hosting/web/docs/src/content/docs/is a directory, not a file. Naming the directory keeps the checkbox tickable in ten seconds; naming its four stale-prone pages would have turned one box into five, which is the problem this PR is fixing.What was checked
git grep -n "plugin/skills"→ no output. Those two lines were the only references repo-wide; nothing else pointed at the deleted tree.ls README.md INSTALL_FOR_AGENTS.md web/docs/src/content/docs/→ all three exist.go build ./... && go vet ./...green.go test ./...green (see below) — no.goor frontend file is touched by this diff, so nonpm run build, nostatic/rebuild, no e2e, and no new test to add.architecture/, so no diagram section.What this doesn't do
The scope was deliberately two lines. It does not audit other stale paths elsewhere in the repo, restore a
plugin/directory, or rewrite the rest of either file. If more corpses are pointed at from contributor-facing docs, they'd need their own sweep — this PR only proves there are no others namedplugin/skills.Closes BEA-191.
Build session
(Only works on the machine this branch was built on.)