betterprompt

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

npm install -g betterprompt@latest
# or
bun install -g betterprompt@latest
# or
yarn global add betterprompt@latest
# or
pnpm add -g betterprompt@latest

Authentication

Authenticate via browser:

betterprompt login

Skill Discovery

betterprompt skill search "<query>"
betterprompt skill info <skill-slug>

Output Generation

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

betterprompt generate <skill-slug> [input flags] [--model <model>] [--options <json>] [--json]

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

# Key-value pairs (repeatable)
betterprompt generate <skill-slug> --input key=value --input key2=value2

# Image via URL
betterprompt generate <skill-slug> --image-input-url <url>

# Image via local file (auto-compressed)
betterprompt generate <skill-slug> --image-input-path <path>

# JSON payload (all inputs as a single JSON object)
betterprompt generate <skill-slug> --input-payload '{"key": "value"}'

# Stdin pipe
echo "input text" | betterprompt generate <skill-slug> --stdin

Flags:

--model <model>       override the default model for this skill
--options <json>      pass provider-specific model options as JSON
--json                output structured JSON (includes run-id, status, outputs)

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

Output Review

Retrieve outputs for a specific run:

betterprompt outputs <run-id>

List past outputs:

betterprompt outputs list

Output types:

Type	Value
TEXT	"text"
IMAGE	"image"
ERROR	"error"
VIDEO	"video"

Skill Management

Install, uninstall, list, and update prompt skills:

betterprompt skill install <skill-slug> --agent <name>
betterprompt skill uninstall <skill-slug> --agent <name>
betterprompt skill list
betterprompt skill update <skill-slug>

Global Flags

These flags work on most commands:

--project       scope to the current project (vs global)
--global        scope to global install
--dir <path>    use an explicit working directory
--json          structured JSON output (machine-readable)
--quiet         reduce non-essential output
-h, --help      show help for any command
-V, --version   show CLI version

Resources

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

betterprompt resources --models-only

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: --agent claude --agent cursor
• 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. Search — betterprompt skill search "<query>" --json
2. Inspect — betterprompt skill info <slug> --json
3. Fetch resources — betterprompt resources --models-only --json
4. Validate from skillmd
5. Present execution choices:

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

6. Execute — betterprompt generate <skill-slug> [input flags] --json
7. Poll if needed — betterprompt outputs <run-id> --sync --json

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. 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 image.url	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	```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:

    Inputs:
    
    - story_theme (required): The story theme
    - character_role (required): The character role
    

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

    ** Exactly 1 ** image(s)
    
    - image 1 (required): The character reference image
    

• Default model and their available options E.g:

  - Default model: gemini-3.1-flash-image-preview (default)
  - Available options: aspectRatio: 1:1 (default) / 16:9 / 9:16, resolution: 1024x1024 / 2048x2048
  

• 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. 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