Automate Skool with Codex

Create community posts, target specific groups, categorize with labels, and engage your course communities — all from the command line or through your AI agent.

Setup Guide GitHub

Please make sure there is always a human in the loop.

Post to Skool in Seconds

Terminal

# Install the skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Find your Skool integration
postiz integrations:list

# Create a community post
postiz posts:create \
  -c "Post content here..." \
  --settings '{"group":"group-id","label":"label-id","title":"Weekly Discussion"}' \
  -i "skool-id"

Skool-Specific Features

👥

Community Posts

Create rich community posts in your Skool groups. Share updates, lessons, and discussions with your members.

🎯

Group Targeting

Direct posts to specific Skool groups by ID. Reach the right community segment with every post.

🏷

Labeled Content

Categorize posts with labels for easy organization. Help members find relevant content by topic or category.

🎓

Course Communities

Engage your course communities with scheduled content. Keep students active with regular discussion prompts and updates.

📝

Titled Posts

Every Skool post gets a title for clarity. Create well-structured content that stands out in the community feed.

📅

Scheduled Posting

Schedule community posts in advance with ISO timestamps. Plan your content calendar and let automation handle delivery.

How It Works

Find Your Skool Integration

List your connected accounts and grab your Skool integration ID. You can also fetch available settings to see what options are supported.

Discovery

# List all integrations
postiz integrations:list

# Filter for Skool
postiz integrations:list | jq \
  '.[] | select(.identifier=="skool")'

# Get Skool settings schema
postiz integrations:settings <skool-id>

Configure Your Post

Set the target group, label, and title for your post. Every Skool post requires a group ID, label, and title alongside your content.

Configuration

# Check available groups and labels
postiz integrations:settings <skool-id>

# Example output:
# {
#   "group": { "type": "string", "required": true },
#   "label": { "type": "string", "required": true },
#   "title": { "type": "string", "required": true }
# }

Create Your Post

Schedule a Skool community post with your content, group targeting, label, and title. Optionally add a schedule time for future delivery.

Post Creation

postiz posts:create \
  -c "Welcome to this week's discussion!
  Share your progress and wins." \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "group": "group-id",
    "label": "label-id",
    "title": "Weekly Discussion Thread"
  }' \
  -i "skool-id"

Skool Settings Reference

Every Skool post accepts these platform-specific settings via the --settings flag.

Field	Type	Required	Description
`__type`	string	Yes	Must be "skool" to identify the platform
`group`	string	Yes	Skool group ID to post to
`label`	string	Yes	Label ID for categorizing the post
`title`	string	Yes	Post title (min 1 character)

Common Configurations

Copy-paste these settings for common Skool posting scenarios.

Weekly Discussion Thread

settings.json

{
  "group": "my-community",
  "label": "discussion",
  "title": "Weekly Discussion - Share Your Wins"
}

Course Lesson Update

settings.json

{
  "group": "course-cohort-3",
  "label": "lesson",
  "title": "Module 5: Advanced Strategies"
}

Community Announcement

settings.json

{
  "group": "my-community",
  "label": "announcement",
  "title": "Important: New Community Guidelines"
}

What is Codex?

Codex is OpenAI's autonomous coding agent that handles software engineering tasks — writing features, fixing bugs, and answering questions about your codebase. It works via CLI and IDE integrations, and can execute shell commands like Postiz.

💻

CLI & IDE Native

Codex runs from your terminal or IDE. It executes shell commands directly, making Postiz integration seamless — no extra configuration needed.

🔧

Autonomous Execution

Codex works in sandboxed cloud environments, autonomously running commands, reading output, and chaining multi-step workflows like social media posting.

⚡

Parallel Tasks

Run multiple Codex tasks simultaneously. Schedule posts to different platforms in parallel while Codex handles other coding work.

How Postiz Works with Codex

Codex discovers Postiz when you install it globally. It reads the SKILL.md to understand available commands and can autonomously chain them for social media workflows.

✓Install Postiz Agent globally with npx skills add
✓Codex reads the SKILL.md and learns all Postiz commands
✓POSTIZ_API_KEY must be set in environment
✓Codex executes commands in sandboxed environments
✓Works alongside your coding tasks in parallel

Install Postiz

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Codex discovers Postiz commands
# from the SKILL.md automatically
codex "list my social media integrations"

Skool Posting with Codex

Tell Codex what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.

💻

CLI Workflow

Terminal and IDE integration

Tell Codex what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.

Codex CLI

$ codex "Post to Skool about our
  new feature launch, schedule for
  tomorrow at 9am"

Codex: I'll handle that.
  Running: postiz integrations:list
  Found your Skool integration.
  Running: postiz posts:create ...

  Done! Your post is scheduled.
  Post ID: abc-123

💻

Parallel Tasks

Multiple tasks at once

Codex can handle multiple tasks in parallel. Schedule posts to different platforms while it works on other coding tasks simultaneously.

Codex Parallel Tasks

# Run multiple posting tasks in parallel
$ codex "Schedule a post about our
  launch to X for tomorrow 9am" &

$ codex "Write a LinkedIn article
  about our new feature and schedule
  for tomorrow noon" &

$ codex "Fix the bug in auth.ts"

# All three tasks run simultaneously

Why Codex + Postiz for Skool

Codex's autonomous execution makes Postiz a natural fit. The agent reads the SKILL.md to understand every available command, then autonomously chains them together for Skool community workflows.

✓CLI-native — runs from your terminal or IDE
✓Autonomous execution in sandboxed environments
✓Parallel task support — post while coding
✓Labels applied automatically based on content type
✓Cross-post to Skool + other platforms in a single session
✓Powered by OpenAI's most capable models

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Skool
metadata:
  codex:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Skool Settings
group, label, title

Also Works with Claude Code

Postiz Agent works as a CLI tool with any AI agent that can execute shell commands — including Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the SKILL.md file to learn all available Postiz commands, then autonomously discovers your Skool integration, targets the right group and label, sets the post title, and publishes to your community.

Claude Code

> Post a lesson update to my course
  group about Module 5, label it as
  "lesson", schedule for Monday 9am

Claude will automatically run:
  postiz integrations:list
  postiz posts:create \
    -c "Module 5 is now live!..." \
    -s "2025-03-03T09:00:00Z" \
    --settings '{"group":
      "course-cohort-3",
      "label":"lesson",
      "title":"Module 5: Advanced
      Strategies"}' \
    -i "skool-id"

Skool + Other Platforms

Post to your Skool community and social media simultaneously. Each platform gets its own settings.

Terminal

# Post to Skool and social media simultaneously
postiz posts:create \
  -c "New lesson dropped! Check out Module 5." \
  -s "2025-03-01T09:00:00Z" \
  --settings '{"group":"course-cohort-3","label":"lesson","title":"Module 5 is Live!"}' \
  -i "skool-id,twitter-id,linkedin-id"

# Batch schedule weekly discussion threads
for week in 1 2 3 4; do
  postiz posts:create \
    -c "Week $week discussion: Share your progress!" \
    -s "2025-03-0${week}T09:00:00Z" \
    --settings '{"group":"my-community","label":"discussion","title":"Weekly Discussion - Week '$week'"}' \
    -i "skool-id"
done

Start posting to Skool

Install Postiz Agent and automate your Skool community engagement with AI-powered scheduling and publishing.

Get Started

Ready to get started?

Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.

Start for $0

Open-source social media scheduling tool

Proudly open-source ❤️