designing-workflow-skills

Design Claude Code skills with multi-step workflows, decision trees, and subagent delegation.

6.5k|561|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/trailofbits/skills --skill designing-workflow-skills-trailofbits
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: designing-workflow-skills
Source: https://github.com/trailofbits/skills/tree/main/plugins/workflow-skill-design/skills/designing-workflow-skills
Command: npx skills add https://github.com/trailofbits/skills --skill designing-workflow-skills-trailofbits

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and workflows (resource) components.

What problem does it solve?

This Skill helps you design and structure Claude Code skills with complex workflows, ensuring they are robust, maintainable, and scalable.

Core Features & Use Cases

  • Multi-Step Workflows: Guides the creation of skills with progressive disclosure, decision trees, and subagent delegation.
  • Phased Execution: Encourages structured phases with entry and exit criteria for reliable execution.
  • Pattern Selection: Provides guidelines for choosing the right pattern (Routing, Sequential Pipeline, Linear Progression, Safety Gate, Task-Driven) based on the skill's structure.
  • Quality Assurance: Offers a review checklist and anti-patterns guide to ensure the quality and effectiveness of the skill.
  • Use Case: Ideal for developers and security analysts looking to create or refactor Claude Code skills that involve complex workflows.

Quick Start

To design a new workflow-based skill, run the 'design-a-workflow-skill' workflow in the Claude Code platform.

Frequently Asked Questions about designing-workflow-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design multi-step workflows for Claude Code skills?

Design multi-step workflows for Claude Code skills by structuring execution into phases with entry and exit criteria, using progressive disclosure to manage context, and delegating tasks to subagents for reliable execution.

What is the best workflow pattern for structuring a complex Claude Code skill?

The best workflow pattern depends on task structure: choose from Routing, Sequential Pipeline, Linear Progression, Safety Gate, or Task-Driven patterns based on whether your Claude Code skill requires branching logic, ordered execution, or validation checks.

When should I use subagent delegation in Claude Code skill design?

Use subagent delegation in Claude Code skill design when workflows require structured execution across multiple domains, allowing the main agent to route specialized tasks to subagents while maintaining phased entry and exit criteria.

How do I add safety gates to a Claude Code security workflow?

Add safety gates to Claude Code security workflows by applying the Safety Gate pattern, which inserts validation checkpoints with defined entry and exit criteria into the execution pipeline to ensure reliable, structured task completion.

What are common anti-patterns when building Claude Code skill workflows?

Common anti-patterns when building Claude Code skill workflows include missing entry and exit criteria for phases, improper subagent delegation, and failing to apply progressive disclosure, all of which reduce execution reliability.

Do I need programming knowledge to create structured workflows in Claude Code?

Yes, creating structured workflows in Claude Code requires basic programming skills and knowledge of the Claude Code platform to properly implement decision trees, subagent delegation, and phased execution logic.