skill-developer

Create Claude Code skills with Anthropic best practices and validation workflows.

1|Updated Feb 10, 2026

Search Tags:#testing #documentation #skill-development #claude-code #frontmatter #skill-rules.json #two-hook

Ready to run

npx skills add https://github.com/postfiatorg/langfuse --skill skill-developer-postfiatorg

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-developer
Source: https://github.com/postfiatorg/langfuse/tree/main/.claude/skills/skill-developer
Command: npx skills add https://github.com/postfiatorg/langfuse --skill skill-developer-postfiatorg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide provides a comprehensive framework for creating and managing Claude Code skills, ensuring practitioners follow Anthropic's best practices, keep SKILL.md under 500 lines, and maintain a clear, scalable activation system.

Core Features & Use Cases

Two-Hook Architecture: guidance on UserPromptSubmit and PreToolUse hooks, progressive disclosure, and session-aware guardrails to prevent common mistakes while enabling proactive skills suggestions.
Skill Rules Management: instructions for the central skill-rules.json configuration, frontmatter structure, and testing workflows to ensure consistent activation behavior.
Documentation Hygiene: templates and reference files to keep skills maintainable, debuggable, and compliant with the 500-line rule.

Quick Start

Create a new skill in .claude/skills/{name}/SKILL.md with frontmatter and content, then add it to skill-rules.json and test triggers before refining patterns.

Frequently Asked Questions about skill-developer

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

FAQPage Schema

What is the two-hook architecture for Claude Code skill development?▼

The two-hook architecture uses UserPromptSubmit and PreToolUse hooks to enable progressive disclosure and session-aware guardrails, preventing common mistakes while proactively suggesting skills during Claude Code skill development.

How do I create a Claude Code skill and add it to skill-rules.json?▼

To create a Claude Code skill, define a SKILL.md file with frontmatter in .claude/skills/{name}/, then register its trigger definitions in the central skill-rules.json configuration file and test activation workflows before deployment.

How does progressive disclosure work when building Claude Code skills?▼

Progressive disclosure in Claude Code skills works by using the UserPromptSubmit and PreToolUse hooks to load context and apply skip logic dynamically, ensuring safe, scalable automation without overwhelming the session.

Does the 500-line rule apply to SKILL.md documentation for Claude Code skills?▼

Yes, the 500-line rule requires SKILL.md documentation to stay under 500 lines. Documentation hygiene templates and reference files help maintain compliance while keeping Claude Code skills debuggable and maintainable.

What is the best way to test trigger definitions and skip logic for Claude Code skills?▼

The best way to test Claude Code skill triggers is to use the provided testing workflows and validation routines to verify frontmatter structure, skip logic, and activation behavior within the skill-rules.json configuration.

When should I use PreToolUse hooks in Claude Code skill development?▼

PreToolUse hooks should be used during Claude Code skill development to enforce session-aware guardrails and skip logic before tool execution, preventing common mistakes and ensuring safe automated operations.