# agentic-workflow-guide

agentic-workflow-guide is a Claude Code skill that designs and debugs agent workflows, starting with the simplest primitive before multi-agent setups.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 114 installs · ★ 27 repo stars
- Author: yamapan (https://github.com/aktsmm)
- License: CC-BY-NC-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aktsmm/Agent-Skills/tree/HEAD/agentic-workflow-guide/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/agentic-workflow-guide

## What it does

This skill acts as an architectural advisor for AI workflows. Rather than jumping into multi-agent systems, it enforces a minimal primitive approach: solve issues with a prompt, scoped instruction, or a skill first. Full agents are reserved for explicit persona isolation, restricted tool scopes, or strict handoffs.

It embeds explicit triggers for decomposing complex processes. When a prompt runs over 50 lines, workflows cross five stages, context fills past 70%, or models repeatedly drop steps, the skill guides step-by-step splitting. Deterministic mutations are routed to scripts and hooks instead of costly model evaluation loops.

Overloading root configuration files ruins task execution early, so the guide actively enforces thin entry files and single-responsibility boundaries.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agentic-workflow-guide/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agentic-workflow-guide/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agentic-workflow-guide/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agentic-workflow-guide/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aktsmm/Agent-Skills agentic-workflow-guide
```

2. **Manually: put the files in place**
- File: `.github/skills/agentic-workflow-guide/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aktsmm/Agent-Skills --path agentic-workflow-guide
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agentic-workflow-guide/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/aktsmm/Agent-Skills/tree/HEAD/agentic-workflow-guide/SKILL.md

## When to use it
- select whether a task needs a prompt, instruction, skill, or agent
- restructure bloated `.agent.md` and `AGENTS.md` files
- debug context bottlenecks when steps get overlooked
- audit orchestrator handoffs and delegation patterns

## Example prompts
- Review my AGENTS.md file and check if I should split the current orchestrator
- I need a workflow to process receipts: should this be a skill, hook, or an agent?
- My prompt is 60 lines long and steps are getting missed, help me refactor it

## Similar
- [service-itsm-agentic-setup-configure](https://affpapa.org/en/nevibecode/skills/service-itsm-agentic-setup-configure.md) — skill · 1200 installs
- [service-itsm-agentic-setup-agentforce-coordinate](https://affpapa.org/en/nevibecode/skills/service-itsm-agentic-setup-agentforce-coordinate.md) — skill · 1200 installs
- [cargo-orchestration](https://affpapa.org/en/nevibecode/skills/cargo-orchestration.md) — skill · 11600 installs
- [building-tools](https://affpapa.org/en/nevibecode/skills/building-tools.md) — skill · 4000 installs
- [workflow-orchestrator](https://affpapa.org/en/nevibecode/skills/workflow-orchestrator.md) — skill · 843 installs
- [goal-plan](https://affpapa.org/en/nevibecode/skills/goal-plan.md) — skill · 771 installs

From the same set: [aktsmm/agent-skills](https://affpapa.org/en/nevibecode/by/aktsmm/agent-skills.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
