Skip to content

sergebulaev/youtube-skills / .codex-marketplace/youtube-skills/skills/yt-community-post-writer

yt-community-post-writer

Verified

Write YouTube community-tab posts: text updates, polls, image-caption posts, and questions that drive comments and bring subscribers back between video uploads. Tuned to the community tab's role as a low-friction touchpoint that keeps a channel warm and feeds session signals. Returns a copy-paste block (community posts have no publishing API, so this is always manual by design). Use to write a community post or poll. Not for video titles or descriptions (use yt-title-optimizer and yt-description-writer).

FileKindSize
SKILL.mdskill md6.3 KB
references/post-types.mdmarkdown2.0 KB
sub-skills/illustration.mdmarkdown3.8 KB
sub-skills/voice-profile.mdmarkdown2.1 KB

sub-skills/illustration.md

View on GitHub
# Sub-skill: Generate an illustration for a YouTube post

Adds an optional image to a draft (feed image, thumbnail, or quote-card) and
attaches it on publish. Uses the Pixfaro image layer through `lib.illustrate`,
which returns a hosted URL that flows straight into Publora media. Runs on any
agent (Claude Code, Codex, OpenClaw).

## When this runs

- User says "add an image", "make an illustration", "make a quote-card", or
  "make a thumbnail" for a YouTube post.
- Offer it once after a draft is approved, when a visual would lift reach.

## Backends (mirrors the publish layer)

- **pixfaro** - `PIXFARO_TOKEN` (`pf_live_...`) set: image generated + attached
  automatically.
- **manual** - no token: the skill drafts the image prompt and asks the user to
  generate it and paste the URL. Never blocks a draft.

`lib.image_backend()` reports which is active.

## Steps

1. **Pick the kind.** Default for YouTube is `thumbnail` (aspect 16:9). Override
   with `aspect_ratio="w:h"` when needed. Other kinds: thumbnail 16:9, carousel/
   quote/portrait 4:5, story/cover 9:16, wide/link 16:9, square 1:1.
2. **Craft the prompt.** Describe subject, composition, style, palette. Default
   to a clean professional look unless Voice & Brand Profile §6 sets a visual
   style. Do NOT bake the post's words into the art (use overlay).
3. **Apply brand overlay (if profile has it).** Read `../../../references/voice-profile.md`
   §6. If a handle, brand color, or logo is set, pass an `overlay` so text/logo is
   composited pixel-exact (crisp even on a cheap model):
   ```python
   from lib import illustrate
   r = illustrate("<scene prompt>", kind="thumbnail",
                  overlay={"text": "@handle", "position": "bottom-right", "color": "#RRGGBB"})
   ```
   For a **quote-card**, put the pulled hook line in overlay `text` (not the prompt),
   `kind="quote"`.
4. **Model choice.** Default `nano-banana-2`, which is what `illustrate` uses when no model is passed. The overlay handles text, so a cheap base
   model is fine; only reach for gemini-pro-image on premium art. Never silently
   upgrade the tier.
5. **Show + confirm.** Present the returned `url` and `cost`. On approval, attach
   via `media_urls=[r["url"]]` when publishing.
6. **Manual mode.** If `r["backend"] == "manual"`, show `r["message"]` and ask for
   a pasted URL.

## Refine instead of regenerating

When the user wants a tweak ("make the sky darker", "swap the headline", "more
whitespace"), do NOT regenerate from scratch. Keep the `id` from the previous
result and edit it:

```python
from lib import illustrate, refine
first = illustrate("<scene>", kind="wide")     # -> {"id": "img_...", "url": ...}
fixed = refine(first["id"], "make the background darker and increase contrast")
```

`refine` edits by `img_...` id (not URL), inherits the source shape/tier when you
omit `aspect_ratio`/`resolution`, and is cheaper + more consistent than a fresh
generation. Chain it as many times as needed.

## Cost-guard

- Each result carries `cost` and `balance_after`; if `low_balance` is True, tell
  the user the Pixfaro balance is low before generating more.
- Default to `nano-banana-2` + 1K. The premium models (`gemini-pro-image`,
  `gpt-5-image`) bill several times more - only use them when the user asks by
  name; `illustrate`/`refine` never upgrade on their own.
  A result's `premium`
  flag is True when a premium-priced model was used - confirm that was intended.
- `lib.available_models()` returns live pricing/latency when you need to show it.

## Hard rules

- One image per request (`n>1` unsupported); generate carousel slides one at a time.
- Keep real words in the `overlay`, not baked into the prompt art.
- Default to the cheap model + 1K resolution unless the user asks for premium.
- Never attach an image the user has not seen and approved.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall