hello-world-skill
A minimal example skill demonstrating Claude Code skill structure
When & Why to Use This Skill
This Claude skill serves as a foundational boilerplate and educational resource for developers learning to build custom Claude Code skills. It provides a clear, minimal example of the SKILL.md structure, demonstrating how to configure YAML frontmatter, declare tool permissions (such as Bash), and organize agentic workflows into logical phases for optimal performance.
Use Cases
- Developer Onboarding: Use this as a first-step tutorial to understand the mandatory file structure and metadata requirements for Claude Code skills.
- Template Scaffolding: Serve as a clean, minimal starting point for developers to copy and modify when building more complex, production-ready agentic skills.
- Best Practices Reference: Learn how to document core responsibilities and multi-phase workflows to ensure AI agents follow consistent and predictable execution patterns.
- Tool Integration Testing: Understand the syntax for declaring 'allowed-tools' and how to invoke system-level commands like Bash within a skill's context.
| name | hello-world-skill |
|---|---|
| description | A minimal example skill demonstrating Claude Code skill structure |
| version | 1.0.0 |
| author | Claude Code Team |
| tags | [example, tutorial, beginner] |
Hello World Skill: A Minimal Example
You are demonstrating how Claude Code skills work through this simple example skill.
Core Responsibilities
- Greet User: Provide a friendly welcome message
- Explain Structure: Show what makes up a skill
- Educate: Help users understand skill components
Workflow
When a user invokes this skill:
Phase 1: Greeting
- Welcome the user warmly
- Introduce this skill's purpose
- Set expectations for what they'll learn
Phase 2: Explanation
- Explain the SKILL.md structure
- Describe the YAML frontmatter
- Show how content is organized
- Demonstrate tool usage (Bash in this case)
Phase 3: Demonstration
- Use the Bash tool to show system information
- Display the output in a friendly format
- Explain what just happened
Best Practices
This example demonstrates:
- Clear Structure: Organized into logical sections
- YAML Frontmatter: Proper metadata format
- Tool Declaration: Explicitly listing allowed tools
- Workflow Pattern: Phase-based organization
- Documentation: Comments and explanations
Example Invocation
User: "Use the hello-world-skill"
Response:
👋 Hello! I'm the hello-world-skill, a minimal example demonstrating Claude Code skill structure.
I'm here to show you how skills work:
1. **SKILL.md File**: Every skill has a SKILL.md file
- YAML frontmatter (between ---) defines metadata
- Content below provides instructions for Claude
2. **YAML Frontmatter**: Contains key information
- name: Unique identifier (kebab-case)
- description: One-line summary
- version: Semantic version (X.Y.Z)
- tags: Categorization keywords
- allowed-tools: Tools this skill can use
3. **Skill Content**: Instructions for Claude
- Core Responsibilities: What the skill does
- Workflow: Step-by-step process
- Best Practices: Guidelines for execution
- Examples: Usage demonstrations
Let me demonstrate using the Bash tool I have access to:
[Runs: date]
Current time: [output]
That's the hello-world-skill! It's intentionally simple to show the basic structure.
Real skills are more sophisticated but follow the same pattern.
Tool Usage
This skill demonstrates Bash tool usage:
Bashallows running system commands- Used here to show current date/time
- Real skills use tools for their specific purposes
Notes
- This is a learning example, not a production skill
- Real skills would have more complex logic
- The pattern scales from simple to sophisticated
- Start simple, add complexity as needed
What Makes This Skill Work
- Valid YAML frontmatter: Properly formatted metadata
- Clear instructions: Specific guidance for Claude
- Tool permissions: Explicit allowed-tools list
- Organized structure: Logical sections and flow
Learning Points
From this example, you can learn:
- How to structure YAML frontmatter
- What sections to include in skill content
- How to declare tool permissions
- How to organize workflows
- Best practices for documentation
To create your own skill:
- Use the skill-builder to scaffold the structure
- Customize the template for your purpose
- Test with realistic scenarios
- Refine based on results
Remember: This hello-world-skill is intentionally minimal. Your skills can be much more sophisticated while following this same basic pattern!