dotclaude

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

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

build

start here. sparring examines a position through Socratic inquiry, sota finds a current expert recommendation, design explores alternatives, and plan turns the selected direction into an implementation-ready design document.

skill
sparring rigorous Socratic inquiry before acting
sota current expert recommendation grounded in brief web research
design divergent exploration with independent reasoning agents
plan reviewed implementation-ready design documents

quality

before you ship. review what you built, refactor what's messy, audit what's bloated or stale.

skill
judge independent expert review before accepting work
audit full baseline audit sweep in parallel worktrees
audit-necessity question whether code should exist, cut maintenance cost
audit-structure fix misplaced files, god-modules, leaky boundaries, layering violations
audit-patterns unify divergent implementations, kill reimplementations
audit-correctness hunt logic bugs — off-by-one, inverted conditions, boundary cases
audit-error-handling hunt swallowed errors, missing awaits, unguarded entry points, resource leaks
audit-contracts check API, schema, event, CLI, and integration compatibility
audit-data-integrity check invariants, writes, migrations, precision, and drift
audit-reliability check timeouts, retries, partial failure, recovery, and shutdown
audit-logs fix missing observability, INFO bloat, wrong-level messages
audit-perf catch N+1, overfetching, blocking hot paths, unbounded growth
audit-security injection, auth/authz gaps, secrets, weak crypto, OWASP
audit-tests find redundant/weak tests, cover uncovered code
audit-complexity maximize LOC reduction
audit-comments strip stale or bloated comments and docstrings
ux UI evaluation across Nielsen's heuristics

ship

git workflow from branch to PR to merge.

skill
commit conventional commits + push
pr create or update a reviewable PR
merge merge branch into current, resolve conflicts
rebase rebase branch onto target, resolve conflicts
timesheet monthly work summary from git
yeet implement, merge, optionally audit, and sync from a dedicated worktree

improve

sharpen prompts, skills, and communication.

skill
prompt create and refine LLM system prompts
transformer rewrite skills for reasoning model performance
design-refiner turn UI build requests into expert design briefs
writing-identity rewrite communication in the user's natural voice

install

Codex plugin

Add the marketplace and install the plugin:

codex plugin marketplace add JHostalek/dotclaude
codex plugin add jhostalek-skills@jhostalek

Claude Code plugin

Add the marketplace and install the plugin:

/plugin marketplace add JHostalek/dotclaude
/plugin install jhostalek-skills@jhostalek

Skills are versioned with the plugin and invoked as /jhostalek-skills:<skill-name>. The plugin contains skills only.

Pi package

Install directly from Git:

pi install git:github.com/JHostalek/dotclaude

Invoke skills as /skill:<skill-name>. Use pi update --extensions to update the package.

releases

Claude Code, Codex, and Pi share one semantic version. Releases use annotated vMAJOR.MINOR.PATCH tags and are recorded in CHANGELOG.md. See RELEASING.md for the release procedure.

Editable standalone skills

# clone and symlink
git clone [email protected]:JHostalek/dotclaude.git ~/dotclaude
mkdir -p ~/.claude/skills
ln -s ~/dotclaude/skills/* ~/.claude/skills/

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

contributing

this project is owned and maintained by me alone. issues and pull requests are not accepted.

license

CC0 1.0 — public domain.