Claude Config — Skills & Setup

My personal Claude Code configuration. 19 skills that make Claude dramatically better at real engineering work — from Figma design generation to React Native, parallel agents, TDD, and more.

One command to install on Mac or Windows. Pull updates with git pull.

---

What's a Skill?

Skills are instruction sets that Claude loads on demand — like giving it a specialist's playbook for a specific task. When you say "debug this" or "design this in Figma", Claude reads the matching skill and follows a proven workflow instead of winging it.

They live in ~/.claude/skills/ (Mac/Linux) or %USERPROFILE%\.claude\skills\ (Windows).

---

Skills Included

Design & UI

Skill	What it does
figma-concept-to-design	Give Claude an image or concept → it writes real designs directly into Figma via the Plugin API. Supports Hi-Fi, Lo-Fi, new files, and upgrading existing designs.
building-native-ui	Complete guide for building beautiful Expo Router apps — animations, tabs, gestures, native sheets, and more.
brainstorming	Explores intent, requirements, and design decisions before any code is written. Prevents building the wrong thing.

Engineering Workflow

Skill	What it does
test-driven-development	Enforces writing tests before implementation. Follows red-green-refactor properly.
systematic-debugging	Structured debugging protocol — diagnoses root cause before proposing fixes. No more random attempts.
verification-before-completion	Runs actual verification commands before claiming anything is done. Evidence before assertions.
writing-plans	Turns specs and requirements into step-by-step implementation plans before touching code.
executing-plans	Runs implementation plans with review checkpoints — keeps multi-step work on track.

Code Quality

Skill	What it does
requesting-code-review	Guides Claude through a thorough self-review before merging — catches issues a human reviewer would catch.
receiving-code-review	Handles incoming review feedback with rigor — verifies suggestions before blindly implementing them.
simplify	Reviews changed code for quality, reuse, and efficiency — then fixes what it finds.
explaining-code	Deep code walkthroughs using layered analogies, ASCII diagrams, data-flow maps, and call graphs.

Git & Branching

Skill	What it does
using-git-worktrees	Creates isolated git worktrees for feature work — keeps your workspace clean.
finishing-a-development-branch	Guides completion of development work with structured options for merge, PR, or cleanup.

Agents & Parallelism

Skill	What it does
dispatching-parallel-agents	Runs 2+ independent tasks simultaneously using subagents — dramatically faster on multi-part work.
subagent-driven-development	Executes implementation plans with independent parallel tasks in the current session.

React Native

Skill	What it does
vercel-react-native-skills	React Native and Expo best practices — list performance, animations, native modules, design system patterns.

Meta

Skill	What it does
skill-creator	Creates, improves, and benchmarks new skills. Full eval loop with browser-based review viewer.
writing-skills	Writes and tests skill files before deployment.
using-superpowers	Establishes how to find and use skills at the start of any session.

---

Install — Mac / Linux

# 1. Clone
git clone https://github.com/farouqseriki/claude-config.git
cd claude-config

# 2. Install
chmod +x install.sh
./install.sh

Done. Restart Claude Code.

To update later:

git pull && ./install.sh

---

Install — Windows (PowerShell)

# 1. Clone
git clone https://github.com/farouqseriki/claude-config.git
cd claude-config

# 2. Install
powershell -ExecutionPolicy Bypass -File install.ps1

Done. Restart Claude Code.

To update later:

git pull; powershell -ExecutionPolicy Bypass -File install.ps1

---

Requirements

• Claude Code installed and authenticated
• Git

That's it. No npm, no Python, no config files to edit.

---

Keeping Skills in Sync

This repo is the single source of truth. The workflow:

Mac (edit skills) → git push → Windows VM (git pull + install)

The install scripts are additive — they overwrite existing skills but don't touch anything else in your Claude config.

---

Adding New Skills

# Create a new skill
mkdir ~/.claude/skills/my-skill
# Write your SKILL.md (see any existing skill for the format)

# Commit and push
cd ~/.claude
git add skills/my-skill
git commit -m "Add skill: my-skill"
git push

---

What's NOT in this repo

• Chat history
• Session data / cache
• settings.json — this has machine-specific paths. A clean template is included as settings.template.json. The install script creates a settings.json from it automatically if you don't have one yet.

---

Structure

claude-config/
├── skills/                     # All skill directories
│   ├── figma-concept-to-design/
│   ├── building-native-ui/
│   ├── systematic-debugging/
│   └── ... (16 more)
├── install.sh                  # Mac / Linux installer
├── install.ps1                 # Windows installer
├── settings.template.json      # Clean settings starter
└── README.md

---

Made by @farouqseriki