beatra-ai/beatra-skills / plugins/ai-headshot-studio/skills/ai-headshot-studio
ai-headshot-studio
VerifiedTransform a casual selfie into a studio-quality professional headshot for LinkedIn, resume, company website, business card, or social media. This AI headshot generator creates polished professional portraits with new backgrounds, professional attire, and studio lighting while preserving the person's identity. Generate corporate headshots, tech startup portraits, academic profile photos, medical professional images, and creative industry portraits from one selfie. Specify a professional style and industry, pair with a desired background or setting, or refine an accepted headshot toward a publish-ready result.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.4 KB |
| install-source.json | config | 39 B |
| manifest.json | config | 5.0 KB |
| references/billing-errors-and-recovery.md | markdown | 5.8 KB |
| references/headshot-routing.md | markdown | 5.2 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/portrait-craft.md | markdown | 7.1 KB |
| references/review-and-recovery.md | markdown | 4.1 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 |
| references/workflow.md | markdown | 4.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/tasks-and-results.md
View on GitHub# Tasks and results
Generation returns an asynchronous task. Keep its `task_id` and use
`beatra.tasks.get` to poll it with bounded backoff: wait 2 seconds before the
first poll, then increase the interval toward 5, 10, and at most 15 seconds.
Honor `deadline_at` when the task response provides it. Otherwise stop active
polling after 30 minutes, report the task ID and current status, and explain
that the user or a later agent session can resume polling the same task.
## Interpret state
- `queued` and `running` are nonterminal. Continue polling; do not submit a
replacement generation.
- `succeeded`, `failed`, and `canceled` are terminal. Stop polling.
- On success, present returned artifacts, resolved model, actual usage, and
billing truth. For prepaid work, report `billing.net_charged_credits`; the gross charged value
may include a supplemental actual-usage debit and the refunded value may
return an unused request-time estimate.
- For a settled video task, `usage.video_seconds` is the authoritative
billable total. When present, `usage.input_video_seconds` and
`usage.output_video_seconds` are the authoritative components of that total.
This distinction matters for reference-video generation and video editing,
where both input and output can be billable. Do not infer either component
when Beatra returns it as `null`.
- On failure, preserve the structured error and apply the recovery reference.
Use `beatra.tasks.list` to recover a lost task ID or inspect recent work from
this connection. Filter only when doing so helps identify the task.
Call `beatra.tasks.cancel` only when the user requests cancellation. Before
remote execution starts, cancellation stops the task. After remote execution
starts, Beatra returns `canceled` only when the stop is confirmed. A `409`
means the task continues: do not promise a stop or refund, do not submit a
replacement, and continue polling the same task.
Do not infer an artifact URL, completion, usage, or charged credits from
elapsed time. Return only fields present in Beatra's task response.
For MCP task reads, prefer the direct `structuredContent.usage` and
`structuredContent.billing` objects; the complete envelope remains available
under `structuredContent.task`.
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 |