dotclaude

skills for agentic coding tools. extremely opinionated. updated (almost) daily.

heads up: this is a global ~/.claude configuration repo — skills, hooks, and settings that apply across all projects. project-specific instructions (CLAUDE.md, TOOLS.md, skills) live in individual repositories.

build

start here. plan decomposes the problem, code implements it solo, orch scales to parallel agents when the task is too large for one.

quality

before you ship. review what you built, refactor what's messy, distill what's bloated.

ship

git workflow from branch to PR to merge.

improve

level up your setup. find community skills, benchmark your own, let intern analyze your sessions and auto-improve.

domain

specialized tools for specific problem spaces.

experimental — Pencil

design-to-code workflow for Pencil .pen files. requires the Pencil MCP server — see AI integration docs for setup.

hooks

configuration

skills work out of the box, but some features require settings.json entries:

hook scripts ship in hooks/ but must be wired in settings.json under the hooks key to take effect — see Claude Code docs on hooks.

install

# clone and symlink (recommended — stays updated)
git clone [email protected]:JHostalek/dotclaude.git ~/dotclaude
ln -s ~/dotclaude/skills/* ~/.claude/skills/

# or just copy what you need
cp -r skills/pr-review ~/.claude/skills/

third-party skills

some skills in this repo were created by other authors and are included under their original licenses — not CC0.

license

CC0 1.0 — public domain. excludes third-party skills listed above.

About dotclaude — Claude Code Skills Collection

dotclaude is an open-source, actively maintained collection of production-ready Agent Skills for Claude Code, Anthropic's agentic AI coding CLI. Skills are reusable prompt-based modules that extend what Claude Code can do — each packaged as a SKILL.md file with YAML frontmatter following the Agent Skills open standard adopted by Anthropic, Microsoft, OpenAI (Codex CLI), Cursor, GitHub Copilot, Atlassian, and Figma.

What Problem Does This Solve?

Claude Code ships with general-purpose intelligence but no opinionated workflows. dotclaude adds battle-tested skills for the full development lifecycle: planning (plan), implementation (code), code review (pr-review, qual), refactoring (refactor, distill), git workflow (commit, pr, worktree, worktree-clean), team orchestration (orch), and SEO/GEO optimization (seo-geo). Each skill encodes specific methodologies — the pr-review skill checks for correctness, security, and quality; the design skill spawns independent agents with different reasoning methods to prevent convergence bias; the intern skill analyzes past sessions to detect recurring patterns and auto-improve your configuration; the seo-geo skill applies Princeton GEO research methods and DataForSEO API integration to optimize for both traditional and AI search engines.

How dotclaude Compares to Alternatives

Skill Categories

Workflow skills automate the development loop: plan creates decomposed implementation plans with verification criteria; code executes plans with incremental testing and legacy cleanup; commit enforces conventional commits with branch guards; pr creates pull requests with conventional formatting; merge integrates branches with conflict resolution; worktree and worktree-clean manage git worktree lifecycle for isolated feature development; rebase rebases branches onto targets with conflict safety heuristics; orch orchestrates multi-agent teams for parallel implementation; timesheet generates monthly work summaries from git history.

Quality skills catch issues before they reach production: pr-review performs multi-dimensional code review (correctness, security, quality); qual spawns specialist agent teammates that analyze code from different angles then consolidate findings; judge provides independent expert review of work before accepting or extending it; razor questions whether code should exist and identifies where maintenance cost can be cut; refactor runs comprehensive architectural analysis with parallel agent teams per module; distill maximizes line-of-code reduction while maintaining readability; ux evaluates user interfaces across 13 dimensions mapped to Nielsen's heuristics; qg runs all quality gates (format, lint, typecheck, tests, build) and reports PASS/FAIL per gate.

Meta skills improve your Claude Code setup itself: skill-creator creates, modifies, benchmarks, and evaluates skills with variance analysis; improve-skill compares your skills against the open ecosystem and competing AI coding tools; find-skills discovers installable skills from community registries; intern analyzes recent Claude Code sessions to detect recurring patterns and automatically write skill and rule improvements; prompt designs production-grade LLM prompts through interactive collaboration; transformer rewrites skills so reasoning models perform them better — strips scaffolding, preserves domain knowledge, adds calibration.

Domain skills solve specific problems: design runs divergent design exploration by spawning independent agents with clean contexts and different reasoning methods (morphological analysis, TRIZ, constraint relaxation, biomimicry) to prevent convergence bias; color-system helps choose, evaluate, fix, extend, and operationalize colors for interfaces — palettes, themes, tokens, contrast, dark/light mode, and semantic color roles; seo-geo handles SEO and Generative Engine Optimization for both traditional search engines (Google, Bing) and AI search engines (ChatGPT, Perplexity, Gemini, Google AI Overview, Microsoft Copilot, Claude) — includes a free technical SEO audit script, 9 DataForSEO-powered Python scripts (keyword research, related keywords, autocomplete ideas, SERP analysis, backlinks, domain overview, competitor gap analysis), 6 reference guides (Princeton GEO research, platform-specific ranking algorithms, JSON-LD schema templates, SEO audit checklist, tools and APIs), and a real-world optimization case study.

Experimental — Pencil integration: pen-design creates production-quality UI designs in Pencil .pen files with design thinking and visual systems methodology; pen-code converts between .pen designs and React/Tailwind code (export from design or sync changes back). These skills require the Pencil desktop app and its MCP server — see AI integration docs for setup.

Installation and Usage

Install by copying skill directories into ~/.claude/skills/ or by cloning the repository and symlinking. Each skill is a self-contained directory with a SKILL.md file (YAML frontmatter defining name, description, and tool restrictions) plus optional supporting files in references/, scripts/, examples/, and agents/ subdirectories. Skills are invoked via /skillname slash commands in Claude Code.

Frequently Asked Questions

What is dotclaude?
dotclaude is an actively maintained collection of Agent Skills for Claude Code that add extremely opinionated workflows for planning, implementation, code review, refactoring, git operations, team orchestration, color systems, SEO/GEO optimization, and self-improving configuration. Each skill follows the Agent Skills open standard and works across Claude Code, Codex CLI, Cursor, and VS Code Copilot.

How do I install dotclaude skills?
Clone the repository and copy or symlink individual skill directories into ~/.claude/skills/. Each skill is self-contained — no dependencies, no build step, no configuration beyond placing the directory. Skills are automatically discovered by Claude Code on next session start.

Do these skills work with tools other than Claude Code?
Yes. All skills follow the Agent Skills open standard (agentskills.io) adopted by Anthropic, Microsoft (VS Code Copilot), OpenAI (Codex CLI), Cursor, GitHub, Atlassian, and Figma. Any tool that reads SKILL.md files with YAML frontmatter can use these skills.

What makes dotclaude different from other skill collections?
Three things: (1) agent team orchestration — skills like orch, qual, judge, refactor, and intern spawn multiple agents working in parallel; (2) self-improving meta-tooling — skill-creator, improve-skill, and intern let you create, benchmark, and auto-improve skills; (3) depth — each skill encodes specific methodologies rather than generic checklists (e.g., seo-geo includes 9 DataForSEO scripts and 6 reference guides based on Princeton GEO research).

What does the seo-geo skill do?
The seo-geo skill optimizes websites for both traditional search engines (Google, Bing) and AI search engines (ChatGPT, Perplexity, Gemini, Google AI Overview, Microsoft Copilot, Claude). It includes a free technical SEO audit script (no API key needed), 9 Python scripts powered by the DataForSEO API for keyword research, SERP analysis, backlink analysis, domain overview, competitor gap analysis, related keywords, and autocomplete ideas. Reference guides cover the 9 Princeton GEO optimization methods, platform-specific ranking algorithms for each AI search engine, JSON-LD schema templates, and a comprehensive SEO audit checklist.

Tags

claude-code-skills agent-skills claude-code-plugins claude-code-configuration ai-coding-tools ai-code-review ai-refactoring code-quality git-workflow-automation conventional-commits pull-request-automation git-merge git-worktree multi-agent-orchestration agent-teams design-exploration color-system color-palettes design-tokens seo-optimization generative-engine-optimization geo-optimization ai-search-optimization chatgpt-optimization perplexity-seo google-ai-overview dataforseo keyword-research serp-analysis backlink-analysis schema-markup json-ld skill-creator claude-code-setup dotfiles anthropic claude-sonnet claude-opus codex-cli cursor-rules copilot-skills agent-skills-standard prompt-engineering ux-evaluation code-distillation pencil-dev design-to-code pen-files mcp-server developer-tools ai-developer-tools typescript python open-source