skills.rest
Pepsi1978
Pepsi1978COMMUNITY
Explore all skills by this author →
GitHub

hook-forge

Creates cross-platform Claude Code hooks with automated validation and logging for PS1 and SH environments.

1|Updated Feb 9, 2026
Search Tags:#workflow#logging#bash#cross-platform#hook#powershell#hook-forge
One-click install
npx skills add https://github.com/Pepsi1978/proggs --skill hook-forge
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hook-forge
Source: https://github.com/Pepsi1978/proggs/tree/main/claude-code-setup/commands/hook-forge
Command: npx skills add https://github.com/Pepsi1978/proggs --skill hook-forge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that every Claude Hook is created and loaded in a safe, cross‑platform manner, preventing runtime hook failures and guaranteeing consistent behavior on Windows and macOS/Linux.

Core Features & Use Cases

  • Enforces a disciplined, multi-phase hook workflow (design, templating, integration) for reliable hook creation.
  • Provides dual-platform templates (PowerShell and Bash) to ensure parity across environments.
  • Integrates with centralized logging and self-improvement workflows (Whiteboard) to surface issues and improvements.
  • Supports async hooks when long-running tasks are needed, with safe process handling.

Quick Start

Design and implement a new cross-platform hook using the provided templates, and commit it to the claude-code-setup/hooks directory.

Frequently Asked Questions about hook-forge

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

FAQPage Schema
How do I create cross-platform hooks that work on both PowerShell and Bash?▼

Cross-platform hooks for PowerShell and Bash are created using dual-platform templates that ensure functional parity across Windows and macOS/Linux environments. The workflow covers design, templating, and integration to prevent runtime failures.

How do I add automated validation and logging to my Claude Code hooks?▼

Automated validation and logging are integrated into hook templates during creation to surface runtime issues and support self-improvement workflows. This approach ensures consistent behavior and tracks execution safely across both PS1 and SH environments.

Can I run long-running async hooks in Claude Code without blocking the main process?▼

Async hooks are supported for long-running tasks using safe process handling within the hook workflow. This allows scripts to execute extended operations without blocking the main Claude Code environment.

What is the best way to prevent Claude hook failures when switching between Windows and Linux?▼

The best way to prevent hook failures across Windows and Linux is using dual templates with built-in error handling and centralized logging. This validates behavior before integration into the setup repository.

Do I need to manually rewrite my existing hooks for cross-platform compatibility?▼

Existing hooks do not require manual rewrites for cross-platform compatibility. The workflow supports automated rewrites into dual-platform PowerShell and Bash templates while maintaining validation and logging standards.

Related Skills

Explore More Software Engineering Skills→
masermediagroup-stackmasermediagroup-stack
1

siem-logging

Configure centralized SIEM logging and detection-rule development across cloud and on-prem environments.

Community
Advanced
mopeyjellyfishmopeyjellyfish
1

observability

Identify runtime observability requirements and define logs, metrics, traces, and dashboards.

Community
Advanced
greenflash-aigreenflash-ai

greenflash-onboard

Integrate Python and TypeScript projects with the Greenflash SDK for AI conversation logging.

Official
Intermediate
JingyueCongJingyueCong

posix-shell-pro

Review shell scripts for POSIX compliance and portability improvements.

Community
Advanced