example-workflow

obra's avatarfrom obra

Use when demonstrating plugin workflow features - shows how skills can guide multi-step processes

⭐47stars🔀10forks📁View on GitHub🕐Updated Dec 3, 2025

When & Why to Use This Skill

This Claude skill serves as a foundational reference implementation for developers to build and manage complex, multi-step agentic workflows. It solves the challenge of unpredictable AI behavior by providing a structured framework for requirement gathering, planning, execution, and verification, ensuring Claude follows a systematic process for sophisticated tasks.

Use Cases

  • 1. Developer Onboarding and Education: Use as a best-practice template for learning how to structure YAML frontmatter, document skill triggers, and define clear workflow stages for new Claude plugins.
  • 2. Complex Task Orchestration: Apply the 'Plan-then-Execute' pattern to design agents that handle intricate projects requiring sequential logic, such as software refactoring or multi-source data synthesis.
  • 3. Integration Prototyping: Demonstrate how to effectively link agent skills with external components like MCP servers, local scripts, and bundled documentation for a cohesive tool ecosystem.
nameexample-workflow
descriptionUse when demonstrating plugin workflow features - shows how skills can guide multi-step processes

Example Workflow Skill

Overview

This skill demonstrates how to create a workflow-based skill that guides Claude through a multi-step process. It serves as a reference implementation for plugin developers.

When to Use

This is an example skill for learning purposes. In a real plugin, you would:

  • Use when specific conditions match the skill's domain
  • Provide clear triggering criteria
  • Guide through complex multi-step workflows

Example Workflow

When invoked, this skill would guide through these steps:

  1. Gather requirements - Ask clarifying questions
  2. Plan approach - Create a structured plan using TodoWrite
  3. Execute systematically - Follow the plan step-by-step
  4. Verify results - Confirm the outcome matches requirements

Integration with Other Components

This skill demonstrates how skills can:

  • Reference bundled documentation in references/
  • Call executable scripts in scripts/
  • Use MCP server tools provided by the plugin
  • Trigger or respond to plugin hooks

For Plugin Developers

Key points this example demonstrates:

  • Clear YAML frontmatter with name and description
  • Structured workflow with numbered steps
  • Integration points with other plugin components
  • Documentation of when/how to use the skill