Husky Commit Governance Capability Pack Skill
Expert husky capability pack for lightweight local quality gates, commit message enforcement, and low-friction contributor workflows.
Open the source and read safety notes before installing.
Prerequisites
- Node package scripts for validation
- Conventional commit policy
- Contributor onboarding docs
Schema details
- Install type
- package
- Reading time
- 8 min
- Difficulty score
- 79
- Troubleshooting
- Yes
- Breaking changes
- No
- Package verified
- Yes
- SHA-256
- aef3f6a1d69042ef5f12ff5dc7958397dd7c5de9bbbcf55d4b7211f0e0eef66b
- Skill type
- capability-pack
- Skill level
- expert
- Verification
- validated
- Verified at
- 2026-04-11
| Platform | Support | Install path |
|---|---|---|
| claude-code | Native | .claude/skills/<skill-name>/SKILL.md |
| codex | Native | .agents/skills/<skill-name>/SKILL.md |
| windsurf | Native | .windsurf/skills/<skill-name>/SKILL.md |
| gemini | Native | .gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md |
| cursor | Adapter | .cursor/rules/<skill-name>.mdc |
| cli | Manual | AGENTS.md or tool-specific context file |
Full copyable content
# Trigger
"Apply the husky commit governance capability pack to this repository."
# Required output
1) Hook matrix (pre-commit, commit-msg, optional pre-push)
2) Fast-path command list (< 10s target)
3) Contributor bypass/override policy
4) Drift and maintenance checklistAbout this resource
Knowledge Freshness
This capability pack is pinned to documentation verified on 2026-04-11.
Retrieval Sources
- https://typicode.github.io/husky/
- https://www.conventionalcommits.org/en/v1.0.0/
- https://commitlint.js.org/
Core Workflow
- Define minimum local gate set for the repository type.
- Keep hooks fast and deterministic to avoid bypass behavior.
- Enforce commit message standard with clear error messages.
- Align local checks with CI checks to prevent drift.
- Document safe bypass conditions for emergency workflows.
Overview
This skill focuses on practical local governance: catch avoidable issues early while preserving fast contributor loops.
Capability Scope
- Hook design and prioritization
- Runtime/latency optimization
- Commit message policy enforcement
- Contributor ergonomics and onboarding
- Governance drift controls
Compatibility
Native
- Claude Code / Claude: native skill usage via
SKILL.md. - Codex/OpenAI workflows: compatible with Agent Skills-style
SKILL.mdcontent as reusable workflow instructions.
Manual Adaptation
- Gemini CLI: native skill usage via
.gemini/skills/<skill-name>/SKILL.mdor.agents/skills/<skill-name>/SKILL.mdwhere supported. - Cursor: use the generated
.cursor/rules/*.mdcadapter for project rules. - OpenClaw and similar agents: use the same skill content as a reusable prompt/workflow file when native skill import is unavailable.
Production Rules
- Keep pre-commit checks fast enough to avoid bypass patterns.
- Use the same underlying scripts for local hooks and CI.
- Document approved bypass conditions for emergency fixes only.
- Treat commit-msg enforcement as required for changelog quality.
Troubleshooting
Issue: Hooks are too slow and developers bypass them
Fix: keep pre-commit to staged-file checks only.
Issue: Hook failures differ from CI failures
Fix: use shared scripts for local and CI paths.
Issue: Commit message confusion
Fix: provide examples in failing output and contributor docs.
Output Contract
- Minimal hook policy with justifications.
- Exact script wiring in package manager config.
- Failure UX recommendations.
- Maintenance checklist for future contributors.
Source citations
Signals
Loading live community signals…
A short, calm digest of reviewed Claude resources. Unsubscribe any time.