Claude Skill

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.

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Download technicalpickles-pickled-claude-plugins-plugins_dev-tools_skills_hk-8d13327.zip · 4 KB

Install

skills CLI npx skills add https://github.com/technicalpickles/pickled-claude-plugins/tree/main/plugins/dev-tools/skills/hk
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install technicalpickles-pickled-claude-plugins@llmmart
Git git clone https://github.com/technicalpickles/pickled-claude-plugins.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole technicalpickles/pickled-claude-plugins collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

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
Files (pickled-claude-plugins)
  • builtins-reference.md 4 KB
    Loading…
  • hk-pkl-reference.md 3.7 KB
    Loading…
  • SKILL.md 2.3 KB
    ---
    name: hk
    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.
    ---
    
    # 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
    
    ```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`)
    
    ## 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:**
    ```bash
    npx @mdream/crawl https://hk.jdx.dev/ --output /tmp/hk-docs
    ```
    
    **GitHub issues:**
    ```bash
    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:**
    ```bash
    hk install        # Reinstall hooks
    cat .git/hooks/pre-commit  # Verify hook calls hk
    ```
    
    **Step skipped:**
    ```bash
    hk check -v       # Verbose output shows skip reasons
    hk config dump    # Check effective configuration
    ```
    
    **Validate config:**
    ```bash
    hk validate       # Check hk.pkl syntax
    ```
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.