convez.ai
Skill
furkankoykiran

.claude

furkankoykiran/.claude

Ver no GitHub
BomPluginScore · de 0 a 100

Personal Claude Code configuration: CLAUDE.md, custom skills, agents, hooks, and utility scripts.

Instalação

$npx convez-ai furkankoykiran/.claude

1 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

Estrelas
5
Forks
1
Acompanhando
0
Saúde
100%
Último commit
há 2 dias
Versão
v2.1.3
Issues abertas
2
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

.claude — Furkan Köykıran's Claude Code setup

CI License: MIT Platform

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

ComponentLinuxmacOSWindows (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:

KnobEffect
CLAUDE_DIR=/pathInstall target (default ~/.claude)
CLAUDE_BOOTSTRAP_MINIMAL=1 / -MinimalCore only (configs + gstack + rtk); skip heavy skill packs
CLAUDE_BOOTSTRAP_NO_SYNC=1Use the working tree as-is; skip the git fetch/reset (local testing, offline)

What the installer does

  1. Syncs the repo at ~/.claude (unless CLAUDE_BOOTSTRAP_NO_SYNC=1).
  2. Seeds config.json and settings.json from the .example files — only if missing, never overwriting yours.
  3. Installs bun (gstack's runtime).
  4. 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).
  5. Installs rtk and wires its PreToolUse hook.
  6. Installs Python deps (manim, edge-tts) and ffmpeg for manim-narration.
  7. 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.
  8. 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) plus mcp-builder, skill-creator, and web-artifacts-builder. Overlapping skills and the name-colliding claude-api are skipped.
  9. Installs (or upgrades) graphify and wires its skill — re-running the bootstrap pulls the latest graphifyy, just like the git skill packs above.
  10. Registers four plugin marketplaces and installs a curated set of workflow plugins (see below). Skipped if the claude CLI isn't on PATH yet.
  11. 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 by utils/lib/config.py and 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

License

MIT — take what you want. Bundled upstream skill packs keep their own licenses (cloned at install time, not redistributed here).

Ver o original no GitHub

Bom para

Relacionados