By JHostalek
JHostalek's opinionated agent skills for planning, auditing, shipping, and improving software.
Use when auditing repo topology in a scope — code grouped by type where the repo groups by feature, god-modules, misplaced files, leaky or missing module boundaries, layer-direction violations, import cycles, over-nesting. Triggers on "audit structure", "repo structure review", "fix module boundaries", "check layering", "files in the wrong place".
Use when auditing comments, docstrings, or embedded documentation prose in a scope — to strip bloat and rewrite cluttered-but-justified entries. Triggers on "audit comments", "clean up docstrings", "strip stale comments", "comment cleanup".
Use when the goal is to reduce code size, remove unnecessary complexity, or simplify a module without removing user-facing behavior.
Use when auditing and fixing logic bugs in a scope — off-by-one, wrong operator, inverted condition, unhandled boundary cases, unit/dimension mismatch, code that doesn't do what its name or docstring claims. Triggers on "audit correctness", "fix logic bugs", "check for off-by-one", "correctness review".
Use when auditing and fixing error handling in a scope — swallowed exceptions, defaults returned on error, optional chaining masking missing data, floating promises / missing awaits, entry points with no error boundary, resource leaks on error paths. Triggers on "audit error handling", "hunt silent failures", "fix swallowed errors", "check error boundaries", "missing await".
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
skills for agentic coding tools. extremely opinionated. updated (almost) daily.
heads up: this is a global
~/.claudeconfiguration repo — skills, hooks, and settings that apply across all projects. project-specific instructions (CLAUDE.md,TOOLS.md, skills) live in individual repositories.
start here. sparring pressure-tests a proposal, design explores alternatives, and plan turns the selected direction into an implementation-ready design document.
| skill | |
|---|---|
sparring | adversarial pressure-test a proposal before committing |
design | divergent exploration with independent reasoning agents |
plan | reviewed implementation-ready design documents |
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 audit sweep — sequences every focused audit below |
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-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 |
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 |
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 |
| hook | |
|---|---|
approve-piped-bash | auto-approves piped commands when every segment is already in your allowlist (#1271) |
auto-approve-all | auto-approves all tool permission requests |
detect-skill-invocation | type /skillname in a prompt, get the skill injected into context (#19729) |
skills work out of the box, but some features require settings.json entries:
| setting | why |
|---|---|
env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1" | required for skills that spawn agent teams (judge, design, audit) |
permissions.additionalDirectories: ["~/.claude/skills"] | lets teammates read skill files — needed if you symlink skills into ~/.claude/skills/ |
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.
Add the marketplace and install the plugin:
codex plugin marketplace add JHostalek/dotclaude
codex plugin add jhostalek-skills@jhostalek
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 intentionally contains skills
only; configure hooks separately if you want to use them.
# clone and symlink
git clone [email protected]:JHostalek/dotclaude.git ~/dotclaude
ln -s ~/dotclaude/skills/* ~/.claude/skills/
# or just copy what you need
cp -r skills/pr ~/.claude/skills/
CC0 1.0 — public domain.
npx claudepluginhub jhostalek/dotclaude --plugin jhostalek-skillsCode review, fixes, commits, and linting for development workflows
Audit and optimize Claude Code configurations with dynamic best-practice research
Code review practices with technical rigor and verification gates. Use for receiving feedback, requesting code-reviewer subagent reviews, or preventing false completion claims in pull requests.
Verification-first engineering toolkit for Claude Code. 15 skills across a 5-phase spine (Investigate → Design → Implement → Verify → Ship), 8 specialist agents, an interactive setup wizard. Every skill has rationalizations + evidence requirements. Built for senior ICs and tech leads.
Harness for Claude Code — skills, /harness:* slash commands, persona subagents, lifecycle hooks, and MCP tools without per-repo `harness setup`. Sibling plugins exist for Cursor, Gemini CLI, and Codex.
Iterative Ralph loops with Codex CLI review gates at completion. Claude works until done, then Codex reviews before allowing exit.