install-hooks

Install and manage the adr-kit pre-commit hook for code commits.

4|1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/rvdbreemen/adr-kit --skill install-hooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: install-hooks
Source: https://github.com/rvdbreemen/adr-kit/tree/main/skills/install-hooks
Command: npx skills add https://github.com/rvdbreemen/adr-kit --skill install-hooks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires adr-kit, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the installation and management of pre-commit hooks for code governance using adr-kit, ensuring that architecture decisions are enforced before code is committed.

Core Features & Use Cases

  • Automated Hook Installation: Installs or uninstalls the adr-kit pre-commit hook in the current project.
  • Template Resolution: Resolves the plugin's hook template and ensures it is available for use.
  • Hook Management: Detects existing hooks and manages their installation, including creating a wrapper script if necessary.
  • Configuration: Configures the core.hooksPath for git to recognize the new hook.
  • Guardian Hook Addition: Optionally adds a project-scoped guardian hook to .claude/settings.json for additional code health checks.
  • Use Case: When you want to enforce architecture decisions across your codebase, use this Skill to install the pre-commit hook, which will check code against the decisions recorded in your ADRs.

Quick Start

Run the install-hooks skill to install the pre-commit hook for adr-kit in your current project.

Frequently Asked Questions about install-hooks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate pre-commit hook installation for architecture decision records?

Automating pre-commit hook installation for architecture decision records is handled by configuring the adr-kit hook template and setting git's core.hooksPath. This ensures architecture decisions are enforced before code is committed.

What problem does a pre-commit hook for code governance solve?

A pre-commit hook for code governance solves the problem of unenforced architecture decisions by checking code against recorded ADRs before commits. This guarantees adherence to architectural standards across the codebase.

Do I need Python to install adr-kit pre-commit hooks?

Yes, you need Python 3.9 or higher to install adr-kit pre-commit hooks. The installation process also requires the adr-kit package to function and properly configure the git hooks.

How do I manage existing git hooks when adding code governance checks?

Managing existing git hooks during code governance setup involves detecting current hooks and creating a wrapper script if necessary. This allows the adr-kit pre-commit hook to integrate seamlessly without overwriting prior configurations.

Can I add project-scoped code health checks alongside adr-kit hooks?

Yes, you can add project-scoped code health checks by optionally configuring a guardian hook in the .claude/settings.json file. This provides additional automated code quality checks during commits.

How do I uninstall the adr-kit pre-commit hook from my project?

Uninstalling the adr-kit pre-commit hook from your project is supported by the same automated management process used for installation. This allows you to cleanly remove code governance checks when they are no longer needed.