better-prompt SKILL.md skillA

better-prompt from huangwb8/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add huangwb8/skills/better-prompt@git:20260906.2ae9d47

Pins git:20260906.2ae9d47 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
huangwb8/skills
Path
skills/alpha/better-prompt/SKILL.md
Versions recorded
6
Latest version
git:20260906.2ae9d47, committed Sep 6, 2026
First version recorded
Aug 25, 2026
Size
15,824 bytes
Repository stars
50
License
MIT

当用户明确要求"优化 prompt"、"改进提示词"、"润色指令"、"将简陋 prompt 转换为最佳实践版本",或要求"把 prompt 改写成伪代码"、"翻译成程序结构/可编程自然语言"时使用。支持两种输出模式:standard(基于 OpenAI/Anthropic 官方最佳实践做增强优化)与 prompt_program(严格等价翻译为 Prompt Program 方言)。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Better Prompt - Prompt 优化器

## 目标

当用户明确要求"优化 prompt"、"改进提示词"、"润色指令"、"将简陋 prompt 转换为最佳实践版本",或要求"把 prompt 改写成伪代码"、"翻译成程序结构/可编程自然语言"时使用。

本技能提供两种输出模式:

- **standard(默认)**:增强导向。基于 OpenAI 和 Anthropic 官方最佳实践,对简陋 prompt 进行结构化补全,输出高质量版本;允许补充示例、上下文和约束。
- **prompt_program**:保真导向。将原始 prompt 严格等价翻译为 Prompt Program 方言——形式上像伪代码,语义上仍是人类自然语言;不新增无依据能力。

两种模式共享同一套语义分析内核(6 个语义原子),只差输出渲染方式。本技能不负责执行 prompt 对应的任务本身。

## 流程

### 输入

#### 输入要求

用户提供一个待优化的原始 prompt(可以是任意形式的简陋版本)。

### 执行步骤

#### 版本与兼容性

- **适用于**:Claude 3.x/4.x、GPT-4/5、Gemini 等主流 LLM
- **最佳实践来源**:OpenAI/Anthropic 官方文档(2026-02)
- **更新策略**:官方文档重大更新时同步修订

#### 不适用场景

以下情况不建议使用本技能:

- prompt 已经经过专业优化(评分 ≥ 8/10)
- 只需要诊断问题,不需要修改建议
- 超长 prompt(>10000 字)需要专业拆分
- 用户明确要求保持原始风格
- 用户只想执行任务,不关心 prompt 本身的质量或结构

#### 优化框架

standard 模式基于 **OpenAI** 和 **Anthropic** 官方最佳实践,采用五维度优化框架:

| 维度 | 检查点 | 优先级 |
|------|--------|--------|
| **清晰度** | 指令是否明确?是否存在歧义? | P0 |
| **完整性** | 是否缺少必要信息?上下文是否充分? | P0 |
| **结构化** | 是否使用 Markdown/XML 标签组织内容? | P1 |
| **示例性** | 是否提供输入输出示例(few-shot)? | P2 |
| **约束性** | 是否明确边界(做什么/不做什么)? | P2 |

> **注意**:上表的 P0/P1/P2 表示"优化维度的重要性优先级",与 config.yaml 中的 `dimensions` 数值(1-5)含义相同:P0=5(最高优先级)、P1=4、P2=3。

#### 输出模式选择
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add huangwb8/skills/better-prompt@sha256:c787f2604a884c06

The line at the top of this page pins the label git:20260906.2ae9d47, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_nsozbdjbv3tdbxl5.svg)](https://markdownregistry.com/a/art_nsozbdjbv3tdbxl5)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Aug 25, 2026 and Sep 6, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20260906.2ae9d47 latest2026-09-06 2ae9d47 15,824 BA view · diff
git:20260905.a346b912026-09-05 a346b91 9,352 BA view · diff
git:20260905.7c0ea7c2026-09-05 7c0ea7c 9,313 BA view · diff
git:20260905.8faacfe2026-09-05 8faacfe 8,686 BA view · diff
git:20260905.a39953d2026-09-05 a39953d 8,104 BA view · diff
git:20260825.4f192d92026-08-25 4f192d9 7,236 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15824 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

huangwb8/skills · 50 stars · license MIT · pushed 2026-10-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_nsozbdjbv3tdbxl5
GET https://markdownregistry.com/api/v1/resolve?ref=huangwb8/skills/better-prompt
GET https://markdownregistry.com/api/v1/blob/c787f2604a884c0607e96ae15b85edf51f7dd46ea8fd4825160d3ffcc267dfeb

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from huangwb8/skills

AGENTS.md AGENTS.md file
huangwb8/skills · AGENTS.md
git:20260912.90bbdcd · audit A · 50 stars
CLAUDE.md CLAUDE.md file
huangwb8/skills · CLAUDE.md
git:20260219.a2200bc · audit A · 50 stars
auto-draw-plot SKILL.md skill
huangwb8/skills · skills/alpha/auto-draw-plot/SKILL.md · 根据用户描述生成高质量绘图 prompt,并按通用、roadmap、schematic 模式通过 BenszAPI 直接完成 gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2 或…
git:20260910.448010a · audit A · 50 stars
auto-test-code SKILL.md skill
huangwb8/skills · skills/alpha/auto-test-code/SKILL.md · 当用户明确要求测试代码、代码审查或代码自检时使用。系统化发现并验证代码问题。⚠️ 不适用:用户只是想实现或优化功能、询问代码问题,或没有明确测试意图。
git:20260906.d2681a7 · audit A · 50 stars
auto-test-project SKILL.md skill
huangwb8/skills · skills/alpha/auto-test-project/SKILL.md · 当用户明确要求“测试项目”、 “运行 auto-test-project”或“进行项目级测试”时使用。对完整项目执行多轮 A 轮批判性测试与 B 轮质量检查,发现、记录、修复并验证问题。⚠️…
git:20260906.d5147b3 · audit A · 50 stars
auto-test-skill SKILL.md skill
huangwb8/skills · skills/alpha/auto-test-skill/SKILL.md · 当用户明确要求测试 Skill、运行 auto-test 或对 Skill 进行批判性测试时使用。系统化发现、记录并验证 Skill 问题。⚠️ 不适用:用户只是想开发或优化 Skill,或没有明确测试意图。
git:20260915.3df7249 · audit A · 50 stars
awesome-code SKILL.md skill
huangwb8/skills · skills/alpha/awesome-code/SKILL.md · 当用户明确要求使用 awesome-code、进行多代理协作或需要复杂任务规划时使用。它负责拆解任务、选择专业角色、设置门禁并审查结果;所有 Agent 的创建、隔离、串行或并行执行都必须交给 `parallel-vibe`。⚠️…
git:20261017.6ee9a5b · audit A · 50 stars
backend-specialist SKILL.md skill
huangwb8/skills · skills/alpha/awesome-code/agents/backend-specialist/SKILL.md · 后端开发专家。精通 Node.js/Python/Go/Rust 等后端技术栈,专注于 API 设计、数据库优化、认证授权、微服务架构和性能调优。用于后端服务开发、API 设计和系统架构。
git:20260905.a346b91 · audit A · 50 stars
brainstorming SKILL.md skill
huangwb8/skills · skills/alpha/awesome-code/agents/brainstorming/SKILL.md · 当用户明确要求"使用 brainstorming"或"使用 awesome-code"时使用。⚠️ 不适用:用户只是想优化/改进某个功能(应直接修改)、只是询问技能问题(应直接回答)、没有明确使用…
git:20260905.a346b91 · audit A · 50 stars
code-reviewer SKILL.md skill
huangwb8/skills · skills/alpha/awesome-code/agents/code-reviewer/SKILL.md · 用于审查已完成的工作、重大功能或合并前的变更,核对需求并按严重程度识别风险。未经审查不得合并。
git:20260906.d2681a7 · audit A · 50 stars
context-optimizer SKILL.md skill
huangwb8/skills · skills/alpha/awesome-code/agents/context-optimizer/SKILL.md · 上下文优化专家。专注于长对话中的上下文管理、token 效率和性能优化。解决 lost-in-middle、context poisoning 等问题,提升 AI 代理在复杂任务中的表现。
git:20260906.d2681a7 · audit A · 50 stars
devops-specialist SKILL.md skill
huangwb8/skills · skills/alpha/awesome-code/agents/devops-specialist/SKILL.md · DevOps 与运维专家。精通 CI/CD、容器化、编排、基础设施即代码、监控告警和自动化部署。用于构建高效、可靠的软件交付流水线和运维系统。
git:20260905.a346b91 · audit A · 50 stars

Every file in huangwb8/skills

Other files named better-prompt

better-prompt SKILL.md skill
davidondrej/skills · skills/thinking-and-docs/better-prompt/SKILL.md · Rewrite a prompt into a deeper version of the same task, the way a top professional would approach it. Use only when…
git:20261015.d23aac3 · audit A · 4,161 stars

Browse by kind, by grade A, or by owner.