skills.rest
sergigp
sergigpCOMMUNITY
Explore all skills by this author →
GitHub

skill-developer

Define and validate Claude Code skill auto-activation trigger rules.

1|Updated Oct 30, 2025
Search Tags:#Claude Skills#Configuration#Code Assistant#Skill Development#AI Automation#Best Practices#Troubleshooting
One-click install
npx skills add https://github.com/sergigp/claude-configs --skill skill-developer-sergigp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-developer
Source: https://github.com/sergigp/claude-configs/tree/main/skills/skill-developer
Command: npx skills add https://github.com/sergigp/claude-configs --skill skill-developer-sergigp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires npm, typescript, jq, and includes references (resource) components.

What problem does it solve?

This Skill solves the complexity of creating, managing, and troubleshooting custom Claude Code Skills. It provides comprehensive guidance on best practices, configuration, and debugging, ensuring your AI automation works reliably and efficiently.

Core Features & Use Cases

  • Skill Creation & Structure: Guides you through defining new skills, including YAML frontmatter, trigger types, and the 500-line rule for optimal performance.
  • Trigger Configuration: Explains how to set up promptTriggers (keywords, intent patterns) and fileTriggers (path, content patterns) for precise auto-activation.
  • Debugging & Troubleshooting: Offers detailed steps to diagnose and resolve issues like skills not triggering, false positives, or performance bottlenecks.
  • Use Case: When you need to create a new "Database Verification" guardrail skill, this guide walks you through defining its blocking behavior, setting up content patterns for Prisma queries, and testing its activation to prevent critical errors.

Quick Start

To create a new skill, ask Claude: "Help me create a new Claude skill for managing project documentation." To debug an existing skill, ask Claude: "My 'code-review-guidelines' skill is not suggesting, how do I troubleshoot its prompt triggers?"

Frequently Asked Questions about skill-developer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Claude Skill with trigger rules?▼

Creating a Claude Skill requires defining YAML frontmatter, configuring promptTriggers with keywords and intent patterns, and setting up fileTriggers with path and content regexes. The skill-developer Skill guides you through this structure, ensuring your skill stays within the 500-line performance threshold and conforms to guardrail policies.

What are promptTriggers and fileTriggers, and how do I set them up?▼

promptTriggers activate skills based on keywords and intent patterns in user input, while fileTriggers activate based on file paths and content patterns using regexes and globs. The skill-developer Skill explains how to configure both for precise auto-activation without false positives.

My Claude Skill isn't triggering or suggesting—how do I debug it?▼

Debugging involves checking your trigger rules in .claude/skills/skill-rules.json, validating content and path patterns, and testing activation flows. The skill-developer Skill provides structured troubleshooting steps to diagnose why skills fail to activate or produce unwanted suggestions.

Can I use block, suggest, and warn policies in my custom skill?▼

Yes. The skill-developer Skill supports configuring block/suggest/warn policies alongside your trigger rules. This allows you to enforce guardrail behavior—such as blocking dangerous operations or warning on risky patterns—based on your skill's domain and requirements.

How do I enforce best practices and prevent common Skill configuration errors?▼

The skill-developer Skill validates skills against best practices including proper YAML structure, trigger rule correctness, and performance constraints. It helps you avoid common pitfalls like overlapping triggers, missing content patterns, and skills exceeding the 500-line rule.

Related Skills

Explore More Software Engineering Skills→
twillcockstwillcocks

portal-setup

Initialize a Showpane workspace by installing dependencies and applying the SQLite Prisma schema.

Community
Advanced
ollieb89ollieb89

llm-evaluation

Evaluate LLM outputs with automated metrics and LLM-as-Judge workflows.

Community
Advanced
contentstackcontentstack
1

typescript

Standardize TypeScript tooling and project structure for datasync-content-store-filesystem.

Official
Intermediate
pradyumnasagarpradyumnasagar
6

roadmap-author

Guide authors through creating and validating ORS SKILL.md files.

Community
Intermediate