BetterPrompt Skill

This skill uses the BetterPrompt CLI (open-source by BetterPrompt.me) to:

• - Generate AI output (text, images, video)
• Install and manage BetterPrompt skills
• Search and discover BetterPrompt skills

Supports OpenClaw and popular agents.

CLI Installation

CODEBLOCK0

Authentication

Authenticate via browser:

CODEBLOCK1

Skill Discovery

CODEBLOCK2

Output Generation

A skill is essentially a prompt with instructions. Run the following command to generate output:

CODEBLOCK3

Input methods (use the one that matches the skill's input contract):

CODEBLOCK4

Flags:

CODEBLOCK5

The --json response includes a runId field used to retrieve outputs later.

Output Review

Retrieve outputs for a specific run:

CODEBLOCK6

List past outputs:

CODEBLOCK7

Output types:

Type	Value
TEXT	"text"
IMAGE

"image" |
| ERROR | "error" |
| VIDEO | "video" |

Skill Management

Install, uninstall, list, and update prompt skills:

CODEBLOCK8

Global Flags

These flags work on most commands:

CODEBLOCK9

Resources

Fetch available models and their supported options (e.g., aspect ratio, resolution, reasoning effort):

CODEBLOCK10

Agent Instructions

Skill Installation

The --agent flag specifies which agent to install/uninstall a prompt skill into. Use your own agent name if you know it (e.g., --agent openclaw for OpenClaw, --agent claude for Claude). If you don't know which agent you are, ask the human.

• - Install supports multiple agents: INLINECODE5
• Uninstall accepts one agent or --agent "*" to remove from all

Supported agents: agents, openclaw, cursor, claude, windsurf, antigravity.

Execution Pipeline

Run these steps in order. Early steps can be skipped if the user's goal is already satisfied (e.g., discovery only stops after Search).

Always use --json flag on every command for machine-readable output.

1. 1. Search — INLINECODE14
2. Inspect — INLINECODE15
3. Fetch resources — INLINECODE16
4. Validate from INLINECODE17
5. Present execution choices:

• - required inputs in the skill.md
• default model
• default model's options
• other supported models

1. 6. Execute — INLINECODE18
2. Poll if needed — INLINECODE19

After a successful generation, always ask the human if they want to install the skill for future use (see Skill Installation). Do not skip this step.

If any step fails due to transient error, retry once. If a step is blocked (missing input, API failure, user pause), return the best available result from completed steps without waiting for the full pipeline.

Skill Selection Rubric

When multiple skills match, prefer higher score on:

1. 1. Intent match to user request
2. Input contract clarity in skillmd
3. Output predictability/repeatability
4. Fewer ambiguous runtime options

If tied, pick the skill with clearer skillmd run instructions.

Failure and Timeout Handling

• - Show key error directly; provide one corrective action
• Retry once if safe and likely to succeed
• If timeout returns a runId, report it and offer betterprompt outputs <run-id> --sync as follow-up
• If blocked by CLI version, upgrade CLI then rerun full pipeline

OpenClaw Instructions

Post-Install Session Reset

After installing a skill with betterprompt skill install, suggest the human reset their session so the newly installed skill is loaded by OpenClaw.

Channel Display Rules

All content returned to users must render natively in their channel platform. Never send raw URLs, raw JSON, or unformatted dumps. The rules below apply to every content type the agent presents: search results, skill details, generation outputs, and resources.

Platform-Specific Image Rendering

Never send an image URL as plain text — always use the platform's native image mechanism so the image displays inline in the chat. The URL must be publicly accessible over HTTPS.

Platform	Method	Key Details
Discord	Embed with INLINECODE23	Bare URLs may not unfurl reliably; always use embeds
Slack

Block Kit image block | image_url + alt_text (required); URL unfurling depends on workspace settings |
| Telegram | sendPhoto Bot API method | sendMessage with a URL does not render images; URL in photo param |
| Microsoft Teams | Adaptive Card Image element | "type": "Image", "url": "…"; bare URLs render as links, not images; HTTPS required |
| WhatsApp | Messages API with "type": "image" | image.link; PNG/JPG only, max 5 MB, valid SSL + Content-Type headers required |

• - If the URL is behind auth or ephemeral, download the image first and upload it as a direct attachment
• If multiple image URLs are returned, send each as a separate image message

Platform-Specific Text & Rich Content

Platform	Formatting	Lists / Tables	Code Blocks
Discord	Markdown (bold, italic, headers, links)	Numbered/bulleted lists; no native tables — use code block alignment	INLINECODE34`lang fenced blocks
Slack

mrkdwn (*bold*, _italic_, <url\|text>) | Bulleted with •; numbered manually; no native tables — use Section blocks or code | ` blocks (no language hint) | | Telegram | MarkdownV2 or HTML (<b>, <i>, <a>, <code>) | Manual numbered/bulleted; no native tables — use <pre> aligned columns | <pre> or ` | | Microsoft Teams | Subset of HTML + Adaptive Cards | Adaptive Card FactSet for key-value; TextBlock with markdown for lists | <pre><code> or Adaptive Card CodeBlock | | WhatsApp | Limited: *bold*, _italic_, ~strike~, `mono` | Manual numbered/bulleted only; no rich formatting for tables | ` blocks (no language hint) |

Search Results (item list)

Present each skill as one message — do not split a single skill across multiple messages:

• - Number items (1., 2., …) with <title> + <short description> in the same message
• If sample output is an image URL → render inline using platform image method (see table above) with numbered caption
• If sample output is text → quote block (> <sample text> or platform equivalent)
• If no sample output → include "No sample output available." in the item message

Skill Details (info) / Execution Choices

When presenting skill info from betterprompt skill info:

• - Title + description as a header or bold line
• Required inputs

- List of text inputs: name, description, is required. E.g:

CODEBLOCK11

- List of image inputs: name, description, is required. E.g:

CODEBLOCK12

• - Default model and their available options E.g:

CODEBLOCK13

• - Other supported models as a model list. E.g: gpt-image-1, dall-e-3, ...

• - Sample output rendered inline (image or quoted text per platform rules)
• Keep it to one message; use the platform's rich formatting (embeds, cards, blocks) to structure sections visually

Generation Output

After a successful run, return exactly:

1. 1. Exact result — same content BetterPrompt returned, formatted for readability only
2. One next step — exactly one actionable suggestion

Fidelity rules:

• - Text: light formatting only (line breaks, short intro); preserve all content verbatim
• Images: render inline per platform image rules above
• Never invent, summarize away, or alter output content
• Do not include skill IDs, prompt version IDs, raw JSON, or internal logs unless explicitly asked

Resources

When presenting results from betterprompt resources --models-only:

• - Models list: formatted as a numbered list or compact table showing model name and provider
• Resource details: key-value pairs using the platform's native structured format (Discord embed fields, Slack section blocks, Teams FactSet, Telegram bold key + value)
• Keep it scannable — one message, no walls of text

 对齐列                                | 
 或                           |
| Microsoft Teams | HTML 子集 + Adaptive Cards                            | 键值对使用 Adaptive Card FactSet；列表使用带 markdown 的 TextBlock             | 
<