{
  "schemaVersion": "1.0",
  "item": {
    "slug": "publora-bluesky",
    "name": "Publora — Bluesky",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/sergebulaev/publora-bluesky",
    "canonicalUrl": "https://clawhub.ai/sergebulaev/publora-bluesky",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/publora-bluesky",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=publora-bluesky",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/publora-bluesky"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/publora-bluesky",
    "agentPageUrl": "https://openagent3.xyz/skills/publora-bluesky/agent",
    "manifestUrl": "https://openagent3.xyz/skills/publora-bluesky/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/publora-bluesky/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Publora — Bluesky",
        "body": "Bluesky (AT Protocol) platform skill for the Publora API. For auth, core scheduling, media upload, and workspace/webhook docs, see the publora core skill.\n\nBase URL: https://api.publora.com/api/v1\nHeader: x-publora-key: sk_YOUR_KEY\nPlatform ID format: bluesky-{did}\n\nWhere {did} is your Bluesky Decentralized Identifier (DID), assigned on connection."
      },
      {
        "title": "Requirements",
        "body": "A Bluesky account connected via username + app password (not your main password)\nGenerate an app password: Bluesky Settings → App Passwords\nConnected through the Publora dashboard"
      },
      {
        "title": "Platform Limits (API)",
        "body": "PropertyLimitNotesText300 charactersLinks do NOT count toward limitImagesUp to 4 × 1 MBJPEG, PNG, WebP (max 2000×2000 px)Video3 min / 100 MBMP4; email verification requiredVideo (short)<60s → 50 MBSize tiers applyText only✅ Yes—Daily video limit25 videos / 10 GB—Rate limit3,000 req/5 min—\n\nCommon errors:\n\n429 Too Many Requests — rate limit exceeded, wait and retry\nVideo JOB_STATE_FAILED — check format (MP4) and size tier"
      },
      {
        "title": "Post a Skeet (text post)",
        "body": "await fetch('https://api.publora.com/api/v1/create-post', {\n  method: 'POST',\n  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },\n  body: JSON.stringify({\n    content: 'Building in public on Bluesky today! Links, hashtags, and mentions all auto-detected. #buildinpublic',\n    platforms: ['bluesky-did:plc:abc123']\n  })\n});\n\nPublora automatically detects hashtags, URLs, and @mentions and creates proper AT Protocol facets."
      },
      {
        "title": "Schedule a Post",
        "body": "body: JSON.stringify({\n  content: 'Your Bluesky post here',\n  platforms: ['bluesky-did:plc:abc123'],\n  scheduledTime: '2026-03-20T11:00:00.000Z'\n})"
      },
      {
        "title": "Post with Image",
        "body": "⚠️ Bluesky has a strict 1 MB limit per image. Compress to 80–85% JPEG quality.\n\nimport requests\n\nHEADERS = { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' }\n\n# Step 1: Create post\npost = requests.post('https://api.publora.com/api/v1/create-post', headers=HEADERS, json={\n    'content': 'Check out this photo! 📸',\n    'platforms': ['bluesky-did:plc:abc123']\n}).json()\n\n# Step 2: Get upload URL (make sure image is <1 MB and JPEG/PNG/WebP)\nupload = requests.post('https://api.publora.com/api/v1/get-upload-url', headers=HEADERS, json={\n    'postGroupId': post['postGroupId'],\n    'fileName': 'photo.jpg',\n    'contentType': 'image/jpeg',\n    'type': 'image'\n}).json()\n\n# Step 3: Upload\nwith open('photo_compressed.jpg', 'rb') as f:\n    requests.put(upload['uploadUrl'], headers={'Content-Type': 'image/jpeg'}, data=f)"
      },
      {
        "title": "Platform Quirks",
        "body": "Links don't count toward the 300-char limit — great for posts with URLs\nAuto-facets: Publora automatically detects #hashtags, @mentions, and URLs and creates proper Bluesky facets\nImage size is strict: 1 MB hard limit per image. Always compress before upload.\nImage dimensions: Max 2000×2000 pixels\nApp password required: Never use your main Bluesky password; create a dedicated app password\nEmail verification: Required before you can upload videos (one-time step in Bluesky settings)\nDID format: Platform ID uses the full DID, e.g. bluesky-did:plc:abc123xyz"
      }
    ],
    "body": "Publora — Bluesky\n\nBluesky (AT Protocol) platform skill for the Publora API. For auth, core scheduling, media upload, and workspace/webhook docs, see the publora core skill.\n\nBase URL: https://api.publora.com/api/v1\nHeader: x-publora-key: sk_YOUR_KEY\nPlatform ID format: bluesky-{did}\n\nWhere {did} is your Bluesky Decentralized Identifier (DID), assigned on connection.\n\nRequirements\nA Bluesky account connected via username + app password (not your main password)\nGenerate an app password: Bluesky Settings → App Passwords\nConnected through the Publora dashboard\nPlatform Limits (API)\nProperty\tLimit\tNotes\nText\t300 characters\tLinks do NOT count toward limit\nImages\tUp to 4 × 1 MB\tJPEG, PNG, WebP (max 2000×2000 px)\nVideo\t3 min / 100 MB\tMP4; email verification required\nVideo (short)\t<60s → 50 MB\tSize tiers apply\nText only\t✅ Yes\t—\nDaily video limit\t25 videos / 10 GB\t—\nRate limit\t3,000 req/5 min\t—\n\nCommon errors:\n\n429 Too Many Requests — rate limit exceeded, wait and retry\nVideo JOB_STATE_FAILED — check format (MP4) and size tier\nPost a Skeet (text post)\nawait fetch('https://api.publora.com/api/v1/create-post', {\n  method: 'POST',\n  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },\n  body: JSON.stringify({\n    content: 'Building in public on Bluesky today! Links, hashtags, and mentions all auto-detected. #buildinpublic',\n    platforms: ['bluesky-did:plc:abc123']\n  })\n});\n\n\nPublora automatically detects hashtags, URLs, and @mentions and creates proper AT Protocol facets.\n\nSchedule a Post\nbody: JSON.stringify({\n  content: 'Your Bluesky post here',\n  platforms: ['bluesky-did:plc:abc123'],\n  scheduledTime: '2026-03-20T11:00:00.000Z'\n})\n\nPost with Image\n\n⚠️ Bluesky has a strict 1 MB limit per image. Compress to 80–85% JPEG quality.\n\nimport requests\n\nHEADERS = { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' }\n\n# Step 1: Create post\npost = requests.post('https://api.publora.com/api/v1/create-post', headers=HEADERS, json={\n    'content': 'Check out this photo! 📸',\n    'platforms': ['bluesky-did:plc:abc123']\n}).json()\n\n# Step 2: Get upload URL (make sure image is <1 MB and JPEG/PNG/WebP)\nupload = requests.post('https://api.publora.com/api/v1/get-upload-url', headers=HEADERS, json={\n    'postGroupId': post['postGroupId'],\n    'fileName': 'photo.jpg',\n    'contentType': 'image/jpeg',\n    'type': 'image'\n}).json()\n\n# Step 3: Upload\nwith open('photo_compressed.jpg', 'rb') as f:\n    requests.put(upload['uploadUrl'], headers={'Content-Type': 'image/jpeg'}, data=f)\n\nPlatform Quirks\nLinks don't count toward the 300-char limit — great for posts with URLs\nAuto-facets: Publora automatically detects #hashtags, @mentions, and URLs and creates proper Bluesky facets\nImage size is strict: 1 MB hard limit per image. Always compress before upload.\nImage dimensions: Max 2000×2000 pixels\nApp password required: Never use your main Bluesky password; create a dedicated app password\nEmail verification: Required before you can upload videos (one-time step in Bluesky settings)\nDID format: Platform ID uses the full DID, e.g. bluesky-did:plc:abc123xyz"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/sergebulaev/publora-bluesky",
    "publisherUrl": "https://clawhub.ai/sergebulaev/publora-bluesky",
    "owner": "sergebulaev",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/publora-bluesky",
    "downloadUrl": "https://openagent3.xyz/downloads/publora-bluesky",
    "agentUrl": "https://openagent3.xyz/skills/publora-bluesky/agent",
    "manifestUrl": "https://openagent3.xyz/skills/publora-bluesky/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/publora-bluesky/agent.md"
  }
}