# Postiz Scheduler

> Automatically lists active social integrations, discovers slot availabilities, prompts the user for text/media content, and schedules posts via the Postiz MCP server.

- Skill: `knuckles-team/postiz-scheduler` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add knuckles-team/postiz-scheduler`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knuckles-team/postiz-scheduler/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Knuckles-Team (https://skillmd.com/u/knuckles-team)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/knuckles-team/postiz-scheduler

---


# Postiz Scheduler Workflow

**CONCEPT:KG-2.12**

Automatically lists active social integrations, discovers slot availabilities, prompts the user for text/media content, and schedules posts via the Postiz MCP server.

## Steps

### Step 0: Postiz Integration Discovery [skill: postiz-agent]
**Agent**: `intake-agent`
**Tools**: `graph_query, nc_files`

Retrieve active integration accounts and check for slot time recommendations using postiz_integrations with list_integrations or check_connection actions.
Expected: `active_integrations, recommended_slots`

### Step 1: User Interaction
**Agent**: `processor-agent`
**Tools**: `graph_analyze, document_tools`

Present active channels and slot suggestions. Prompt the user for post body text, image/video attachment URLs, and schedule parameters.
Expected: `post_content, file_url, release_time`

### Step 2: Postiz Post Scheduling [skill: postiz-agent]
**Agent**: `validator-agent`
**Tools**: `graph_query`

Create and schedule the post (uploading the file attachment if provided) using the postiz_posts and postiz_uploads tools.
Expected: `post_creation_result`

### Step 3: KG Persistence [depends_on: Step 2]
**Agent**: `validator-agent`
**Tools**: `graph_write`

Persist workflow results as nodes and edges in the Knowledge Graph.
Create appropriate typed nodes with metadata and link to existing domain entities.

## Output
- Postiz Scheduler results persisted in KG
- Structured report (MD/PDF)
- Audit trail with timestamps and agent attributions

## Human Oversight Required
✅ Critical decisions require human review and approval.

## Execution

Run this workflow as a dependency-ordered DAG. Steps with no unmet `depends_on` run in parallel; dependents run after their prerequisites complete.

- **Run first (in parallel):** Step 0 — Postiz Integration Discovery; Step 1 — User Interaction; Step 2 — Postiz Post Scheduling
- **After level 0:** Step 3 — KG Persistence

**Execution:** If graph-os is reachable, offload the whole DAG via `graph_orchestrate action=execute_workflow` (or the `kg-delegate` skill) for true parallel/swarm execution. Otherwise execute the steps natively in dependency order: run steps with no unmet `depends_on` in parallel, then their dependents.