Prompt Sensei

Prompting is becoming one of the most important engineering skills in the AI era. Prompt Sensei helps you improve your prompts while teaching you how to improve.

中文说明

Quickstart · FAQ · Privacy · Examples · Advanced setup · Discussions

Prompt Sensei is a quiet, local-first prompt coach for Claude Code and Codex. It gives stage-aware feedback, rewrites rough prompts into better ones, looks back on local history when you ask, and helps you practice one habit at a time.

It is built as a real host-integrated skill, not just a markdown rubric: Prompt Sensei supports hook-based observe comments, opt-in auto-observe hooks, hash-only prompt captures, quiet Stop-hook persistence, and compact-safe continuity where the host exposes the lifecycle events.

No cloud. No telemetry. No leaderboard. No raw prompt archive.

Prompt Sensei's score is a coaching signal, not an objective grade or a guarantee of better output. The real test is whether the improved prompt produces a more useful first draft, fewer clarification turns, safer agent behavior, and easier verification.

---

Why This Exists

AI coding agents do real work: they edit files, run commands, and make implementation choices. A vague prompt does not just produce a vague answer; it can produce broad edits, hidden assumptions, and extra revision loops.

Prompt Sensei is built around a simple belief:

• Prompting is an engineering skill.
• Engineering skills improve through feedback.
• Feedback should be kind, specific, private, and useful.

It does not treat fix this test as a bad prompt. It treats it as an early-stage prompt, then teaches the next step.

---

5-Minute Quickstart

Install for Claude Code:

git clone https://github.com/chengzhongwei/Prompt-sensei ~/.claude/skills/prompt-sensei
(cd ~/.claude/skills/prompt-sensei && npm install && npm run build)

Then start live coaching with /prompt-sensei observe inside Claude Code. For optional auto-start and privacy settings, run /prompt-sensei setup.

Install for Codex:

git clone https://github.com/chengzhongwei/Prompt-sensei ~/.codex/skills/prompt-sensei
(cd ~/.codex/skills/prompt-sensei && npm install && npm run build)

Then ask Codex in natural language: Use prompt-sensei observe mode. For optional hook-based auto-start, run npm run setup-hooks -- auto-observe folder or use /prompt-sensei setup after the skill is loaded.

Start live coaching in Claude Code:

/prompt-sensei observe

Try improving a rough prompt:

/prompt-sensei improve "fix this test"

Example output:

Prompt Sensei Improve
=====================
Stage:    Exploration
Score:    70 / 100  (Good)

What is missing:
  - failing test name
  - expected behavior
  - actual error output

Improved prompt:
  Help me debug this failing test.

  Test: [test name]
  Expected: [what should happen]
  Actual: [error output or wrong behavior]
  Related file: [file path]

  Return:
  1. Likely root cause
  2. Minimal fix
  3. Test command to verify

Habit to practice next:
  Add expected and actual behavior before asking for a fix.

See examples/prompt-gallery.md for more copyable before/after prompts.

---

Supported Environments