agentic-workflow-guide — Claude Code skill: setup and usage
agentic-workflow-guide is a Claude Code skill that designs and debugs agent workflows, starting with the simplest primitive before multi-agent setups.
CC-BY-NC-SA-4.0 114 installs ★ 27 updated 2026-10-23
npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a claude-codeWhat agentic-workflow-guide 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.
What it helps with
- select whether a task needs a prompt, instruction, skill, or agent
- restructure bloated
.agent.mdandAGENTS.mdfiles - debug context bottlenecks when steps get overlooked
- audit orchestrator handoffs and delegation patterns
Example prompts for the agent
- 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
How to install agentic-workflow-guide
1Skills CLI (Vercel)
npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a claude-code2Manually: put the files in place
~/.claude/skills/agentic-workflow-guide/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agentic-workflow-guide/
1Skills CLI (Vercel)
npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a codex2Manually: put the files in place
.agents/skills/agentic-workflow-guide/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a cursor2Manually: put the files in place
.cursor/skills/agentic-workflow-guide/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aktsmm/Agent-Skills agentic-workflow-guide2Manually: put the files in place
.github/skills/agentic-workflow-guide/SKILL.md1Skills CLI (Vercel)
npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a gemini-cli2Platform CLI
gemini skills install https://github.com/aktsmm/Agent-Skills --path agentic-workflow-guideManually: put the files in place
.devin/skills/agentic-workflow-guide/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about agentic-workflow-guide
How to install agentic-workflow-guide in Claude Code?
Run npx skills add aktsmm/Agent-Skills --skill agentic-workflow-guide -a claude-code in your terminal.
What does agentic-workflow-guide do?
It reviews agent setups, audits instructions, and prevents unnecessary multi-agent sprawl by prioritizing simpler primitives.
When does the guide recommend splitting an agent?
It suggests splitting when instructions exceed 50 lines, workflows require more than five steps, context usage crosses 70%, or tasks show recurring oversight errors.