All skills
aktsmm avatar

/agentic-workflow-guide

@fb34748
by yamapanaktsmm/agent-skills26 stars
4

Design, review, and debug agent workflows, and decide when a request should use a prompt, instruction, skill, agent, or hook before escalating to multi-agent design. Use for .agent.md / .instructions.md / .prompt.md / AGENTS.md work, workflow architecture, orchestration planning, scheduled automation model allocation, or when agent workflows may be overkill. Triggers on 'agent workflow', 'create agent', 'automation models', 'ワークフロー設計', 'orchestrator'.

Use this Skill: https://skilld.dev/gh/aktsmm/agent-skills/agentic-workflow-guide

This session only. Nothing lands on disk.

referencesworkflow-patterns2-routing.md

≈612 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Pattern 2: Routing

Classify input → Route to specialized handlers

Back to overview.md

Diagram

graph TD
    A[Input] --> B{Router}
    B -->|Type A| C[Handler A]
    B -->|Type B| D[Handler B]
    B -->|Type C| E[Handler C]
    B -->|Unclassified| F[Default Handler]
    C --> G[Output]
    D --> G
    E --> G
    F --> G

Characteristics

Aspect Description
Structure Classifier + specialized handlers
Benefits Each handler can be optimized
Use Cases Customer support, inquiry classification

When to Use

  • Input has clear categories
  • Different processing is optimal per category
  • Classification accuracy is sufficiently high

Implementation Example

Router: Determine inquiry type
├─ Technical question → Technical Support Agent
├─ Billing related → Billing Support Agent
├─ General question → FAQ Agent
└─ Unclassified → Default Handler

Default Handler (Fallback Route)

Handle inputs that don't match any defined category:

graph TD
    A[Input] --> B{Router}
    B -->|Confidence > 80%| C[Specialized Handler]
    B -->|Confidence < 80%| D[Default Handler]
    D --> E{Can Help?}
    E -->|Yes| F[Direct Response]
    E -->|No| G[Escalate / Clarify]

When to Route to Default:

Condition Action
Low classification confidence Route to Default Handler
Unknown category Route to Default Handler
Ambiguous input Ask clarifying question
Out of scope Politely decline or escalate

Implementation Example:

---
name: Support Router
tools: ["agent"]
---

# Support Router

## Routing Rules

1. Technical keywords detected → Tech Support Agent
2. Billing/payment keywords → Billing Agent
3. FAQ match found → FAQ Agent
4. **Otherwise → Default Handler**

## Default Handler Behavior

- Attempt general assistance first
- If unable to help: "I'll connect you with a specialist"
- Log unclassified inputs for future category expansion

⚠️ Important: Default Handler should log unclassified inputs. Frequent patterns may indicate a missing specialized handler.

Source: SKILL.md on GitHub

2 warnings4mo4 checks · Risk SAFE
  • Gen Agent Trust Hub4mo

    This skill is a professional development toolkit for designing, reviewing, and managing AI agent workflows. It provides structured templates, architectural guidance, and utility scripts to help users build efficient multi-agent systems following best practices like Single Responsibility and Single Source of Truth.

  • Socket4mo

    No alerts

  • Snyk4mo

    Risk: MEDIUM · 1 issue

  • Runlayer7mo

    15/58 files flagged

Signed by skilld at fb34748. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 15 hours ago.

Activeupdated last week
user-invocable
true
metadata
{
  "author": "yamapan (https://github.com/aktsmm)"
}
Other metadata
argument-hint
作りたい .agent.md / .instructions.md / .prompt.md / AGENTS.md、設計したい workflow、または困っている症状

README badge

README badge for aktsmm/agent-skills/agentic-workflow-guide