What it does
This prompt instructs an expert editor to convert supplied bullet notes or fragmented ideas into polished, coherent prose that reads naturally while preserving the original meaning, intent, and logic exactly. The result is one or more clear, professional paragraphs that improve flow, grammar, transitions, and readability without adding, omitting, or reinterpreting any core information, and it outputs only the refined text with no commentary or extra formatting.
For more installation instructions go to https://raw.githubusercontent.com/BetterPromptme/skills/refs/heads/main/betterprompt/SKILL.md to check out this skill.
Inputs
textInputs
Pass each text input using --input <key>=<value> flags.
| Variable key | Required? | Description | Defaults |
|---|---|---|---|
BULLET_NOTES |
Required | Paste bullet notes here | (none) |
Models and options
This skill's modality is: text.
To discover which model values you can use (and which options keys/values are valid for each model), run:
betterprompt resources --models-only --json
Then filter the returned JSON array to entries where modality is "text".
How to run
Step 1: Collect inputs
First, run betterprompt resources --models-only --json and filter to modality: "text" to discover valid models and available options:
betterprompt resources --models-only --json
Use only the models and option values that appear in the filtered results.
Then collect all inputs from the human:
- Required text inputs:
BULLET_NOTES
- Optional: model and options.
- Present the human with the default model
gpt-5.2and its available options. Look upgpt-5.2in thebetterprompt resourcesoutput (filtered to modality"text") and show itsavailableOptionsas:key: val1, val2 (default), val3 | key2: .... Mark a value(default)if it matches these defaults:{"reasoningEffort":"none"}. - If the human does not specify, defaults are used: model
gpt-5.2, options{"reasoningEffort":"none"}. Other models from the resources call are also available.
- Present the human with the default model
If any required text input is missing, ask the human for what's missing. Do not assume or fabricate values.
Step 2: Run via BetterPrompt CLI
Use the frontmatter's name as the positional argument (for this skill, use bullet-to-polished).
Command form:
betterprompt generate bullet-to-polished \
[--input <key>=<value>] \
[--model <model>] \
[--options <options JSON>] \
[--json]
Notes:
- Pass each text input as a separate
--input <key>=<value>flag. - If the human does not mention a model, omit
--modeland BetterPrompt will use the default model:gpt-5.2. - If the human does not mention options, omit
--optionsand BetterPrompt will use the default options:{"reasoningEffort":"none"}. - If the run times out, the response will include a
runIdyou can use to fetch the result later.
Example (using defaults shown above):
betterprompt generate bullet-to-polished \
--input BULLET_NOTES=<value> \
--model gpt-5.2 \
--options '{"reasoningEffort":"none"}'