No description
  • Python 97.9%
  • Just 2.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-07-10 06:08:37 +08:00
tests fix: require successful skill gate evidence 2026-07-10 06:08:37 +08:00
.gitignore fix: uv.lock must be committed, not ignored 2026-07-02 23:55:03 +08:00
.vulture_whitelist.py initial: kuri-skill-gate plugin with git, toolchain, and AGENTS.md 2026-07-02 23:51:52 +08:00
__init__.py fix: require successful skill gate evidence 2026-07-10 06:08:37 +08:00
AGENTS.md fix: require successful skill gate evidence 2026-07-10 06:08:37 +08:00
justfile fix: require successful skill gate evidence 2026-07-10 06:08:37 +08:00
plugin.yaml fix: require successful skill gate evidence 2026-07-10 06:08:37 +08:00
pyproject.toml fix: require successful skill gate evidence 2026-07-10 06:08:37 +08:00
README.md fix: require successful skill gate evidence 2026-07-10 06:08:37 +08:00
uv.lock fix: require successful skill gate evidence 2026-07-10 06:08:37 +08:00

kuri-skill-gate

A Hermes plugin that blocks gated tool calls and terminal commands until the required safety skill has been read successfully through skill_view(). It keeps high-friction operations aligned with their documented procedures.

How it works

  • tool_execution middleware intercepts every tool call
  • Gated tools: patch → requires patch-tool-safety; delegate_task → requires delegate-task-best-practices
  • Gated commands (terminal): gh → requires gh-cli; more patterns addable via _COMMAND_PATTERN_GATES
  • A skill unlocks a gate only after its main SKILL.md read succeeds; failed reads and file_path reference reads do not unlock it
  • Terminal commands containing an independent gh token require gh-cli, including quoted shell subcommands
  • The plugin's own existing files may be patched during bootstrap only when their resolved real paths remain inside the resolved plugin directory
  • Per-session state is lazily cleaned after 24 hours and capped at 1,024 sessions; process restart also resets it

Installation

Clone to the Hermes user plugins directory:

git clone https://git.xlion.tw/xlionjuan/kuri-skill-gate.git \
    ~/.hermes/plugins/kuri-skill-gate

Enable

hermes plugins enable kuri-skill-gate

Takes effect after a gateway restart (/restart or restart the Hermes gateway service).

Using in other profiles

mkdir -p ~/.hermes/profiles/<profile>/plugins
ln -s ../../../plugins/kuri-skill-gate \
    ~/.hermes/profiles/<profile>/plugins/kuri-skill-gate
hermes plugins --profile <profile> enable kuri-skill-gate

Verification

cd ~/.hermes/plugins/kuri-skill-gate
uv tool run ruff check __init__.py tests/
ty check __init__.py tests/
python3 -m pytest tests/ -v

All three (lint, type check, tests) must pass before committing.