About

Imported from oimiragieo/agent-studio (.claude/skills/hook-updater/SKILL.md). Install upstream with npx skills add oimiragieo/agent-studio --skill hook-updater. Copyright stays with the author.

Hook Updater

Name: hook-updater
Author: oimiragieo

Overview

Use this skill to refresh an existing hook safely: research current best practices, compare against current implementation, generate a TDD patch backlog, apply updates, and verify ecosystem integration including settings.json registration.

When to Use

Reflection flags stale or malfunctioning hook behavior
EVOLVE determines hook capability exists but quality is outdated
User asks to audit/refresh an existing hook
Hook exit code or stdin protocol issues detected

The Iron Law

Never update a hook blindly. Every refresh must be evidence-backed, TDD-gated, and integration-validated.

Workflow

Step 0: Evaluate Current State

Read the hook file and understand its purpose
Check settings.json registration (which events, which matchers)
Run existing tests if they exist
Identify issues: wrong API pattern, missing registration, broken requires

Step 1: Research Best Practices

Read .claude/hooks/CLAUDE.md for hook conventions
Review similar hooks in the same category for patterns
Check .claude/rules/hooks.md for hook rules
Use Skill({ skill: 'research-synthesis' }) if external research needed

Step 2: Generate Patch Backlog

List specific changes needed (TDD-style: test first, then implement)
Prioritize by risk: registration fixes > exit code fixes > logic improvements
Estimate scope: <30 lines = auto-apply, >30 lines = plan mode

Step 3: Apply Updates

Write or update tests first (RED phase)
Apply hook changes (GREEN phase)
Refactor for clarity (REFACTOR phase)
Use Edit tool — never rewrite the entire file

Step 4: Verify Integration

Confirm hook is registered in .claude/settings.json for correct events
Verify hook exit codes: 0=allow, 2=block, 1=error (SE-03)
Verify stdin JSON parsing follows the standard protocol
Run pnpm lint:fix && pnpm format
Run hook-specific tests

Step 5: Record

Log changes via MemoryRecord if significant
Update CHANGELOG.md entry

Domain-Specific Validation

Hook MUST be registered in settings.json under appropriate event
Hook MUST use stdin JSON protocol (not programmatic function exports)
Hook MUST exit 0 (allow) or 2 (block) — never exit 1 for blocking
Hook MUST wrap body in try/catch, exit 0 on unexpected errors (SE-03)
Hook require() paths MUST be file-relative (../../lib/...), not CWD-relative

Anti-Patterns

Updating a hook without checking its settings.json registration
Changing exit codes without understanding the 0/1/2 semantics
Converting a stdin-protocol hook to programmatic API (or vice versa)
Removing error handling to "simplify" the hook

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/oimiragieo-agent-studio-hook-updater/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

oimiragieo-agent-studio-hook-updater.ocm.jsonjson

{
  "ocm": "1",
  "id": "oimiragieo-agent-studio-hook-updater",
  "kind": "skill",
  "name": "hook-updater",
  "description": "Research-backed hook refresh workflow for updating existing hooks with TDD checkpoints and settings.json registration validation.",
  "publisher": "oimiragieo",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "hooks",
      "updater",
      "maintenance",
      "framework",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Research-backed hook refresh workflow for updating existing hooks with TDD checkpoints and settings.json registration validation."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/oimiragieo/agent-studio",
      "path": ".claude/skills/hook-updater/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/oimiragieo/agent-studio/blob/HEAD/.claude/skills/hook-updater/SKILL.md",
      "key": "oimiragieo/agent-studio/.claude/skills/hook-updater/SKILL.md"
    }
  },
  "instructions": "# Hook Updater\n\n## Overview\n\nUse this skill to refresh an existing hook safely: research current best practices, compare against current implementation, generate a TDD patch backlog, apply updates, and verify ecosystem integration including settings.json registration.\n\n## When to Use\n\n- Reflection flags stale or malfunctioning hook behavior\n- EVOLVE determines hook capability exists but quality is outdated\n- User asks to audit/refresh an existing hook\n- Hook exit code or stdin protocol issues detected\n\n## The Iron Law\n\nNever update a hook blindly. Every refresh must be evidence-backed, TDD-gat",
  "cost": {
    "context_tokens": 672
  }
}

Fetch it by URL: GET /api/v1/registry/oimiragieo-agent-studio-hook-updater/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.