Personal code-review and PR-description style guidelines, packaged as publishable Claude Code agent skills.
brad-johnson.code-review.md Source guideline doc (code-review rules)
brad-johnson.pr-descriptions.md Source guideline doc (PR-description rules)
REMOVED.md Audit log of vendor-specific content removed
skills/
brad-johnson-code-review/ Published skill — reviews a diff
brad-johnson-pr-description/ Published skill — critiques/drafts a PR body
tools/
code-review-splitter/ Maintainer tool: splits the code-review doc
into per-section files at three detail levels
pr-description-splitter/ Same, for the PR-description doc
Each skill follows the Open Agent Skills specification:
a SKILL.md with name + description frontmatter, plus bundled resources
loaded on demand. Both skills:
- Spawn one sub-agent per guideline section in parallel.
- Aggregate findings, dedupe, rank by impact, present a capped list (10 / 15 / 20 items at small / medium / large thoroughness).
- Guide the user through applying fixes or a revised PR body.
See skills/<name>/README.md for per-skill detail.
This repo is also a Claude Code plugin marketplace. From inside Claude Code:
/plugin marketplace add bradsk88/CodeStyle
/plugin install brad-johnson-code-style@code-style
Or copy a skill directory directly into one of:
~/.claude/skills/(user-scoped — available in every project)<project>/.claude/skills/(project-scoped)
Claude Code auto-discovers the skill on next launch and the activation
triggers in SKILL.md's description field do the rest.
npx skills-ref validate skills/brad-johnson-code-review
npx skills-ref validate skills/brad-johnson-pr-descriptionWhen a source guideline doc changes:
python3 tools/code-review-splitter/split_guidelines.py
python3 tools/pr-description-splitter/split_guidelines.pyBoth scripts overwrite skills/<name>/guidelines/{small,medium,large}/.
MIT — see LICENSE.