ajshedivy/agno-cookbook/agentos-api-workflows
Claude Code and agent skill by ajshedivy/agno-cookbook
- community
Checking that the SKILL.md file is still in the repository.
Interact with AgentOS Workflow API endpoints. For standard operations (listing workflows, running workflows, streaming), use the provided CLI script first. Only write custom Python when the script cannot handle the use case (e.g., custom event handling, chaining multiple workflow calls, error handling with retries). Trigger when: running workflows remotely, listing workflows, creating workflow tests, or asking things like "what workflows do I have?" or "run my content pipeline workflow."
Install
npx vskill@latest install ajshedivy/agno-cookbook/agentos-api-workflowsSKILL.md
The same SKILL.md was published earlier as ajshedivy/agno-cookbook/agentos-api-workflows.
AgentOS Workflows API
Prerequisites
Start an AgentOS server with workflows configured:
Default: Use the CLI Script
Always try the provided script first. It covers listing workflows, running workflows (streaming and non-streaming), and auto-selecting the first workflow — all from the command line with no custom code needed.
The script is at: scripts/run_workflows.py
List all workflows
Show full AgentOS config
Show workflow-specific config (steps, agents, tools)
Run a specific workflow
Stream a workflow response
Run against a remote server
Full CLI reference
When to Write Custom Python
Only write ad-hoc Python when the CLI script cannot handle your use case:
- Custom event handling beyond printing content (e.g., aggregating step results)
- Chaining multiple workflow calls in a single script
- Custom error handling or retry logic
- Authentication with custom headers
- Programmatic inspection of workflow config beyond what
--configshows - Integration tests that assert on response content
API Endpoints
| Method | Path | Description | |
|---|---|---|---|
| GET | /workflows | List all workflows | |
| GET | /workflows/{workflow_id} | Get workflow details | |
| POST | /workflows/{workflow_id}/runs | Create workflow run |
Workflow Event Types
| Event | Description | |
|---|---|---|
RunContent | Streamed content chunk from an agent step | |
WorkflowAgentCompleted | An agent step within the workflow completed |
Custom Python Examples
Error Handling
Authentication
When the AgentOS instance has a security key configured:
Anti-Patterns
- Don't write custom Python for basic operations — use the CLI script
- Don't forget `await` — all client methods are async
- Don't hardcode workflow IDs — discover them from
aget_config()or the CLI script - Don't confuse event types — workflow streaming uses
event.eventstring checks, notisinstance() - Don't ignore error responses — workflows can fail at individual steps; check for errors
Further Reading
For advanced workflow API patterns, read references/api-patterns.md.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/agno-agentos-api/skills/agentos-api-workflows/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/ajshedivy/agno-cookbook/agentos-api-workflows)