.claude
furkankoykiran/.claude
Personal Claude Code configuration: CLAUDE.md, custom skills, agents, hooks, and utility scripts.
Instalação
npx convez-ai furkankoykiran/.claude1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
.claude — Furkan Köykıran's Claude Code setup
My personal Claude Code configuration —
CLAUDE.md, custom skills, agents, hooks, and utility scripts, plus a
self-contained bootstrap that wires in a handful of upstream tools (gstack, rtk,
manim, graphify, several skill packs, Anthropic's official skills, and curated
plugin marketplaces).
It's public so others can fork it, borrow pieces, and leave the rest. The installer is idempotent (safe to re-run) and fail-soft (one broken optional tool never sinks the whole setup).
Quickstart
Linux / macOS (and Windows via WSL or Git Bash)
curl -fsSL https://raw.githubusercontent.com/furkankoykiran/.claude/main/install.sh | bash
Windows (native PowerShell, no WSL)
irm https://raw.githubusercontent.com/furkankoykiran/.claude/main/install.ps1 | iex
On native Windows you need Git for Windows (it bundles Git Bash, which runs gstack's setup) and Node.js (Chromium is driven by Node there). The installer checks for both and guides you if either is missing.
Manual
git clone https://github.com/furkankoykiran/.claude ~/.claude
cd ~/.claude && ./install.sh # or: .\install.ps1 on Windows
If ~/.claude already has files, the installer turns it into a git repo
tracking this remote (git reset --hard origin/main). Your local cache/,
sessions/, .credentials.json, config.json, etc. stay put — they're already
git-ignored.
Platform support
| Component | Linux | macOS | Windows (native) | Windows (WSL) |
|---|---|---|---|---|
Core (CLAUDE.md, agents, hooks, skills) | ✅ | ✅ | ✅ | ✅ |
| gstack + headless browser | ✅ | ✅ | ✅ (Git Bash + Node) | ✅ |
| rtk token proxy | ✅ | ✅ | ⚠️ filters only¹ | ✅ |
| manim-narration | ✅ | ✅ | ✅ | ✅ |
| graphify | ✅ | ✅ | ✅ | ✅ |
¹ On native Windows, rtk's token filters work but its PreToolUse hook auto-install is WSL-only (rtk#671).
Installer flags
Both installers honour the same knobs:
| Knob | Effect |
|---|---|
CLAUDE_DIR=/path | Install target (default ~/.claude) |
CLAUDE_BOOTSTRAP_MINIMAL=1 / -Minimal | Core only (configs + gstack + rtk); skip heavy skill packs |
CLAUDE_BOOTSTRAP_NO_SYNC=1 | Use the working tree as-is; skip the git fetch/reset (local testing, offline) |
What the installer does
- Syncs the repo at
~/.claude(unlessCLAUDE_BOOTSTRAP_NO_SYNC=1). - Seeds
config.jsonandsettings.jsonfrom the.examplefiles — only if missing, never overwriting yours. - Installs
bun(gstack's runtime). - Clones gstack and runs its setup,
linking its slash commands (
/qa,/review,/ship,/browse,/retro, …). On Linux it first installs Chromium's system libraries so the headless browser actually launches (see Troubleshooting). - Installs rtk and wires its PreToolUse hook.
- Installs Python deps (
manim,edge-tts) andffmpegformanim-narration. - Clones five upstream skill packs into
~/.claude/skills/(each git-ignored, auto-discovered by Claude Code): adithya-s-k/manim_skill, multica-ai/andrej-karpathy-skills, coreyhaines31/marketingskills, pbakaus/impeccable, and Leonxlnx/taste-skill. - File-copies a curated, always-on subset of Anthropic's official
anthropics/skills — the
office-document and authoring skills (
docx,pdf,pptx,xlsx,doc-coauthoring) plusmcp-builder,skill-creator, andweb-artifacts-builder. Overlapping skills and the name-collidingclaude-apiare skipped. - Installs (or upgrades) graphify and
wires its skill — re-running the bootstrap pulls the latest
graphifyy, just like the git skill packs above. - Registers four plugin marketplaces and installs a
curated set of workflow plugins (see below). Skipped if the
claudeCLI isn't onPATHyet. - Optionally configures portable MCP servers (
github,context7).
Every step except cloning the repo is fail-soft: a failure is recorded and
printed in an end-of-run summary instead of aborting the bootstrap. Re-run
./install.sh after fixing the cause — it picks up where it left off.
Personalization
After install, edit:
~/.claude/config.json— your username, blog dir, default language. Read byutils/lib/config.pyand the personal skills.~/.claude/settings.json— Claude Code permissions, hooks, env vars.
Both are git-ignored, so your edits never conflict with git pull.
MCP servers
scripts/setup-mcp.sh configures the two portable ones:
- github (HTTP) — needs a personal access token
- context7 (HTTP) — needs a Context7 API key
Tokens are stored in ~/.claude.json (mode 600), never in this repo. For
other MCP servers, use claude mcp add directly (or the /add-mcp skill).
Plugin marketplaces
Beyond the file-copied skills, the installer registers four Claude Code plugin
marketplaces so a large catalog is one /plugin install away without loading
every skill into each session. Registering a marketplace is free; only
installed plugins cost per-session context — so the big collections stay
on-demand:
- anthropics/skills — the rest of
Anthropic's official Agent Skills (marketplace
anthropic-agent-skills). - wshobson/agents — 80+ domain workflow
plugins (marketplace
claude-code-workflows). - obra/superpowers — a TDD / debugging /
planning methodology (
superpowers-dev). Left install-on-demand because it overlaps gstack's own plan / review / investigate skills. - mukul975/Anthropic-Cybersecurity-Skills
— 700+ MITRE/NIST-mapped security skills (
anthropic-cybersecurity-skills). Marketplace-only so it never floods the catalog.
From claude-code-workflows it eagerly installs a few high-value domain plugins
that fill real gaps without conflicting with gstack: backend-development,
data-engineering, cloud-infrastructure, cicd-automation, database-design.
Browse and install more with /plugin (or
claude plugin install <name>@<marketplace>). Trust note: Claude Code does
not vet marketplace contents — only add sources you trust. Remove one with
claude plugin marketplace remove <name>.
Updating
cd ~/.claude && git pull && ./install.sh # macOS/Linux
cd ~/.claude; git pull; .\install.ps1 # Windows
Troubleshooting
The Chromium binary downloads fine, but on a clean server/container its
OS-level shared libraries (GTK/graphics: libatk, libnss3, libcups, …) are
missing, so it can't launch. The installer now fixes this automatically
(ensure_browser_deps + a Playwright install-deps retry). To repair an
existing install by hand, as root:
cd ~/.claude/skills/gstack && bunx playwright install-deps chromium && ./setup --no-prefix
On Ubuntu 24.04+ some packages were renamed (libasound2 → libasound2t64,
etc.); Playwright's install-deps knows the current names, which is why it's
preferred over a hand-written apt list.
gstack's setup is a bash script. Install Git for Windows
(it bundles Git Bash) and re-run install.ps1.
On Windows, Chromium is driven by Node.js (Bun can't launch it there —
oven-sh/bun#4253). Install
Node.js LTS (or winget install OpenJS.NodeJS.LTS) and
re-run.
That's the fail-soft design working — the rest of the setup still completed. Read the listed step name, fix its cause (often a missing system dependency), and re-run the installer; it's idempotent.
Uninstall
rm -rf ~/.claude ~/.claude.json ~/.gstack # macOS/Linux; rtk binary: ~/.local/bin/rtk
Remove-Item -Recurse -Force $HOME\.claude, $HOME\.claude.json, $HOME\.gstack # Windows
Layout
.
├── CLAUDE.md # global instructions (loaded at session start)
├── agents/ # custom subagents (researcher, code-reviewer, …)
├── hooks/ # PreToolUse / PostToolUse / pre-push hooks
├── skills/ # personal + upstream slash commands
├── scripts/ # helpers (setup-mcp.sh, …)
├── utils/ # Python utilities (blog-scan, github-scan, …)
├── memory/ # per-user memory templates
├── .github/ # CI, issue/PR templates, Dependabot
├── config.json.example # template for ~/.claude/config.json
├── settings.json.example # template for ~/.claude/settings.json
├── install.sh # bootstrap (Linux/macOS/WSL/Git Bash)
└── install.ps1 # bootstrap (native Windows PowerShell)
CLAUDE.md is kept tight (under Anthropic's ~200-line target); domain knowledge
lives in skills, loaded on demand.
Contributing & security
- Contributions are welcome — see CONTRIBUTING.md.
- Found a security issue? See SECURITY.md (report privately).
- Be kind — see the Code of Conduct.
- Notable changes are tracked in CHANGELOG.md.
License
MIT — take what you want. Bundled upstream skill packs keep their own licenses (cloned at install time, not redistributed here).