Run any Skill in Manus with one click

hook-serve

Stars2

Forks1

UpdatedMarch 4, 2026 at 14:21

Build, maintain, and operate the contract-driven hook workspace with serve/relay/smash roles, Kafka core transport, and plug-and-play adapters. Use when editing runtime behavior, contract validation, adapter/plugin execution, or deployment documentation.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

heyAyushh

heyAyushh/hook

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	hook-serve
description	Build, maintain, and operate the contract-driven hook workspace with serve/relay/smash roles, Kafka core transport, and plug-and-play adapters. Use when editing runtime behavior, contract validation, adapter/plugin execution, or deployment documentation.

Hook Serve Workspace Skill

Workspace Map

src/: serve runtime (hook-serve)
tools/hook/: operator CLI for role execution and ops workflows
apps/default-openclaw/: canonical compatibility contract
apps/kafka-openclaw-hook/: compatibility wrapper binary for smash runtime
crates/relay-core/: contracts, validator, shared envelope/security primitives
crates/hook-runtime/: smash runtime and adapter execution engine
config/kafka-core.toml: Kafka core config reference
systemd/, firecracker/, scripts/: deployment and operations

Use This Skill To

evolve contract schema and profile semantics
implement or validate serve ingress adapter behavior
implement or validate smash egress adapter behavior
add or change plugin execution semantics on either side
tune fail-closed validation and runtime safety defaults
update operator docs and runbooks after behavioral changes

Safety Invariants

strict fail-closed validation unless debug mode is explicit
unsupported drivers rejected only when active in selected profile
Kafka remains mandatory transport between serve and smash
do not log sensitive secrets/tokens
preserve required-destination delivery semantics for smash

Fast Workflow

Make the smallest change in the owning module.
Update contract/runtime docs when behavior changes.
Run:

cargo fmt --all
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace

Key Docs

README.md
docs/CHANGELOG.md
docs/spec.md
tools/hook/README.md
crates/relay-core/README.md
crates/hook-runtime/README.md

More from this repository

same repository

kafka-openclaw-hook

heyAyushh/hook

Maintain the kafka-openclaw-hook compatibility binary and its integration with hook-runtime smash execution. Use when changing startup wiring, runtime env expectations, deployment compatibility, or smash adapter/plugin behavior.

2026-03-042

relay-core

heyAyushh/hook

Maintain shared relay-core contracts, validation, envelope models, and security primitives used by serve, relay, smash, and hook-runtime. Use when changing contract schema, active-profile validation, model compatibility, or signature/sanitization/timestamp logic.

2026-03-042

add-webhook-source

heyAyushh/hook

Add a new webhook source to hook serve. Covers implementing the SourceHandler trait, registering the handler, adding HMAC secret config, creating the Kafka topic, and writing tests. Use when integrating a new webhook provider (e.g. Stripe, PagerDuty, Bitbucket).

2026-03-042

kafka-kraft-firecracker

heyAyushh/hook

Provision and operate Apache Kafka in KRaft mode inside a Firecracker microVM without Docker, including host networking, guest bootstrap, systemd service, and security checks. Use when setting up a lightweight isolated Kafka broker for internal pipelines such as hook serve/relay/smash Kafka core transport.

2026-03-042

pipeline-debug

heyAyushh/hook

Trace a webhook through the full hook pipeline (serve → relay → smash), inspect Kafka topic contents, check consumer group lag, and replay messages from the DLQ. Use when a webhook is lost, delayed, or failing delivery, or when diagnosing any serve/relay/smash runtime issue.

2026-03-042

release-workflow

heyAyushh/hook

End-to-end release process for hook: version bumps, local validation gate, binary release via tag push, and crates.io publish in dependency order. Use when cutting a new release or diagnosing a failed publish.

2026-03-042

name	hook-serve
description	Build, maintain, and operate the contract-driven hook workspace with serve/relay/smash roles, Kafka core transport, and plug-and-play adapters. Use when editing runtime behavior, contract validation, adapter/plugin execution, or deployment documentation.

Hook Serve Workspace Skill

Workspace Map

src/: serve runtime (hook-serve)
tools/hook/: operator CLI for role execution and ops workflows
apps/default-openclaw/: canonical compatibility contract
apps/kafka-openclaw-hook/: compatibility wrapper binary for smash runtime
crates/relay-core/: contracts, validator, shared envelope/security primitives
crates/hook-runtime/: smash runtime and adapter execution engine
config/kafka-core.toml: Kafka core config reference
systemd/, firecracker/, scripts/: deployment and operations

Use This Skill To

evolve contract schema and profile semantics
implement or validate serve ingress adapter behavior
implement or validate smash egress adapter behavior
add or change plugin execution semantics on either side
tune fail-closed validation and runtime safety defaults
update operator docs and runbooks after behavioral changes

Safety Invariants

strict fail-closed validation unless debug mode is explicit
unsupported drivers rejected only when active in selected profile
Kafka remains mandatory transport between serve and smash
do not log sensitive secrets/tokens
preserve required-destination delivery semantics for smash

Fast Workflow

Make the smallest change in the owning module.
Update contract/runtime docs when behavior changes.
Run:

cargo fmt --all
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace

Key Docs

README.md
docs/CHANGELOG.md
docs/spec.md
tools/hook/README.md
crates/relay-core/README.md
crates/hook-runtime/README.md