chore: add claude skill for reviewing docs#16137
Merged
Conversation
Member
shellmayr
commented
Jan 23, 2026
shellmayr
commented
- This adds a skill that enables claude to review docs PRs for style & language using specific guidelines
- We tried this out and found that it was very correct in what it suggested, may be useful for conducting a local self-review before having other developers read through documentation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
obostjancic
approved these changes
Jan 23, 2026
Contributor
|
@shellmayr I found a related skill that’s an interesting application for ensuring a specific reading skill level: https://github.com/nateberkopec/dotfiles/blob/fa30f09f01fc50e6a49fd3db9a8e7626e440c2c1/files/home/.claude/skills/readme-writer/SKILL.md. |
Member
Author
|
@dingsdax that's also interesting! I guess we could also ask it to measure flesch score and optimize towards that, but I honestly wouldn't go that far. I've tried some of that in the past, and it's a bit of a rabbit hole to try to optimize for reading levels, especially because the models definitely don't one-shot that |
shellmayr
deleted the
shellmayr/chore/add-claude-skill-for-reviewing-docs
branch
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 subscribe to this conversation on GitHub.
Already have an account?
Sign in.
3 participants
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.