skills.rest
postfiatorg
postfiatorgOFFICIAL
Explore all skills by this author →
Website𝕏@postfiatorgGitHub

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
One-click install
npx skills add https://github.com/postfiatorg/langfuse --skill skill-developer-postfiatorg
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
Dev10x-GuruDev10x-Guru
7

Dev10x:skill-create

Scaffold local Claude skills with automated directory and frontmatter setup.

Official
Intermediate
jhouserjhouser

skill-developer

Enforces guardrails for Claude Code skill activation across two-hook architecture.

Community
Advanced
neo-picasso-2112neo-picasso-2112

skill-developer

Create and maintain Claude Code skills with YAML frontmatter and hook mechanics.

Community
Advanced
J03Fr0stJ03Fr0st

writing-prompts

Create reusable .prompt.md files defining custom slash commands for AI assistants.

Community
Basic