المهارات building-hooks
�
building-hooks
آمن ⚙️
الأوامر الخارجية📁
الوصول إلى نظام الملفات🌐
الوصول إلى الشبكة
Create event hooks for Claude Code automation
Claude Code hooks enable event-driven automation and policy enforcement. This skill provides expertise in creating hooks that validate tool usage, enforce security policies, and automate workflows triggered by user prompts and tool invocations.
يدعم: Claude Code(CC)
1
تنزيل ZIP المهارة
2
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
3
فعّل وابدأ الاستخدام
اختبرها
استخدام "building-hooks". Create a hook that blocks rm -rf commands before they execute
النتيجة المتوقعة:
- Created hooks.json with PreToolUse event targeting Bash tool
- Validation script blocks destructive commands using grep pattern
- Returns decision: block with reason explaining the restriction
- Exit code 2 ensures the tool is blocked from execution
استخدام "building-hooks". Set up auto-formatting for Python files when I write them
النتيجة المتوقعة:
- Configured PostToolUse hook with matcher: Write
- Created format-script.sh that runs black on *.py files
- Hook returns approve decision with reason after formatting
- User must run chmod +x on the script to enable it
التدقيق الأمني
آمنv5 • 1/16/2026
This is a documentation and guidance skill for creating Claude Code event hooks. All 339 static findings are FALSE POSITIVES. The flagged patterns are: (1) documentation code blocks in markdown showing example commands, (2) defensive security validation code that BLOCKS dangerous commands, and (3) legitimate validation scripts for JSON schema checking. No actual dangerous commands are executed by this skill. The skill actively promotes security best practices including input validation and command blocking.
7
الملفات التي تم فحصها
2,124
الأسطر التي تم تحليلها
3
النتائج
5
إجمالي عمليات التدقيق
عوامل الخطر
⚙️ الأوامر الخارجية (258)
references/hook-checklist.md:10-22 references/hook-checklist.md:22-28 references/hook-checklist.md:28-32 references/hook-checklist.md:32-33 references/hook-checklist.md:33-34 references/hook-checklist.md:34-37 references/hook-checklist.md:37-38 references/hook-checklist.md:38-39 references/hook-checklist.md:39 references/hook-checklist.md:39 references/hook-checklist.md:39 references/hook-checklist.md:39-44 references/hook-checklist.md:44-47 references/hook-checklist.md:47-50 references/hook-checklist.md:50-51 references/hook-checklist.md:51 references/hook-checklist.md:51-52 references/hook-checklist.md:52-60 references/hook-checklist.md:60-62 references/hook-checklist.md:62-64 references/hook-checklist.md:64-65 references/hook-checklist.md:65-81 references/hook-checklist.md:81-82 references/hook-checklist.md:82-84 references/hook-checklist.md:84-87 references/hook-checklist.md:87-105 references/hook-checklist.md:105-107 references/hook-checklist.md:107-108 references/hook-checklist.md:108-109 references/hook-checklist.md:109-112 references/hook-checklist.md:112-137 references/hook-checklist.md:137-141 references/hook-checklist.md:141-145 references/hook-checklist.md:145-169 references/hook-checklist.md:169-187 references/hook-checklist.md:187-194 references/hook-checklist.md:194-224 references/hook-checklist.md:224-225 references/hook-checklist.md:225-235 references/hook-checklist.md:235-239 references/hook-checklist.md:239-251 references/hook-checklist.md:251-252 references/hook-checklist.md:252-253 references/hook-checklist.md:253-254 references/hook-checklist.md:254-255 references/hook-checklist.md:255-256 references/hook-checklist.md:256-257 references/hook-checklist.md:257 references/hook-checklist.md:257-262 references/hook-checklist.md:262-264 references/hook-checklist.md:264-275 references/hook-checklist.md:39 references/hook-checklist.md:149 references/hook-checklist.md:160 references/hook-checklist.md:39 references/hook-checklist.md:145-169 references/hook-checklist.md:146 references/hook-maintenance-guide.md:9-20 references/hook-maintenance-guide.md:20-23 references/hook-maintenance-guide.md:23-32 references/hook-maintenance-guide.md:32-35 references/hook-maintenance-guide.md:35-45 references/hook-maintenance-guide.md:45-54 references/hook-maintenance-guide.md:54-56 references/hook-maintenance-guide.md:56-63 references/hook-maintenance-guide.md:63-65 references/hook-maintenance-guide.md:65-81 references/hook-maintenance-guide.md:81-87 references/hook-maintenance-guide.md:87-101 references/hook-maintenance-guide.md:101-107 references/hook-maintenance-guide.md:107-114 references/hook-maintenance-guide.md:114-119 references/hook-maintenance-guide.md:119-129 references/hook-maintenance-guide.md:129-131 references/hook-maintenance-guide.md:131-134 references/hook-maintenance-guide.md:134-138 references/hook-maintenance-guide.md:138-141 references/hook-maintenance-guide.md:141-144 references/hook-maintenance-guide.md:144-152 references/hook-maintenance-guide.md:152-154 references/hook-maintenance-guide.md:154-157 references/hook-maintenance-guide.md:157-162 references/hook-maintenance-guide.md:162-165 references/hook-maintenance-guide.md:165-168 references/hook-maintenance-guide.md:168-176 references/hook-maintenance-guide.md:176-178 references/hook-maintenance-guide.md:178-181 references/hook-maintenance-guide.md:181-183 references/hook-maintenance-guide.md:183-186 references/hook-maintenance-guide.md:186-189 references/hook-maintenance-guide.md:189-192 references/hook-maintenance-guide.md:192-194 references/hook-maintenance-guide.md:194-197 references/hook-maintenance-guide.md:197-199 references/hook-maintenance-guide.md:199-207 references/hook-maintenance-guide.md:207-210 references/hook-maintenance-guide.md:210-213 references/hook-maintenance-guide.md:213-215 references/hook-maintenance-guide.md:215-218 references/hook-maintenance-guide.md:218-221 references/hook-maintenance-guide.md:221-224 references/hook-maintenance-guide.md:224-227 references/hook-maintenance-guide.md:227-235 references/hook-maintenance-guide.md:235-242 references/hook-maintenance-guide.md:242-243 references/hook-maintenance-guide.md:243-250 references/hook-maintenance-guide.md:250-260 references/hook-maintenance-guide.md:260-263 references/hook-maintenance-guide.md:263-271 references/hook-maintenance-guide.md:271-274 references/hook-maintenance-guide.md:274-287 references/hook-maintenance-guide.md:287-292 references/hook-maintenance-guide.md:292-304 references/hook-maintenance-guide.md:304-307 references/hook-maintenance-guide.md:307-319 references/hook-maintenance-guide.md:319-325 references/hook-maintenance-guide.md:325 references/hook-maintenance-guide.md:325-326 references/hook-maintenance-guide.md:326 references/hook-maintenance-guide.md:326-365 references/hook-maintenance-guide.md:365-381 references/hook-maintenance-guide.md:381-384 references/hook-maintenance-guide.md:384-395 references/hook-maintenance-guide.md:395-400 references/hook-maintenance-guide.md:400-406 references/hook-maintenance-guide.md:406-409 references/hook-maintenance-guide.md:409-415 references/hook-maintenance-guide.md:415-418 references/hook-maintenance-guide.md:418-425 references/hook-maintenance-guide.md:425-428 references/hook-maintenance-guide.md:428-431 references/hook-maintenance-guide.md:431-437 references/hook-maintenance-guide.md:437-438 references/hook-maintenance-guide.md:438-445 references/hook-maintenance-guide.md:445-446 references/hook-maintenance-guide.md:446-447 references/hook-maintenance-guide.md:447-448 references/hook-maintenance-guide.md:372 references/hook-maintenance-guide.md:365-381 references/hook-maintenance-guide.md:366 SKILL.md:32 SKILL.md:33 SKILL.md:34 SKILL.md:35 SKILL.md:42-58 SKILL.md:58-65 SKILL.md:65-76 SKILL.md:76-79 SKILL.md:79-90 SKILL.md:90-95 SKILL.md:95-105 SKILL.md:105-108 SKILL.md:108-118 SKILL.md:118-121 SKILL.md:121-131 SKILL.md:131-140 SKILL.md:140 SKILL.md:140-144 SKILL.md:144-145 SKILL.md:145-146 SKILL.md:146-147 SKILL.md:147-148 SKILL.md:148-149 SKILL.md:149-157 SKILL.md:157-162 SKILL.md:162-174 SKILL.md:174-179 SKILL.md:179-190 SKILL.md:190-203 SKILL.md:203-207 SKILL.md:207 SKILL.md:207 SKILL.md:207-208 SKILL.md:208 SKILL.md:208 SKILL.md:208 SKILL.md:208-209 SKILL.md:209-210 SKILL.md:210-211 SKILL.md:211-212 SKILL.md:212-213 SKILL.md:213-217 SKILL.md:217-218 SKILL.md:218-227 SKILL.md:227-243 SKILL.md:243-246 SKILL.md:246-259 SKILL.md:259-265 SKILL.md:265-281 SKILL.md:281-284 SKILL.md:284-295 SKILL.md:295-301 SKILL.md:301-317 SKILL.md:317-323 SKILL.md:323-339 SKILL.md:339-342 SKILL.md:342-354 SKILL.md:354-360 SKILL.md:360-375 SKILL.md:375-378 SKILL.md:378-384 SKILL.md:384-410 SKILL.md:410-426 SKILL.md:426-436 SKILL.md:436-451 SKILL.md:451-453 SKILL.md:453-468 SKILL.md:468-475 SKILL.md:475-484 SKILL.md:484-485 SKILL.md:485-489 SKILL.md:489-498 SKILL.md:498-512 SKILL.md:512-516 SKILL.md:516-533 SKILL.md:533-549 SKILL.md:549-551 SKILL.md:551-554 SKILL.md:554-558 SKILL.md:558-578 SKILL.md:578-579 SKILL.md:579-580 SKILL.md:580-581 SKILL.md:581-586 SKILL.md:586-613 SKILL.md:613-616 SKILL.md:616-632 SKILL.md:632-635 SKILL.md:635-647 SKILL.md:647-678 SKILL.md:678-686 SKILL.md:686-689 SKILL.md:689-692 SKILL.md:692-695 SKILL.md:695-698 SKILL.md:698-701 SKILL.md:701-702 SKILL.md:702 SKILL.md:702 SKILL.md:702-725 SKILL.md:725-733 SKILL.md:733-742 SKILL.md:742-748 SKILL.md:748-754 SKILL.md:754-758 SKILL.md:758 SKILL.md:381 SKILL.md:378-384 SKILL.md:247 SKILL.md:285 SKILL.md:343 SKILL.md:379 SKILL.md:499 SKILL.md:517 SKILL.md:617 SKILL.md:636 SKILL.md:734 templates/validation-hook.sh:1
📁 الوصول إلى نظام الملفات (8)
🌐 الوصول إلى الشبكة (1)
تم تدقيقه بواسطة: claude عرض سجل التدقيق →
درجة الجودة
64
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
21
المجتمع
100
الأمان
91
الامتثال للمواصفات
ماذا يمكنك بناءه
Automate security validation
Create PreToolUse hooks that validate bash commands before execution, blocking dangerous operations.
Build event-driven plugins
Design hooks that trigger formatting, logging, or cleanup actions after Write or Edit operations.
Enforce coding policies
Implement hooks that audit all tool usage, log actions, and block non-compliant operations.
جرّب هذه الموجهات
Basic hook creation
Create a PreToolUse hook that validates Bash tool commands before execution. The hook should block dangerous commands like rm -rf /, dd if=, and mkfs commands. Return JSON with decision field.
Auto-formatting workflow
Create a PostToolUse hook that auto-formats Python files with black and JavaScript files with prettier after Write operations. Include file extension checking.
Protected directories
Create a hook configuration that protects /etc, /usr, /boot, and /sys directories from Write and Edit operations. Block any file modifications in these paths.
Audit logging hook
Design a PostToolUse hook with matcher: * that logs all tool invocations. Capture tool name, parameters, and timestamp in structured JSON.
أفضل الممارسات
- Always validate hook scripts with validate-hooks.py before deployment
- Use specific matchers like Write|Edit instead of wildcards when possible
- Implement input sanitization with regex validation before using parameters
- Test hooks by triggering the expected events before production use
تجنب
- Using eval or command substitution without input validation
- Creating hooks with overly broad matchers like * that catch all tools
- Blocking operations without providing helpful system messages to users
- Forgetting to make hook scripts executable with chmod +x
الأسئلة المتكررة
What events can I create hooks for?
PreToolUse, PostToolUse, UserPromptSubmit, Stop, SessionStart, SessionEnd, Notification, SubagentStop, and PreCompact.
Where do I place hooks.json files?
Project-level: .claude/hooks.json, Plugin-level: plugin-dir/hooks/hooks.json, or Directory-specific: .claude-hooks.json.
Can hooks damage my system?
Hooks only run scripts you explicitly configure. Always validate inputs and test hooks in safe environment before deployment.
How do hooks differ from commands?
Commands run when user invokes them. Hooks run automatically when specific events occur without user triggering.
What exit codes do hooks use?
Exit 0 approves operation and shows stdout. Exit 2 blocks operation and sends stderr to Claude. Other codes trigger warnings.
How do I debug hook issues?
Run validate-hooks.py for schema errors. Check script paths and permissions. Verify matcher patterns match expected tool names.