agentmods.dev

UserPromptSubmit

UserPromptSubmit is a hook for coding agents from alelaguard/agentguards-plugins. Its token cost is not measured, scanned A, original, MIT.

A prompt check that runs when you submit a message, before the coding agent receives it, by executing the AgentGuards Python hook.

In plain words
What is it for?
It is for applying AgentGuards checks to each user prompt before the agent processes it.
Why use it?
It can screen submitted instructions before they reach the agent, helping detect or block unsafe or manipulative prompts.

Hook

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the agentguards-claude-selfhosted plugin — 3 skills, 3 hooks shipped together

One of 3 entries in hooks.json — they are configured in one file and arrive together.

not rated 1 4d ago A scan tokens not measured original MIT
View the source file alelaguard/agentguards-plugins
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add alelaguard/agentguards-plugins
Claude Code
/plugin install agentguards-claude-selfhosted

Or install agentguards-claude-selfhosted, the plugin that ships this one along with the rest of its 3 skills, 3 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for UserPromptSubmit

README.md
[![agentmods](https://agentmods.dev/badge/hooks/alelaguard/agentguards-plugins/user-prompt-submit.svg)](https://agentmods.dev/hooks/alelaguard/agentguards-plugins/user-prompt-submit)
Your own site
<a href="https://agentmods.dev/hooks/alelaguard/agentguards-plugins/user-prompt-submit"><img src="https://agentmods.dev/badge/hooks/alelaguard/agentguards-plugins/user-prompt-submit.svg" alt="Measured on agentmods" height="20"></a>
Per session not measured What this adds to a session before it is invoked.
When invoked not measured Not applicable: nothing here is loaded into a session.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Security

Grade A, and why

UserPromptSubmit scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the commands this hook runs, not an audit. A hook is shell that executes on your machine at the event it names, which is why every command in it is printed with what was found.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

claude-selfhosted/hooks/hooks.json · 12 lines

What it actually says

{
  "UserPromptSubmit": [
    {
      "hooks": [
        {
          "type": "command",
          "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/agentguards_hook.py\" UserPromptSubmit"
        }
      ]
    }
  ]
}
Same file

What else hooks.json configures

This page is one entry in a file that holds 3. Installing the file brings all of them; each is measured and scanned on its own page.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 12 lines scan A ec1b6d9a0758

Subscribe to this mod's changes

UserPromptSubmit is a hook published in the GitHub repository alelaguard/agentguards-plugins (1 stars, last pushed 4d ago), licensed MIT. Its token cost is not measured: a hook is shell that never enters the context. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Guardrailsai-securityclaude-codeclaude-code-plugincodexllm-security
Related

Other hooks, from other repositories

PreToolUse

Runs before the agent uses a tool, executing atr_scan.py via python3. From Agent-Threat-Rule/agent-threat-rules.

Agent-Threat-Rule/agent-threat-rules · not measured

BeforeAgent

Runs on the BeforeAgent event, executing cli.js via node with --harness. From ilyautov/cordon.

ilyautov/cordon · not measured

SessionStart

Runs when a session starts, executing validate-cloud-command.py via python3 with --session-start. From matanryngler/deployshield.

matanryngler/deployshield · not measured

PreToolUse

Runs before the agent uses a tool for ^(Bash, PowerShell, Write, Edit, NotebookEdit)$ and ^mcp__ tool calls, executing safety-gate.mjs via node. From sodam-ai/SoDam-Loop-Eng.

sodam-ai/SoDam-Loop-Eng · not measured

UserPromptSubmit

Runs when you submit a prompt, before the agent sees it, executing start-watchdog.mjs via node. From sodam-ai/SoDam-Loop-Eng.

sodam-ai/SoDam-Loop-Eng · not measured

PostToolUse

Runs after a tool call finishes for Write and Edit tool calls, executing format_and_lint.sh. From supabase/supabase.

supabase/supabase · not measured