Compétences Hook Development
📦
Hook Development
v0.1.0 Révision du contenu r1 Risque élevé ⚙️ Commandes externes📁 Accès au système de fichiers🔑 Variables d’environnement🌐 Accès réseau
Créer des hooks Claude Code en toute sécurité
Les équipes ont besoin de hooks fiables pour valider l’utilisation des outils et appliquer des règles de workflow. Cette skill guide les utilisateurs de Claude, Codex et Claude Code dans la conception, les tests et les modèles de migration des hooks.
Prend en charge: Claude Codex Code(CC)
Arrêtez-vous et demandez confirmation avant l’installation.
Examinez le plan et obtenez le consentement explicite de l’utilisateur avant de modifier des fichiers.
Installer avec mon Agent
Copiez cette demande dans votre Agent. Elle contient la page Skill de référence et le manifeste.
Demande d’agent
Review the Skillstore skill "Hook Development" from https://skillstore.io/skills/hook-development.md and its manifest at https://skillstore.io/api/skills/hook-development/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.Votre Agent doit toujours présenter son plan et demander toute confirmation exigée par la politique de sécurité.
Ressources lisibles par les agents
Utilisez ces liens lorsqu’un Agent IA, un crawler ou un script a besoin d’un contexte propre au lieu de lire toute la page.
Tester
Utilisation de « Hook Development ». L’utilisateur demande d’ajouter un hook qui bloque les écritures de fichiers non sûres.
Résultat attendu:
La skill renvoie une conception PreToolUse avec des choix de matchers, des critères de sécurité, des conseils de timeout et des étapes de test.
Utilisation de « Hook Development ». L’utilisateur partage un hook de validation Bash existant.
Résultat attendu:
La skill fournit un plan de migration qui sépare les vérifications shell rapides des décisions contextuelles basées sur des prompts.
Utilisation de « Hook Development ». L’utilisateur veut tester les hooks avant la publication.
Résultat attendu:
La skill suggère la validation de schéma, des entrées d’exemple, des vérifications en mode debug et une revue par linter avant le déploiement.
Audit de sécurité
Risque élevév10 • 19/07/2026 Ouvrir le rapport versionné
Most static alerts are false positives caused by Markdown formatting, shebangs, defensive deny checks, and test fixtures. Confirmed risks include shell injection in the test runner, unsafe jq filter construction, and predictable temporary files. Semantic review also found prompt-injection exposure, fail-open validators, SQL injection, sensitive logging, and unpinned package execution.
11
Fichiers analysés
2,781
Lignes analysées
21
Éléments à examiner
0
Faux positifs ignorés
Préoccupations de sécurité confirmées (6)
Élevé
Prompt-Based Authorization Is Injection-Prone
Security prompts interpolate untrusted tool commands and input directly into authorization instructions. Crafted tool input can instruct the model to ignore policy and approve a dangerous operation.
The examples directly place $TOOL_INPUT.command or $TOOL_INPUT inside prompts that return permission decisions, without isolation or injection-resistant handling.
Élevé
Command Validator Fails Open on Deny-List Bypasses
The Bash validator blocks a few literal substrings and approves every unmatched command. Equivalent destructive syntax, wrappers, aliases, and encoded commands can bypass the checks.
The code contains only three narrow checks and ends with unconditional approval, while the documented security goal is to block dangerous commands.
Élevé
Write Validator Does Not Resolve Effective Paths
The write validator checks raw path substrings but never canonicalizes paths or resolves symlinks. A permitted path can still target a protected or sensitive file.
The implementation compares the supplied string directly and then approves it; no realpath, directory boundary, or symlink check is present.
Élevé
Untrusted Hook Input Is Concatenated into SQL
The database logging example places raw hook input inside a quoted INSERT statement. A single quote in input can alter the SQL and execute unintended database operations.
The psql command constructs SQL by directly interpolating the complete stdin value, with no parameter binding or escaping.
Élevé
Audit Example Persists Raw Potentially Sensitive Input
The audit example appends complete hook input to a persistent home-directory log. Tool input can contain source code, prompts, credentials, or other sensitive values.
The example writes the full input value without redaction, filtering, retention controls, or explicit restrictive file permissions.
Moyen
Automatic Hook Runs an Unpinned Package Command
The quality hook invokes npx eslint automatically after file edits. Dependency resolution can execute untrusted project binaries or fetch package code outside a pinned toolchain.
The documented PostToolUse pattern runs npx from the active project without pinning the executable or requiring an installed trusted binary.
Éléments d’évaluation des capacités (21)
Il s’agit de capacités locales réelles qui peuvent être attendues pour cette compétence ; elles nécessitent donc un examen, mais ne sont pas comptabilisées comme comportement malveillant confirmé.
Élevé
Shell command substitution
output=$(timeout "$TIMEOUT" bash -c "cat '$TEST_INPUT' | $HOOK_SCRIPT" 2>&1)
The script inserts caller-controlled file paths into a bash -c command string. A crafted existing filename can break quoting and execute additional shell commands.
Moyen
Temp directory access
echo "$risk_level" > /tmp/hook-state-$$
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
Moyen
Temp directory access
risk_level=$(cat /tmp/hook-state-$$ 2>/dev/null || echo "unknown")
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
Moyen
Temp directory access
cache_file="/tmp/hook-cache-$cache_key"
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
Moyen
Temp directory access
echo "0" > /tmp/test-count-$$
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
Moyen
Temp directory access
echo "0" > /tmp/build-count-$$
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
Moyen
Temp directory access
count=$(cat /tmp/test-count-$$ 2>/dev/null || echo "0")
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
Moyen
Temp directory access
echo $((count + 1)) > /tmp/test-count-$$
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
Moyen
Temp directory access
test_count=$(cat /tmp/test-count-$$ 2>/dev/null || echo "0")
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
Moyen
Temp directory access
rate_file="/tmp/hook-rate-$$"
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
Moyen
Temp directory access
export CLAUDE_ENV_FILE="${CLAUDE_ENV_FILE:-/tmp/test-env-$$}"
The default environment file uses a predictable PID-based path in shared /tmp. A local attacker can race or precreate a symlink before the tested hook writes to it.
Moyen
Shell command substitution
for event in $(jq -r 'keys[]' "$HOOKS_FILE"); do
Event names from the supplied JSON are iterated through unquoted command substitution. Whitespace and glob characters can split or alter names, causing validation bypasses.
Moyen
Shell command substitution
for event in $(jq -r 'keys[]' "$HOOKS_FILE"); do
Event names from the supplied JSON are iterated through unquoted command substitution. Whitespace and glob characters can split or alter names, causing validation bypasses.
Moyen
Shell command substitution
hook_count=$(jq -r ".\"$event\" | length" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
Moyen
Shell command substitution
matcher=$(jq -r ".\"$event\"[$i].matcher // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
Moyen
Shell command substitution
hooks=$(jq -r ".\"$event\"[$i].hooks // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
Moyen
Shell command substitution
hook_array_count=$(jq -r ".\"$event\"[$i].hooks | length" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
Moyen
Shell command substitution
hook_type=$(jq -r ".\"$event\"[$i].hooks[$j].type // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
Moyen
Shell command substitution
command=$(jq -r ".\"$event\"[$i].hooks[$j].command // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
Moyen
Shell command substitution
prompt=$(jq -r ".\"$event\"[$i].hooks[$j].prompt // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
Moyen
Shell command substitution
timeout=$(jq -r ".\"$event\"[$i].hooks[$j].timeout // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
Facteurs de risque
⚙️ Commandes externes (50)
examples/load-context.sh:1 examples/validate-bash.sh:8 examples/validate-bash.sh:11 examples/validate-bash.sh:1 examples/validate-write.sh:8 examples/validate-write.sh:11 examples/validate-write.sh:1 references/advanced.md:36 references/advanced.md:37 references/advanced.md:63 references/advanced.md:81 references/advanced.md:92 references/advanced.md:93 references/advanced.md:96 references/advanced.md:105 references/advanced.md:125 references/advanced.md:174 references/advanced.md:175 references/advanced.md:176 references/advanced.md:181 references/advanced.md:244 references/advanced.md:245 references/advanced.md:248 references/advanced.md:250 references/advanced.md:251 references/advanced.md:259 references/advanced.md:273 references/advanced.md:274 references/advanced.md:291 references/advanced.md:304 references/advanced.md:305 references/advanced.md:319 references/advanced.md:320 references/advanced.md:324 references/advanced.md:327 references/advanced.md:328 references/advanced.md:335 references/advanced.md:353 references/advanced.md:354 references/advanced.md:355 references/advanced.md:367 references/advanced.md:368 references/advanced.md:388 references/advanced.md:396 references/advanced.md:414 references/advanced.md:462 references/advanced.md:470 references/advanced.md:35 references/advanced.md:55 references/advanced.md:74
📁 Accès au système de fichiers (45)
examples/validate-bash.sh:31 examples/validate-write.sh:26 references/advanced.md:358 references/advanced.md:358 references/advanced.md:105 references/advanced.md:181 references/advanced.md:250 references/advanced.md:259 references/advanced.md:281 references/advanced.md:295 references/advanced.md:97 references/advanced.md:105 references/advanced.md:177 references/advanced.md:237 references/advanced.md:238 references/advanced.md:250 references/advanced.md:251 references/advanced.md:259 references/advanced.md:323 references/advanced.md:413 references/advanced.md:419 references/migration.md:117 references/migration.md:165 references/patterns.md:268 references/patterns.md:306 scripts/README.md:86 scripts/README.md:89 scripts/test-hook.sh:155 scripts/test-hook.sh:227 scripts/test-hook.sh:34 scripts/test-hook.sh:35 scripts/test-hook.sh:40 scripts/test-hook.sh:50 scripts/test-hook.sh:51 scripts/test-hook.sh:63 scripts/test-hook.sh:64 scripts/test-hook.sh:75 scripts/test-hook.sh:76 scripts/test-hook.sh:87 scripts/test-hook.sh:88 scripts/test-hook.sh:171 scripts/test-hook.sh:173 scripts/validate-hook-schema.sh:32 SKILL.md:534 SKILL.md:550
🔑 Variables d’environnement (1)
🌐 Accès réseau (1)
Audité par: codex Voir l’historique des audits →
Partager et citer ce rapport
Partagez le rapport d’évaluation versionné, le badge neutre, la carte intégrable et les citations. Skillstore présente les preuves sans décider si ce Skill est sûr.
Copier le lien du rapport
https://skillstore.io/skills/hook-development/audits/10?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportBadge Markdown
[](https://skillstore.io/skills/hook-development?utm_source=security_passport_badge)Badge HTML
<a href="https://skillstore.io/skills/hook-development?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/hook-development/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Carte intégrable
<iframe src="https://skillstore.io/embed/skills/hook-development.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Citations académiques (APA · BibTeX · CFF)
Citation APA
anthropics. (2026). Hook Development security audit report (audit version 10) [Author version 0.1.0]. Skillstore. https://skillstore.io/skills/hook-development/audits/10Citation BibTeX
@techreport{anthropics-hook-development-2026,
author = {anthropics},
title = {Hook Development security audit report (audit version 10)},
institution = {Skillstore},
year = {2026},
number = {10},
url = {https://skillstore.io/skills/hook-development/audits/10},
note = {Author version 0.1.0}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "Hook Development security audit report (audit version 10)"
version: "0.1.0"
type: report
authors:
- name: "anthropics"
date-released: "2026-07-19"
url: "https://skillstore.io/skills/hook-development/audits/10"
identifiers:
- type: other
value: "skillstore:hook-development:audit:10"
description: "Skillstore immutable audit report identifier"
Comparer les variantes
3 variantes installablesChaque auteur reste un skill installable distinct. La variante recommandée est classée selon les preuves Skillstore.
Pourquoi cette variante est première
Utilisation Skillstore plus élevée
Auteur / source Score Skillstore Niveau de confiance des preuves Utilisation Skillstore Mis à jour
hook-development
Score Skillstore 38
Niveau de confiance des preuves Moyen
Utilisation Skillstore 25
Mis à jour
2026-09-09
anthropics-hook-development
Score Skillstore 38
Niveau de confiance des preuves Moyen
Utilisation Skillstore 23
Mis à jour
2026-10-24
davila7-hook-development
Score Skillstore 38
Niveau de confiance des preuves Moyen
Utilisation Skillstore 17
Mis à jour
2026-09-09
Score Skillstore
Pourquoi ce score Niveau de confiance des preuves: Moyen 68
Architecture
100
Maintenabilité
87
Contenu
71
Communauté
65
Conformité aux spécifications
Ce que vous pouvez créer
Ajouter des hooks de sécurité des fichiers
Créer des hooks PreToolUse qui examinent les chemins d’écriture, les fichiers sensibles et la traversée de chemins avant l’exécution des outils.
Imposer l’achèvement du workflow
Concevoir des hooks Stop qui vérifient les tests, les builds et les questions sans réponse avant qu’un agent termine son travail.
Migrer la logique de hooks
Déplacer les vérifications shell fragiles vers des hooks basés sur des prompts tout en conservant les vérifications déterministes rapides lorsqu’elles sont utiles.
Essayez ces prompts
Créer un hook de base
Créer un hook PreToolUse pour Write et Edit. Il doit bloquer les chemins système, les fichiers d’identifiants et la traversée de chemins.
Ajouter un contexte de session
Concevoir un hook SessionStart qui détecte mon type de projet. Stocker uniquement des valeurs d’environnement sûres pour les hooks ultérieurs.
Migrer des vérifications Bash
Examiner ce hook de commande existant. Recommander quelles vérifications doivent devenir basées sur des prompts et lesquelles doivent rester déterministes.
Planifier une suite de hooks
Concevoir une stratégie de hooks pour mon plugin. Inclure PreToolUse, PostToolUse, Stop, les étapes de test et les règles de journalisation sûre.
Bonnes pratiques
- Privilégier les hooks basés sur des prompts pour les décisions contextuelles et les hooks de commande pour les vérifications déterministes rapides.
- Valider et mettre entre guillemets toutes les entrées des hooks de commande avant d’utiliser des chemins, des commandes ou des valeurs d’environnement.
- Tester les hooks avec des entrées d’exemple, la validation de schéma, le mode debug et des cas d’échec avant le déploiement.
Éviter
- Faire confiance aux entrées brutes des outils sans validation ni échappement JSON.
- Journaliser des payloads complets de hooks vers des systèmes externes ou des fichiers d’audit persistants.
- Dépendre de l’ordre d’exécution des hooks ou s’attendre à ce que les sessions en cours rechargent les hooks modifiés.
Foire aux questions
Que m’aide à construire cette skill ?
Elle aide à créer des hooks Claude Code qui valident l’utilisation des outils, chargent du contexte, appliquent des politiques et testent le comportement des hooks.
Prend-elle en charge les hooks basés sur des prompts ?
Oui. Elle se concentre sur les hooks basés sur des prompts pour les workflows PreToolUse, Stop, SubagentStop et UserPromptSubmit.
Puis-je toujours utiliser des hooks de commande ?
Oui. La skill explique les hooks de commande pour les vérifications déterministes, les outils externes et la logique sensible aux performances.
Inclut-elle des exemples exécutables ?
Oui. Elle inclut des exemples de hooks shell et des scripts utilitaires, mais ils nécessitent une revue de sécurité locale avant une utilisation en production.
Les modifications de hooks s’appliqueront-elles immédiatement ?
Généralement non. Claude Code charge la configuration des hooks au démarrage de la session, les changements nécessitent donc normalement un redémarrage.
Est-ce uniquement pour Claude Code ?
Les concepts de hooks sont destinés aux plugins Claude Code. Les métadonnées du marketplace aident aussi les utilisateurs de Claude et Codex à la trouver.
Détails du développeur
Auteur
anthropicsLicence
MIT
Version de l’auteur
v0.1.0
Révision Skillstore
r1
Dépôt
https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev/skills/hook-developmentRéf
6e2dddf587274c5f8c929a916ca092529545819b
Récence de maintenance
26/07/2026
Utilisation
17 téléchargements · 259 vues
Structure de fichiers