Delegate independent tasks to specialized agents working concurrently with isolated context.
hk - Git Hook Manager
hk
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.
SKILL.md
Full skill instructions
hk - Git Hook Manager
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
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)
Configuration
When editing hk.pkl, read hk-pkl-reference.md in this skill directory for structure and examples.
Built-in Linters
When looking up builtins, read builtins-reference.md in this skill directory. Or run hk builtins for the live list.
Finding Help
Stable reference: Read the reference files in this skill directory when needed.
Latest docs:
npx @mdream/crawl https://hk.jdx.dev/ --output /tmp/hk-docs
GitHub issues:
gh issue list -R jdx/hk # List open issues
gh search issues --repo jdx/hk "error" # Search issues
gh issue view 123 -R jdx/hk # View specific issue
Troubleshooting
Hook not running:
hk install # Reinstall hooks
cat .git/hooks/pre-commit # Verify hook calls hk
Step skipped:
hk check -v # Verbose output shows skip reasons
hk config dump # Check effective configuration
Validate config:
hk validate # Check hk.pkl syntax
More Other skills
brand-guidelines
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
theme-factory
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.
internal-comms
A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).
Fundamental design principles for writing maintainable, testable Python code.
responsive-design
Modern responsive layouts using container queries, fluid typography, CSS Grid, and mobile-first strategies.
Generate Playwright tests from scenarios using interactive browser exploration and validation.
Automated website exploration and test case generation using Playwright.
Modern React state management with Redux Toolkit, Zustand, Jotai, and React Query for every state category.
gdpr-data-handling
GDPR-compliant data handling with consent management, data subject rights, and privacy controls.
Python error handling patterns including input validation, exception hierarchies, and partial failure handling. Use when implementing validation logic, designing exception strategies, handling batch processing failures, or building robust APIs.
refactor-plan
Detailed multi-file refactor planning with safety checks and rollback guidance.
