diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..9d0bb19
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,9 @@
+# Ignore everything by default; only hand-authored config is tracked.
+/*
+
+# Un-ignore known-safe files/dirs
+!/.gitignore
+!/README.md
+!/settings.json
+!/skills/
+!/skills/**
diff --git a/README.md b/README.md
index e69de29..75e6a26 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,15 @@
+# Claude Code Config
+
+Personal configuration for [Claude Code](https://claude.com/claude-code), version-controlled from `~/.claude`.
+
+## Contents
+
+- `settings.json` — global settings (theme, spinner verbs, etc.)
+- `skills/` — custom skills available across all projects
+- `plugins/` — installed plugin marketplaces
+
+## Notes
+
+Most of `~/.claude` is runtime state (session history, credentials, caches, task
+locks) and is intentionally left untracked. Only stable, hand-authored config
+should be added to this repo.
diff --git a/skills/skill-creator/SKILL.md b/skills/skill-creator/SKILL.md
new file mode 100644
index 0000000..5754d97
--- /dev/null
+++ b/skills/skill-creator/SKILL.md
@@ -0,0 +1,39 @@
+---
+name: skill-creator
+description: Create new skills, modify and improve existing skills. Use when users want to create a skill from scratch, edit, or optimize an existing skill.
+---
+
+# Skill Creator
+
+Help the user create a new skill by guiding them through these steps:
+
+1. **Define the skill**: Ask what the skill should do, when it should trigger, and what tools it needs.
+2. **Create the folder structure**: Create a folder in `~/.claude/skills/` with the skill name (kebab-case).
+3. **Write SKILL.md**: Create the SKILL.md file with proper YAML frontmatter (name, description) and markdown instructions.
+4. **Optional files**: Create scripts/, references/, or assets/ subdirectories if needed.
+
+## SKILL.md Format
+
+```markdown
+---
+name: your-skill-name
+description: What it does. Use when [trigger conditions].
+---
+
+# Your Skill Name
+
+## Instructions
+
+### Step 1: [First Major Step]
+Clear explanation of what happens.
+
+### Step 2: [Next Step]
+...
+```
+
+## Rules
+- Folder name must be kebab-case (e.g., `my-cool-skill`)
+- File must be exactly `SKILL.md` (case-sensitive)
+- Description must include what it does AND when to use it
+- No XML angle brackets in frontmatter
+- Keep SKILL.md focused on core instructions; put detailed docs in references/