Agent skill
example-skill
This skill should be used when demonstrating skill structure and format. Provides example patterns for creating new skills.
Install this agent skill to your Project
npx add-skill https://github.com/89jobrien/steve/tree/main/steve/skills/example-skill
SKILL.md
Example Skill
A demonstration skill showing the proper structure and format for Claude Code skills.
When to Use This Skill
- Creating new skills and need a reference
- Understanding skill structure and best practices
- Learning how to bundle resources with skills
What This Skill Does
- Demonstrates proper YAML frontmatter format
- Shows content structure requirements
- Provides examples of bundled resources
- Illustrates best practices for skill documentation
Core Principles
Principle 1: Clear Purpose
Skills should have a clear, well-defined purpose. The "When to Use" section should make it obvious when to apply the skill.
Principle 2: Progressive Disclosure
Structure content from high-level overview to detailed implementation. Start with "When to Use" and "What This Skill Does" before diving into workflows.
Principle 3: Actionable Workflows
Provide step-by-step workflows that can be followed directly. Include examples and anti-patterns.
Workflow
Step 1: Identify Need
Determine if this skill is appropriate for the current task.
Step 2: Review Documentation
Read the skill documentation to understand capabilities and limitations.
Step 3: Apply Skill
Follow the workflow steps to apply the skill.
Step 4: Validate Results
Check that the skill achieved the intended outcome.
Best Practices
- Keep skills focused on a single domain or capability
- Include clear examples and use cases
- Document anti-patterns to avoid common mistakes
- Bundle resources when they add value
Anti-Patterns
- Creating overly broad skills that try to do everything
- Skipping the "When to Use" section
- Missing examples or use cases
- Not documenting bundled resources
Examples
Example 1: Basic Usage
Scenario: Creating a new skill for code review
Approach:
- Review this example skill structure
- Use the template from
steve/templates/AGENT_SKILL.template.md - Fill in domain-specific content
- Add bundled resources if needed
Reference Files
This skill includes reference files in references/:
structure-guide.md: Detailed structure guidelinesexamples.md: Additional examples
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
89jobrien/steve
python-scripting
Python scripting with uv and PEP 723 inline dependencies. Use when creating standalone Python scripts with automatic dependency management.
89jobrien/steve
tool-presets
Standardized tool set definitions for Claude Code agents ensuring consistent tool access across similar agent types
89jobrien/steve
file-organizer
Intelligently organizes your files and folders across your computer by understanding context, finding duplicates, suggesting better structures, and automating cleanup tasks. Reduces cognitive load and keeps your digital workspace tidy without manual effort.
89jobrien/steve
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
89jobrien/steve
database-optimization
SQL query optimization and database performance specialist. Use when optimizing slow queries, fixing N+1 problems, designing indexes, implementing caching, or improving database performance. Works with PostgreSQL, MySQL, and other databases.
89jobrien/steve
ai-code-cleanup
Remove AI-generated code slop from branches. Use after AI-assisted coding sessions to clean up defensive bloat, unnecessary comments, type casts, and style inconsistencies. Focuses on identifying and removing AI artifacts that degrade code quality.
Didn't find tool you were looking for?