Skip to content
AI Summary

hk is a fast git hook manager that helps developers set up and manage git hooks in projects using pkl configuration. Developers working with git hooks, monorepos, or CI/CD workflows in hk-managed projects will find this skill useful for setup, configuration, and troubleshooting.

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "hk" skill in my project.

Please run this command in my terminal:
# Install skill into the correct directory (3 files)
mkdir -p .claude/skills/hk && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/hk/SKILL.md "https://raw.githubusercontent.com/technicalpickles/pickled-claude-plugins/main/plugins/dev-tools/skills/hk/SKILL.md" && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/hk/builtins-reference.md "https://raw.githubusercontent.com/technicalpickles/pickled-claude-plugins/main/plugins/dev-tools/skills/hk/builtins-reference.md" && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/hk/hk-pkl-reference.md "https://raw.githubusercontent.com/technicalpickles/pickled-claude-plugins/main/plugins/dev-tools/skills/hk/hk-pkl-reference.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Use when hk.pkl exists in project, hook output shows hk running, or working with git hooks in hk-managed projects. Also use when setting up, configuring, or troubleshooting hk git hooks.

Overview

hk is a fast git hook manager by jdx (author of mise). Uses pkl configuration language. Provides 90+ built-in linters. Docs: https://hk.jdx.dev/ GitHub: https://github.com/jdx/hk

Detection

Identify which hook manager a project uses: | File | Hook Manager | |------|--------------| | hk.pkl | hk | | lefthook.yml | lefthook | | .husky/ directory | husky | | .pre-commit-config.yaml | pre-commit (python) |

Key Commands

`bash hk init # Create initial hk.pkl hk install # Set up git hooks hk check # Run checks manually (read-only) hk fix # Auto-fix issues hk builtins # List available builtins hk validate # Validate config hk config dump # Show effective configuration `

Core Concepts

• Hooks: Git hook types (pre-commit, commit-msg, pre-push) • Steps: Named units of work within hooks • Builtins: Pre-configured linters (90+) via Builtins.pkl • Profiles: Enable/disable groups of steps (--profile slow)

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 1mo ago
Active
AdoptionUnder 100 stars
6 ★ · Niche
DocsREADME + description
Well-documented

GitHub Signals

Stars6
Issues4
Updated1mo ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code