# Intermediate Skill

> Demonstrates helper script integration with sequential execution

- Skill: `digi4care/intermediate-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add digi4care/intermediate-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/digi4care/intermediate-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: digi4care (https://skillmd.com/u/digi4care)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/digi4care/intermediate-skill

---


# 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:

1. **SKILL.md** tells the assistant how to use the helper script
2. **helper.sh** contains the actual executable logic
3. **Assistant** executes the script via the Bash tool

## How to Use Me

Execute the helper script to see sequential execution with console output:

```bash
bash src/skill/opencode-mastery/examples/skills/intermediate/helper.sh
```

The script will:

1. Display a header with execution info
2. Execute 5 sequential steps
3. Show step-by-step progress
4. Display a completion message

## What This Demonstrates

### 1. Helper Script Integration

Skills can reference external scripts for execution:

````markdown
## 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:

```bash
#!/bin/bash

# Header
echo "====================================="
echo "  Sequential Execution Example"
echo "====================================="

# Steps (sequential execution)
for step in {1..5}; do
  echo "Step $step: Executing task..."
  # ... do work ...
  echo "  ✓ Completed"
done

# Footer
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:

1. How to integrate helper scripts with skills
2. The sequential execution pattern
3. How to provide rich console output
4. When to use scripts vs. inline bash commands
5. 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