What is the difference between BLOCK and SUGGEST enforcement?

BLOCK prevents a tool from executing until the skill is addressed (ideal for critical guardrails), while SUGGEST injects advisory context before a prompt is processed without stopping the workflow.

What is the 500-line rule in Claude Code skills?

It is a performance best practice requiring SKILL.md files to stay under 500 lines. Longer documentation should be split into reference files to maintain Claude's context window efficiency.

How do skill triggers work?

Triggers use keywords, intent patterns, file paths, or regex content detection to automatically activate relevant skills when a user prompt or file edit matches defined criteria.

Can I temporarily disable skill guardrails?

Yes, you can use the SKIP_SKILL_GUARDRAILS environment variable, session-based state management, or the // @skip-validation file marker for permanent exceptions.

Where are skill configurations stored?

All skill definitions, trigger logic, and enforcement levels are managed within the .claude/skills/skill-rules.json configuration file.

Claude Skill Developer Guide

Name: Claude Skill Developer Guide
Author: Microck

byMicrock

•

108

•

Developer Tools

Facilitates the creation and management of specialized Claude Code skills following Anthropic best practices for automation and guardrails.

This skill provides a comprehensive framework for developers to build, debug, and optimize custom Claude Code skills. It guides users through the two-hook architecture, covering proactive suggestions via UserPromptSubmit and gentle reminders or blocks via PreToolUse and Stop hooks. By enforcing the 500-line rule and progressive disclosure patterns, it ensures that domain-specific guidance remains performant and focused. Whether you are implementing critical guardrails to prevent database errors or domain-specific documentation for frontend frameworks, this tool standardizes the development lifecycle of AI-driven workflows.

Key Features

01Automated trigger pattern testing (Keywords, Intent, File Paths)

02Session tracking and skip-condition logic to prevent notification fatigue

03Comprehensive guide for skill-rules.json configuration

04108 GitHub stars

05Hook system implementation for UserPromptSubmit and PreToolUse

06Enforcement level management for Block, Suggest, and Warn states

Use Cases

01Debugging and refining skill activation triggers to reduce false positives in Claude Code.

02Architecting complex domain-specific skills with progressive disclosure and reference files.

03Developing custom organizational guardrails to prevent common coding mistakes.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add microck/ordinary-claude-skills skill-developer

For use in Claude.ai and ChatGPT

Download Skill