AI Content Calendar Agent Skill — AI Pass API

Skill File

schema_version: "1.0"
id: "ai-pass.content-calendar"
name: "AI Pass - 30-Day Social Media Content Calendar"
description: "Generates a 30-day social media content calendar with post ideas and captions."
author: "auto-generated"
auth:
  type: "env"
  env_var: "AIPASS_API_KEY"
  header: "Authorization"
  header_value_template: "Bearer $AIPASS_API_KEY"
base:
  url: "https://aipass.one"
  timeout_seconds: 60
endpoints:
  create_content_calendar:
    description: "Call AI Pass chat completions to generate a 30-day social media content calendar with post ideas and captions."
    method: POST
    path: "/apikey/v1/chat/completions"
    headers:
      Content-Type: "application/json"
      Authorization: "Bearer $AIPASS_API_KEY"
    request:
      content_type: application/json
      body:
        model: "{{model}}"
        temperature: "{{temperature}}"
        max_tokens: "{{max_tokens}}"
        top_p: "{{top_p}}"
        messages:
          - role: system
            content: |
              You are a helpful assistant specialized in creating social media content calendars. Produce clear, actionable post ideas and captions for each day, tailored to the user's brand, audience, tone, and preferred platforms. Format output as JSON with an array "days" containing 30 entries. Each entry should include:
                - day (1-30)
                - date (optional, if start_date provided)
                - platforms (list)
                - post_idea (short title)
                - caption (complete caption appropriate to the platform(s))
                - hashtags (list, up to 10)
                - assets (list of suggested image/video/graphic ideas)
                - call_to_action (short)
              Provide any scheduling notes and suggested posting times when relevant.
          - role: user
            content: |
              Generate a 30-day social media content calendar with post ideas and captions.
              Brand: "{{brand_name}}"
              Audience: "{{audience}}"
              Tone: "{{tone}}"
              Platforms: "{{platforms}}"
              Start date (optional, YYYY-MM-DD): "{{start_date}}"
              Goals: "{{goals}}"
              Constraints/Do not do: "{{constraints}}"
              Extra instructions: "{{extra_instructions}}"
    parameters:
      model:
        type: string
        description: "Model to use. Default should be compatible with AI Pass (if unknown, use a compact GPT-4o variant)."
        default: "gpt-4o-mini"
      temperature:
        type: number
        description: "Sampling temperature."
        default: 0.7
      max_tokens:
        type: integer
        description: "Maximum tokens for the response."
        default: 1500
      top_p:
        type: number
        description: "Nucleus sampling."
        default: 0.95
      brand_name:
        type: string
        description: "Name of the brand or account."
        default: "Your Brand"
      audience:
        type: string
        description: "Target audience description."
        default: "General followers interested in the brand"
      tone:
        type: string
        description: "Desired tone for captions (e.g., friendly, professional, witty)."
        default: "friendly"
      platforms:
        type: string
        description: "Comma-separated list of target platforms (e.g., Instagram, X/Twitter, LinkedIn, Facebook, TikTok)."
        default: "Instagram, Facebook"
      start_date:
        type: string
        description: "Optional start date in YYYY-MM-DD format to populate actual dates for each day."
        default: ""
      goals:
        type: string
        description: "Primary goals (e.g., awareness, engagement, sales, lead-gen)."
        default: "engagement"
      constraints:
        type: string
        description: "Any content constraints or prohibited topics."
        default: ""
      extra_instructions:
        type: string
        description: "Any extra guidance for the calendar."
        default: ""
    response:
      status_codes:
        200:
          description: "Successful content calendar generation"
          content_type: application/json
          mapping:
            output_path: "choices[0].message.content"
            parse_as: "json_or_text"
        default:
          description: "Unexpected response"
          content_type: application/json
          mapping:
            output_path: "error"
examples:
  - name: "Basic 30-day calendar for small bakery"
    request:
      model: "gpt-4o-mini"
      temperature: 0.7
      max_tokens: 1500
      top_p: 0.95
      brand_name: "Sunrise Bakery"
      audience: "Local customers who love fresh-baked goods, home bakers, families"
      tone: "warm, friendly"
      platforms: "Instagram, Facebook"
      start_date: "2026-04-01"
      goals: "increase foot traffic and local awareness"
      constraints: "No dietary medical claims; avoid controversial topics"
      extra_instructions: "Include weekend promotional ideas and community event tie-ins"
notes:
  - "Authentication uses the $AIPASS_API_KEY environment variable. The Authorization header is set to 'Bearer $AIPASS_API_KEY'. Ensure the environment variable is available to the agent runtime."
  - "The endpoint returns a standard chat-completion response. The skill extracts choices[0].message.content. If the API returns plain text, the agent should attempt to parse JSON from the content per the system instruction; otherwise return the raw text."
  - "Adjust model and token settings as needed for length/detail."