Facebook Page Publisher agent skill: how to use meta-upload

What the meta-upload skill makes the agent do

The skill tells the agent how to use the existing sau facebook-page commands. It covers logging in with a saved account alias, publishing a video or an image-and-text post, scheduling either one, looking up a post, and deleting it.

The agent does not reimplement browser logic. It runs the commands and reports results, which are saved to local JSON files. The skill also explains how to read statuses such as scheduled, published, processing and submission_unknown, and to verify a post before deleting it.

• Publish a video or an image-and-text post to a named Facebook Page
• Schedule either type for a Beijing-time slot (Asia/Shanghai)
• Record results and post IDs in local JSON files
• Verify a post exists and matches expected text before any deletion
• Delete scheduled or published content with explicit flags

Install the meta-upload skill

Download the ZIP of the skill from this page. Then choose one of two routes.

For Claude Code on your own machine, unzip the folder into ~/.claude/skills/. To keep the skill only for one project, unzip it into that project's .claude/skills/ folder instead.

In the Claude apps, open Settings, go to Capabilities, then Skills, and upload the ZIP there.

• Personal use across projects: ~/.claude/skills/
• One project only: the project's .claude/skills/ folder
• Claude apps: Settings → Capabilities → Skills, then upload the ZIP

Set up sau, your Facebook login and timezone first

The skill does not work on its own. The sau CLI must be installed and on your PATH, with the facebook-page subcommands available. Log in once through the browser flow with an account that has admin access to the target Page, and save it under an alias such as creator.

Scheduled posts use Beijing time, so the browser timezone must be set to Asia/Shanghai. If your network needs a proxy, pass --proxy or set SAU_FACEBOOK_PAGE_PROXY. By default no proxy is configured and the browser connects directly. Passing --proxy with an empty string ignores the environment variable.

• sau CLI installed and on PATH with facebook-page subcommands
• Logged-in Facebook account with admin access to the Page
• Browser timezone set to Asia/Shanghai for scheduled posts
• Optional proxy via SAU_FACEBOOK_PAGE_PROXY or --proxy

Ask the agent for tasks in plain language

Once the skill is installed, describe the job in ordinary words and name the Page, the account alias, the content and any schedule. Ask the agent to check the result file afterwards so you have a record of the post ID.

Good requests name the action (publish, schedule, verify, delete), the Page name exactly as it appears on Facebook, and the content. For scheduled posts, state the Beijing time and make sure it is at least 2 hours ahead.

• Publish the image at images/1.jpg to my Page 'My Page' with title and body text, and save the result to .local/page-result.json
• Schedule the video videos/demo.mp4 for 10:30 Beijing time on a date at least 2 hours away, and save the result
• Verify the scheduled post with this content ID and expected text before doing anything else
• Delete this scheduled post, but only after checking that the Page ID and text match the saved record

Commands the agent runs and examples

The skill points to these commands as the basis of its work. Before running them, check the current CLI with --help, because flags can change. Replace the account, media and text with your own. These commands can create real posts.

Use --schedule with 'YYYY-MM-DD HH:MM' for Beijing-time scheduling. Leave it out to submit immediately. Use --tags for English comma-separated tags. Ask for --result explicitly so the outcome is saved to a file rather than copied by hand. By default results go to .local/meta-results/.

• upload-note publishes image-and-text content
• upload-video publishes a video, optionally scheduled
• verify checks a post by Page, IDs and expected text
• delete removes a post, with --scheduled for the scheduled list

Read the statuses before you verify or delete

A scheduled status means the platform confirmed the schedule and the agent checked the original record. A published status means an image-and-text post is live. A video submitted immediately returns processing once the creation response has no error and the completion dialog appears. That means the platform accepted it and is working on it, not that it is already playing publicly, and the content ID may not be available yet.

submission_unknown means the evidence of submission is insufficient. The agent must query the original record first and must not resubmit.

• scheduled: platform confirmed the schedule
• published: image-and-text post is live
• processing: accepted and in progress; the content ID may be missing for now
• submission_unknown: query the original record first, never resend

Verify and delete posts safely

Verification and deletion both use the Page name, Page ID, content ID and the original text. Add --scheduled when you are looking at the scheduled list. Deleting a scheduled post cancels the schedule and removes it permanently, returning deleted. Deleting a published post without --scheduled moves it to the trash, returning trashed, where it is removed automatically after 30 days. Where the Page trash is not connected, the skill does not claim a permanent deletion.

The skill only covers the recent lists that have loaded. It does not guarantee it can find all historical posts. If the same text cannot uniquely identify the post, or the Page or ID does not match, nothing is deleted. After a scheduled post goes live, its ID may change, so use the ID from the published list.

• Use --scheduled only for the scheduled list
• Without --scheduled, published content goes to trash (30 days)
• If deletion times out or the browser disconnects, check the original record and do not delete again automatically
• Local media files are kept