| name | intermediate-skill |
| description | Demonstrates helper script integration with sequential execution |
Intermediate Skill Example
What I Do
I demonstrate how OpenCode skills integrate with helper scripts for sequential task execution.
Key Concept
Skills + Scripts = Workflows. While the SKILL.md file provides instructions to the AI assistant, helper scripts do the actual work with structured execution, console output, and step-by-step processing.
Structure
This skill contains two files:
skills/intermediate/
├── SKILL.md ← You are here! (instructions)
└── helper.sh ← Helper script (execution)
The pattern:
- SKILL.md tells the assistant how to use the helper script
- helper.sh contains the actual executable logic
- Assistant executes the script via the Bash tool
How to Use Me
Execute the helper script to see sequential execution with console output:
bash src/skill/opencode-mastery/examples/skills/intermediate/helper.sh
The script will:
- Display a header with execution info
- Execute 5 sequential steps
- Show step-by-step progress
- Display a completion message
What This Demonstrates
1. Helper Script Integration
Skills can reference external scripts for execution:
## How to Use Me
Execute the helper script:
```bash
bash path/to/helper.sh
```
The AI assistant reads this instruction and executes the script via the Bash tool.
### 2. Sequential Execution Pattern
The helper demonstrates ordered execution:
```bash
Step 1: Initializing...
Step 2: Processing data...
Step 3: Generating output...
Step 4: Validating results...
Step 5: Finalizing...
Each step completes before the next begins - sequential execution.
3. Console Output
Rich console feedback for visibility:
- Headers and separators
- Step numbers with timestamps
- Status indicators
- Final completion message
4. Script Structure
Reusable pattern for multi-step workflows:
- Header with title
- Sequential numbered steps
- Sleep delays for readability
- Success/failure indicators
Helper Script Pattern
The helper.sh follows this structure:
#!/bin/bash
echo "====================================="
echo " Sequential Execution Example"
echo "====================================="
for step in {1..5}; do
echo "Step $step: Executing task..."
echo " ✓ Completed"
done
echo "====================================="
echo " Execution Complete"
echo "====================================="
When to Use Helper Scripts
Use helper scripts when you need:
- ✅ Sequential execution - Multiple steps in order
- ✅ Console output - Rich feedback for the user
- ✅ Validation - Check conditions before proceeding
- ✅ Complex logic - More than simple bash commands
- ✅ Reusable patterns - Script used by multiple skills
Learning Objectives
After studying this intermediate example, you should understand:
- How to integrate helper scripts with skills
- The sequential execution pattern
- How to provide rich console output
- When to use scripts vs. inline bash commands
- Basic script structure for multi-step workflows
Next Steps
- Try the advanced example to see full workflow orchestration with config
- Read the workflow patterns guide to understand conditional execution
- Check the best practices guide for script organization patterns
Difficulty: ⭐⭐ (Beginner to intermediate)
Complexity: Low (2 files: SKILL.md + helper.sh)
Learning Curve: Gentle - adds helper script concept
Use Case: Multi-step tasks, console output, sequential processing