beatra-ai/beatra-skills / plugins/ai-image-realism/skills/ai-image-realism
ai-image-realism
VerifiedImprove AI image realism without starting over. This focused AI image editor and humanizer targets visible AI image artifacts—plastic skin, malformed hands or faces, extra fingers, repeated textures, and inconsistent lighting—with focused AI image retouching through a local repair or natural whole-image refinement. Use it to make AI portraits, product images, marketing graphics, and social covers look more realistic, remove the obvious AI look, fix AI hands and extra fingers, or refine product imagery, while aiming to keep identity, product shape, brand details, and composition recognizable where possible.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.9 KB |
| install-source.json | config | 39 B |
| manifest.json | config | 4.3 KB |
| references/billing-errors-and-recovery.md | markdown | 5.8 KB |
| references/diagnosis-and-routing.md | markdown | 2.7 KB |
| references/installation-and-auth.md | markdown | 9.3 KB |
| references/installation-registration.md | markdown | 2.0 KB |
| references/mcp-connection.md | markdown | 3.3 KB |
| references/repair-recipes.md | markdown | 2.1 KB |
| references/review-and-recovery.md | markdown | 1.8 KB |
| references/tasks-and-results.md | markdown | 2.2 KB |
| references/uninstall-and-disconnect.md | markdown | 2.7 KB |
| references/updates-and-security.md | markdown | 5.9 KB |
| scripts/authorize.py | script | 61.1 KB |
| scripts/mcp_client.py | script | 86.4 KB |
| scripts/uninstall.py | script | 12.6 KB |
references/billing-errors-and-recovery.md
View on GitHub# Billing, errors, and recovery
Every generation tool consumes Beatra credits and creates an asynchronous task.
Use one logical request identity across transport uncertainty so recovery cannot
accidentally create or charge a duplicate task.
## Submit a billable request
1. Assemble the final generation arguments.
2. Generate one opaque `client_request_id`.
3. Submit exactly once.
4. Store both `client_request_id` and the returned `task_id`.
5. Poll with `beatra.tasks.get`; do not resubmit while the task is queued or
running.
The prepaid amount accepted with the request can be an estimate. A successful
task is settled against authoritative measured usage. Read the terminal
`usage` and `billing` fields, and report net credits as
`billing.net_charged_credits`. Do not promise that the initial estimate
is the final charge.
## Run a batch
When one request becomes many paid calls (a list of items, a loop, or a
script):
1. Before the first paid call, price the whole batch from the live prices
(`beatra.models.list`, or `beatra.social.tools.get` for social data) and
tell the user the estimated total.
2. Let the first `insufficient_balance` stop the whole batch. Do not go on to
the next item; report which items finished and which did not.
3. Resume only the unfinished items, and only after the user says they have
topped up. A refused item keeps its `client_request_id` and arguments.
## Recover an uncertain response
- If no response arrived, make an identical retry with the same
`client_request_id` and exactly the same generation arguments.
- If any prompt, input artifact, model, output setting, or other generation
argument changes, treat it as new work and use a new `client_request_id`.
- If the task ID was lost, use `beatra.tasks.list` before considering a retry.
- If remote execution failed, report the terminal error. Start changed or newly
requested work only with a new request ID.
## Handle structured failures
- HTTP 401 authentication failure: do not replay the paid call automatically.
Run `python3 scripts/authorize.py` and follow its output
until it prints `Beatra is ready`, then recover with the original request
identity and unchanged arguments.
- Timeout, DNS/TLS, HTTP 429, HTTP 5xx, or another transport failure: preserve
the credential. If delivery of a paid call is uncertain, retry only with the
same `client_request_id` and exactly the same arguments after connectivity
recovers.
- Insufficient scope: explain that the active connection lacks required access;
run `python3 scripts/authorize.py --force` only after the
user explicitly chooses to reconnect the full Beatra authorization. Never ask
for a media-specific grant.
- Insufficient balance (error code `insufficient_balance`): relay the returned
message to the user — it already carries the facts that matter: nothing was
charged, the top-up link, credits take effect immediately, and the same
request can be retried as-is. Translate into the user's language but keep
the URL exactly as returned. Stop all remaining paid work, including the
rest of a batch, and do not retry until the user says they have topped up.
A successful task can also leave a negative balance when actual measured
usage exceeded the estimate; the output remains valid, but new billable
work must wait for a top-up.
- After that refusal, `scripts/mcp_client.py` holds further calls to the same
tool on this computer: it answers them with the same message and sends
nothing (`details.local_hold`). Its `details.agent_note` names the balance
check that lifts the hold once the user says they have topped up. If the user
chose a cheaper request instead, run that cheaper call once with
`--recheck-balance`. Never put `--recheck-balance` in a loop or script.
- Some refusals also name another way forward (`details.recovery.alternative`;
the message states it in words). Relay it in the message's words with the
top-up option and do not call again on your own. Choosing it is new work, not
a retry: submit the request it describes once, with a new
`client_request_id`; `charges_now_credits` is what that submission charges.
When it is 0, the user's choice is the approval; above 0, show a card with
that price first.
Choosing it replaces the refused request: drop that request and its
`client_request_id`, never replay it after a later top-up, and continue from
the new request's result.
When its result waits for the user (for example a voice with status
`pending_activation` and its activation price), present the result and its
price, and continue only after the user agrees. This applies even where a
production card's balance line says only to wait for a top-up. The bundled
client does not hold the tool after a refusal that carries `details.offer`,
such as the free voice preview.
- Idempotency conflict: the request identity was reused with different
arguments. Do not retry it. Keep the original task if it exists, or use a new
`client_request_id` only for user-approved changed work.
- Rate or concurrency limit: honor the returned retry delay, then retry the
exact same arguments with the same request identity. Do not create a
replacement task.
- Validation failure or model incompatibility: call `beatra.models.list` for current
constraints, correct the invalid arguments, and use a new
`client_request_id` because the generation inputs changed.
- Upload expiration, MIME mismatch, or byte-length mismatch: request a fresh
grant and upload the unchanged file again. Never reuse a consumed or expired
grant.
- Remote execution failure: preserve the Beatra error code and task ID;
report only the failure classification and billing/refund fields returned by
Beatra. Do not infer a different cause or promise a refund that is not shown.
Never expose authentication tokens, complete private prompts, or sensitive
input content while explaining recovery.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |