aktsmm/agentic-workflow-guide
agentic-workflow-guide/SKILL.md
Create, review, and update Prompt and agents and workflows. Covers 5 workflow patterns, agent delegation, Handoffs, Context Engineering. Use for any .agent.md file work or multi-agent system design. Triggers on 'agent workflow', 'create agent', 'ワークフロー設計'.
$ install --global
skillsauthnpx skillsauth add aktsmm/agent-skills agentic-workflow-guideInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 10, 2026, 3:09 AM10.5s58 files scanned
SKILL.md
- name:
- agentic-workflow-guide
- description:
- Create, review, and update Prompt and agents and workflows. Covers 5 workflow patterns, agent delegation, Handoffs, Context Engineering. Use for any .agent.md file work or multi-agent system design. Triggers on 'agent workflow', 'create agent', 'ワークフロー設計'.
- license:
- CC BY-NC-SA 4.0
- author:
- yamapan (https://github.com/aktsmm)
Agentic Workflow Guide
Design, review, and improve agent workflows based on proven principles.
When to Use
| Action | Triggers |
| ---------- | ---------------------------------------------------------------------------- |
| Create | New .agent.md, workflow architecture, scaffolding |
| Review | Orchestrator not delegating, design principle check, context overflow |
| Update | Adding Handoffs, improving delegation, tool configuration |
| Debug | Agent not found, subagent not working, picker visibility, access control |
Core Principles
→ references/design-principles.md
| Tier | Principles | | ------------- | ------------------------------------------------------- | | Essential | SSOT, SRP, Simplicity First, Fail Fast, Feedback Loop | | Quality | Transparency, Gate/Checkpoint, DRY, Observability | | Scale | Human-in-the-Loop, Loose Coupling, Graceful Degradation |
See design-principles.md > Simplicity First for Anthropic's key recommendation.
Workflow Patterns
→ references/workflow-patterns/overview.md
| Pattern | When to Use | | ------------------------ | --------------------------------- | | Prompt Chaining | Sequential tasks with validation | | Routing | Processing varies by input type | | Parallelization | Independent tasks run together | | Orchestrator-Workers | Dynamic task decomposition | | Evaluator-Optimizer | Repeat until quality criteria met |
Stop Conditions (MANDATORY): Define success/failure criteria and exit conditions for every loop.
Design Workflow
- Requirements - Goal, subtasks, dependencies, quality criteria
- Pattern Selection - [!] Ask user to confirm pattern before proceeding
- Design Diagram - Visualize with Mermaid
- Principle Check - Validate against review checklist
- Implement & Iterate - Build small → verify → improve
When to Escalate
→ references/splitting-criteria.md
| Level | Configuration | Escalation Triggers | | ------ | --------------------- | ---------------------------------------- | | L0 | Single Prompt | Retry 3+, unstable output | | L1 | Prompt + Instructions | Steps > 5, "missed/overlooked" errors | | L2 | Single Agent | Multiple responsibilities, context > 70% | | L3 | Multi-Agent | Independent subtasks needed |
Quick Check: Prompt > 50 lines? Steps > 5? SRP violation? Context > 70%? → Consider splitting.
Review Checklist
→ references/review-checklist.md
- [ ] Single responsibility per agent? (SRP)
- [ ] Errors detected immediately? (Fail Fast)
- [ ] Small iterative steps? (Iterative)
- [ ] Results verifiable at each step? (Feedback Loop)
Key References
| Topic | Reference | | ------------------ | ---------------------------------------------------------------------- | | Prompt Template | references/prompt-template.md | | agent | references/agent-guide.md | | Agent Template | references/agent-template.md | | Agent Placement| references/vscode-agent-placement.md | | Context Management | references/context-engineering.md | | Handoffs | references/handoffs-guide.md | | Scaffold Tool | references/scaffold-usage.md | | Deep Agent | references/deep-agent-patterns.md | | Agent Evaluation | references/agent-evaluation.md |
agent Quick Fix
Problem: Orchestrator says "I'll delegate" but does work directly.
Solution: Use MUST/MANDATORY language. See agent-guide.md.
## MANDATORY: Sub-agent Delegation
You MUST use agent for each file. Do NOT read files directly.
Tools Reference
→ references/agent-template.md
| Purpose | VS Code Copilot | Claude Code |
| --------- | ------------------------ | ----------- |
| Shell | execute/runInTerminal | Bash |
| Read | read/readFile | Read |
| Edit | edit/editFiles | Write |
| Subagent | agent | Task |
| Web fetch | web/fetch | (MCP) |
External References
Official Documentation
- Chat in IDE - GitHub Docs
- Custom Agents - VS Code Docs
- Custom Agents - GitHub Docs
- Custom Agents Configuration - GitHub Docs
Design Principles
- Building Effective Agents - Anthropic
- Effective Context Engineering - Anthropic
- Writing Tools for Agents - Anthropic
- Context windows - Anthropic
Instructions & Context
- Adding repository custom instructions - GitHub Docs
Community Resources
- agent (旧 runSubagent) 検証記事 - Zenn
- subagent-driven-development - obra/superpowers
- awesome-copilot agents - GitHub
Prompt Engineering
- https://platform.openai.com/docs/guides/prompt-engineering
- https://code.claude.com/docs/en/best-practices
- https://www.promptingguide.ai/
- https://www.ibm.com/think/prompt-engineering
Done Criteria
- [ ] Workflow pattern selected and confirmed with user
- [ ]
.agent.mdfile created with clear Role/Workflow/Done Criteria - [ ] Design principles checklist passed
- [ ] Agent registered in AGENTS.md (if applicable)
Related Skills
aktsmm/drawio-diagram-forge
development
VerifiedTrustedCommunity
Generate draw.io editable diagrams (.drawio, .drawio.svg) from text, images, or Excel. Orchestrates 3-agent workflow (Analysis → Manifest → SVG generation) with quality gates. Use when creating architecture diagrams, flowcharts, sequence diagrams, or converting existing images to editable format. Supports Azure/AWS cloud icons.
11SKILL.mdUpdated Apr 2, 2026
aktsmm/book-writing-workspace
data-ai
VerifiedTrustedCommunity
Set up a reusable book-writing workspace with AI agents, instructions, prompts, and scripts. Use when creating a new book or technical writing project, bootstrapping a manuscript repository, or preparing a Markdown + Re:VIEW + PDF workflow. Triggers on "book writing workspace", "technical book project", "執筆ワークスペース", "book manuscript repo", and "Re:VIEW workspace".
11SKILL.mdUpdated Apr 2, 2026
aktsmm/vscode-extension-guide
tools
VerifiedTrustedCommunity
Guide for creating VS Code extensions from scratch to Marketplace publication. Use when: (1) Creating a new VS Code extension, (2) Adding commands, keybindings, or settings to an extension, (3) Publishing to VS Code Marketplace, (4) Troubleshooting extension activation or packaging issues, (5) Building TreeView or Webview UI, (6) Setting up extension tests.
10SKILL.mdUpdated Apr 2, 2026
aktsmm/skill-finder
data-ai
VerifiedTrustedCommunity
Full-featured Agent Skills management: Search 35+ skills, install locally, star favorites, update from sources. Use when looking for skills, installing new skills, or managing your skill collection.
10SKILL.mdUpdated Apr 2, 2026