Are you the author? Sign in to claim
Universal engineering judgment for Claude Code. Read before editing, reuse before writing, verify before shipping.
Engineering judgment for Claude Code.
Reads before he writes. Asks before he guesses. Ships diffs smaller than the ticket.
Claude Code • Agent Skills • MIT License
Graybeard is a universal engineering skill for Claude Code.
It doesn't teach Claude a programming language.
It teaches Claude how experienced software engineers think before changing code.
Instead of generating more code, Graybeard encourages Claude to:
Language agnostic.
Framework agnostic.
Repository agnostic.
Graybeard can be installed in three ways depending on your workflow.
Add the Graybeard marketplace:
/plugin marketplace add Virag-Koradiya/graybeard
Install the plugin:
/plugin install graybeard@graybeard
Note: Run the two commands as separate prompts.
Makes Graybeard available in every Claude Code project on your machine.
Clone the repository:
git clone https://github.com/Virag-Koradiya/graybeard.git
cd graybeard
mkdir -p ~/.claude/skills
cp -r skills/graybeard ~/.claude/skills/
if (-not (Test-Path "$HOME\.claude\skills")) {
New-Item -ItemType Directory "$HOME\.claude\skills" | Out-Null
}
Copy-Item -Recurse .\skills\graybeard "$HOME\.claude\skills\" -Force
Makes Graybeard available only in the current project.
mkdir -p .claude/skills
cp -r /path/to/graybeard/skills/graybeard .claude/skills/
if (-not (Test-Path ".\.claude\skills")) {
New-Item -ItemType Directory ".\.claude\skills" | Out-Null
}
Copy-Item -Recurse "C:\path\to\graybeard\skills\graybeard" ".\.claude\skills\" -Force
Restart Claude Code if it's already running.
Graybeard will automatically activate for coding tasks.
Most coding agents fail in predictable ways.
They:
Graybeard exists to prevent those mistakes before they happen.
Instead of giving coding rules, it provides a decision-making process.
Every change follows the same workflow.
Understand
↓
Decide
↓
Build
↓
Verify
↓
Report
Every step removes a common AI failure mode.
| Step | Prevents |
|---|---|
| Understand | Hallucinated APIs, misunderstood code |
| Decide | Wrong assumptions, unnecessary dependencies |
| Build | Over-engineering, speculative abstractions |
| Verify | "Should work" without evidence |
| Report | Hidden assumptions and unclear tradeoffs |
Add a DELETE endpoint.
The agent:
Result:
Large diff.
Repository becomes less consistent.
The agent:
Result:
Small diff.
Looks like a human wrote it.
Graybeard isn't another list of best practices.
It encodes engineering judgment.
Examples include:
When principles conflict, Graybeard follows this order:
Ponytail asks:
"Can we write less code?"
Graybeard asks:
"What's the safest, smallest, most maintainable change?"
The two complement each other well.
Graybeard is a good fit if you:
Graybeard optimizes for:
It intentionally avoids:
Those belong in your project's CLAUDE.md.
Graybeard builds on ideas from several excellent projects:
Graybeard extends these ideas into a universal engineering judgment layer focused on understanding, decision-making, implementation, verification, and reporting.
Graybeard isn't a collection of coding rules.
It's a decision-making framework.
Every change follows the same process:
Understand before editing.
Decide before building.
Build only what's needed.
Verify with evidence.
Report only what's useful.
MIT. Boring, owned, and it works.
1000+ skills curated from Anthropic, Vercel, Stripe, and other engineering teams
Agent harness performance optimization with skills, instincts, memory, and security
Design enforcement with memory — keeps your UI consistent across a project
Detects 37 AI writing patterns and rewrites text with human rhythm across 5 voice profiles