docs: shorten Hookdeck triage skill trigger by maximalang · Pull Request #19 · hookdeck/hermes-hookdeck · GitHub
Skip to content

docs: shorten Hookdeck triage skill trigger - #19

Open
maximalang wants to merge 2 commits into
hookdeck:mainfrom
maximalang:docs/short-skill-trigger
Open

docs: shorten Hookdeck triage skill trigger#19
maximalang wants to merge 2 commits into
hookdeck:mainfrom
maximalang:docs/short-skill-trigger

Conversation

@maximalang

@maximalang maximalang commented Sep 6, 2026

Copy link
Copy Markdown

Summary

  • shorten both the bundled frontmatter and registered plugin metadata from 189 to 54 characters
  • keep the trigger specific to failed or stuck Hookdeck event runs
  • leave the full workflow and recovery guidance unchanged

Why

Long skill descriptions are truncated in agent catalogs and can create false-positive activation pressure. This keeps the activation rule visible and precise while preserving progressive disclosure in the skill body.

Risk

Low: packaged prose-only change; no runtime code or tool contract changes. Per repository policy, this is a PATCH-level shipped change.

Verification

  • python -m ruff check . — pass
  • python -m pytest tests/test_register.py -q — 4 passed after aligning registered metadata
  • python -m pytest — 319 passed, 2 Windows-only baseline failures (test_a_tilde_in_cli_config_path_is_expanded, test_without_an_api_key_it_degrades_to_the_ambient_session)
  • python -m build — pass
  • inspected built wheel: both hookdeck/skills/triage-webhook-failures/SKILL.md and hookdeck/__init__.py contain the 54-character description
  • git diff --check — pass

Remaining risk

Linux CI should provide the authoritative full-suite result; the two local failures are in platform-specific path/subprocess assumptions outside this markdown-only diff.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant