hello-world-skill

Create a Claude Code skill by writing a YAML-frontmatter file with metadata, organizing content into phases, and declaring allowed tools like Bash. This hello-world example demonstrates the minimal structure: frontmatter defining the skill name and description, phase-based workflow sections, and tool permissions—everything required to build your first functional skill.

A Claude Code skill uses YAML frontmatter to declare metadata (name, description, author) at the top, followed by content organized into logical phases. This example shows the exact format: three hyphens opening and closing the YAML block, key-value pairs for skill properties, and markdown phases below—the standard template all skills follow.

Skills declare permitted tools in the frontmatter's allowed-tools section, then invoke them within workflow phases. This hello-world skill demonstrates how to list Bash as an allowed tool and call it during execution—showing the permission model and invocation pattern that gate tool access and ensure controlled, intentional tool usage.

Start with a minimal example that covers all essential elements: YAML frontmatter metadata, phase-based workflow organization, and tool declarations. This tutorial skill demonstrates best practices for skill design and documentation in one complete, runnable example—reducing complexity so you grasp fundamentals before building advanced features.

No. This example is designed for beginners and requires only basic familiarity with YAML syntax and skill concepts. It teaches the minimal technical requirements—frontmatter format, phase structure, and tool permissions—through a guided introduction, making skill creation accessible even to developers new to Claude Code.

A skill executes its phases sequentially, performing the actions defined in each phase and returning results. This hello-world skill automates greeting output and explains the skill structure in order, demonstrating how phase-based workflows compose a complete skill execution—from initialization through final output.