sergebulaev/linkedin-skills / .codex-marketplace/linkedin-skills/skills/linkedin-humanizer
linkedin-humanizer
VerifiedRemove AI tells from LinkedIn posts/comments: 2026 vocabulary density, reveal bridges, staccato fragments, stacked triads, performed sincerity. Tiered rewriter plus `--mode audit` LinkedIn post auditor and `--mode profile` voice builder. Not for drafting from scratch (use linkedin-post-writer) or beating AI detectors. Keywords: humanize, de-AI, post audit, post auditor, audit before posting.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 16.4 KB |
| references/audit-ai-tells.md | markdown | 11.6 KB |
| references/audit-checklist.md | markdown | 4.1 KB |
| references/audit-examples.md | markdown | 452 B |
| references/detector-list.md | markdown | 6.1 KB |
| references/emoji-patterns.md | markdown | 3.8 KB |
| references/examples.md | markdown | 1.4 KB |
| references/rules-explainer.md | markdown | 14.8 KB |
| references/scrub-rules.md | markdown | 27.0 KB |
| references/tier-rationale.md | markdown | 17.3 KB |
| references/v3-changes.md | markdown | 3.2 KB |
| references/voice-fingerprint.md | markdown | 5.3 KB |
| scripts/detectors.env.example | other | 428 B |
| scripts/test_detectors.pyexecutable | script | 13.0 KB |
| sub-skills/detector-tester.md | markdown | 6.0 KB |
| sub-skills/emoji-detector.md | markdown | 3.9 KB |
| sub-skills/illustration.md | markdown | 7.4 KB |
| sub-skills/post-audit.md | markdown | 4.9 KB |
| sub-skills/rules-explainer.md | markdown | 5.2 KB |
| sub-skills/voice-profile.md | markdown | 3.0 KB |
sub-skills/illustration.md
View on GitHub# Sub-skill: Generate an illustration for a post
Adds an optional image to a draft (feed illustration, carousel slide, 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
"add a cover" for a post.
- Offer it once after a post draft is approved, when a visual would lift reach
(LinkedIn image posts get more dwell time than plain text).
## Backends (mirrors the publish layer)
- **pixfaro** — `PIXFARO_TOKEN` (`pf_live_...`) set: the image is generated and
attached automatically.
- **manual** — no token: the skill drafts the image prompt and asks the user to
generate it themselves and paste the URL. Never blocks a draft.
- If the user says they DID add a key, do not repeat the signup pitch: the
manual message already names a `.env` that defines the token but was not
loaded (wrong folder / `python-dotenv` missing). Point them to
`python3 scripts/check_config.py` in the linkedin-skills folder — it verifies
the key against Pixfaro's `GET /v1/key` and prints the exact problem.
`lib.image_backend()` reports which is active.
## Steps
1. **Pick the kind** (maps to an aspect ratio automatically):
- `wide` / `link` (1200:628) - link-preview / single feed image (default for a text post)
- `portrait` / `carousel` / `quote` (4:5) - feed portrait, carousel slide, quote-card
- `square` (1:1) - generic
Override with an explicit `aspect_ratio="w:h"` when needed.
2. **Craft the prompt.** Describe the scene concretely: subject, composition,
style, palette. Default to a clean, non-literal, professional editorial look
unless the Voice & Brand Profile §6 sets a `Visual style default`. Do NOT try
to render the post's words inside the art (see overlay below).
3. **Apply brand overlay (if profile has it).** Read `../../../references/voice-profile.md`
§6 Brand assets. If a handle, brand color, or logo is set, pass an `overlay`
so the text/logo is composited pixel-exact (crisp even on a cheap model):
```python
from lib import illustrate
r = illustrate(
"Minimal flat-vector lighthouse cutting through fog, calm blue palette, editorial",
kind="wide",
overlay={"text": "@yourhandle", "position": "bottom-right", "color": "#0A66C2"},
)
```
For a **quote-card**, do NOT use `illustrate` at all — use the typeset
template instead (see "Quote-cards" below): the line is HTML-typeset
server-side, so it wraps and stays sharp at any length.
4. **Model choice.** Default `nano-banana-2` (balanced, ~$0.08). The overlay
handles text, so a cheap base model is fine. Only reach for `gemini-pro-image`
when the user wants premium art. Never silently upgrade the tier.
5. **Show + confirm.** Present the returned `url` and `cost`. On approval, attach
it when publishing: `publish("post", draft_text, target_url, media_urls=[r["url"]])`.
6. **Manual mode.** If `r["backend"] == "manual"`, show `r["message"]` (the drafted
prompt + aspect) and ask for a pasted URL to attach.
## 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.
## Quote-cards: use the template, not the model
A quote-card is text-led, and image models draw text unreliably. Pixfaro's
design templates typeset the card as HTML server-side (`POST /v1/renders`), so
the hook line is crisp every time — and the result flows into `publish` exactly
like an illustration:
```python
from lib import quote_card, publish
r = quote_card(
"<the pulled hook line, up to 280 chars>",
handle="@yourhandle", # or "default" to pull from the brand identity
avatar="default", # optional; brand-kit avatar
size="1:1", # 1:1 | 4:5 | 16:9 | og
style="brand", # or "auto" to rotate looks between cards
)
publish("post", draft_text, target_url, media_urls=[r["url"]])
```
- `style="auto"` deliberately varies palette/layout between consecutive cards
so a series doesn't look copy-pasted; `style="brand"` locks to the account's
brand palette (needs a brand identity configured in Pixfaro).
- `lib.available_templates()` lists all templates with slots, sizes and live
prices (`quote-card`, `post-card`, ...); `lib.card(template, slots, ...)` is
the generic call when you need one beyond quote-cards.
- Manual mode (no token) returns the card content as a spec for the user, same
as `illustrate`.
## Brand logo (one-time setup)
If the Voice & Brand Profile §6 names a logo *file path* but no `logo_id`,
offer to upload it once — after that every overlay can stamp the real logo
instead of a text handle:
```python
from lib import brand_logo
r = brand_logo("path/to/logo.png", name="acme-mark")
# -> {"backend": "pixfaro", "logo": {"id": "logo_...", ...}}
```
- Save the returned `logo_id` under "Logo" in the Voice & Brand Profile §6,
then use `overlay={"logo_id": "<id>", "position": "bottom-right"}`.
- Constraints: transparent PNG, ≤1MB, ≤2048px per side, ≤10 per account.
- Upload needs a **full-scope** key. On a generate-scope key the call returns
`error: "insufficient_scope"` with instructions (upload once in the Pixfaro
dashboard instead) — relay that message, don't retry.
## Multi-image grid (LinkedIn, up to 10)
LinkedIn posts can carry up to 10 images in a grid layout (not a swipeable
carousel, which the API does not support). Generate a set and attach them all:
```python
from lib import illustrate_set, publish
shots = illustrate_set(["scene A prompt", "scene B prompt", "scene C prompt"],
kind="wide", overlay={"text": "@handle", "color": "#0A66C2"})
urls = [s["url"] for s in shots if s.get("url")]
publish("post", draft_text, target_url, media_urls=urls)
```
`illustrate_set` takes 2-10 prompts and returns a list of `illustrate()` results
in order. LinkedIn cannot mix images with video in one post.
## Hard rules
- One image per request (`n>1` is unsupported); for a multi-image grid, use
`illustrate_set` (it generates one prompt at a time under the hood).
- Keep real words in the `overlay` or a template slot (`quote_card`/`card`),
never baked into the prompt art.
- Respect the user's cost: default to the cheap model + 1K resolution unless asked.
- Never attach an image the user has not seen and approved.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |