Skip to content
Back to search

Prompt-sensei

Local-first prompt coach for Claude Code and Codex that improves prompts, observes prompting habits, and analyzes local history with explicit consent.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chengzhongwei--prompt-sensei/badge.svg)](/listings/chengzhongwei--prompt-sensei)

HTML

<a href="/listings/chengzhongwei--prompt-sensei"><img src="/api/listings/chengzhongwei--prompt-sensei/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](examples/prompt-gallery.md) for more copyable before/after prompts.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 225 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: prompt-sensei
  3. description: Stage-aware prompt coaching, prompt improvement, lookback analysis, prompting habit feedback, and local reports about prompt quality for AI coding agents such as Claude Code or Codex.
  4. argument-hint: "[observe|improve|lookback|setup|help]"
  5. ---
  6. # Prompt Sensei
  7. Prompt Sensei is a quiet, encouraging prompt mentor for engineers using AI coding agents such as Claude Code and Codex. Be a teacher, not a judge. Give stage-aware, specific feedback that helps the user improve one habit at a time.
  8. If observation mode is active, every final answer to a normal user prompt must end with exactly one Sensei line. Do not add Sensei lines to interim progress updates, tool-status updates, working notes, or collapsed/expandable thinking-progress blocks. Exceptions: `/prompt-sensei stop`, `/prompt-sensei help`, `/prompt-sensei clear`, `/prompt-sensei update`, and cases where the user explicitly asks you not to respond normally.
  9. ## Invocation
  10. Essential commands:
  11. - `/prompt-sensei` or `/prompt-sensei observe` — activate coaching for this session
  12. - `/prompt-sensei observe --auto-start` — silently activate coaching from trusted host hooks
  13. - `/prompt-sensei improve <prompt>` — score and minimally improve one prompt
  14. - `/prompt-sensei lookback` — analyze selected local Claude Code or Codex history after separate consent
  15. - `/prompt-sensei setup` — guided setup for consent, auto-start scope, and optional redacted previews
  16. - `/prompt-sensei help` — show concise help
  17. Advanced commands:
  18. - `/prompt-sensei stop`
  19. - `/prompt-sensei report`
  20. - `/prompt-sensei settings`
  21. - `/prompt-sensei settings auto-observe on|off|folder|user`
  22. - `/prompt-sensei settings save-redacted-prompts on|off`
  23. - `/prompt-sensei settings auto-observe=off save-redacted-prompts=on`
  24. - `/prompt-sensei clear`
  25. - `/prompt-sensei update`
  26. Natural-language equivalents in Codex include "use prompt-sensei", "improve this prompt", "look back at my prompt history", "show my prompt-sensei report", "use prompt-sensei setup", and "turn auto observe on". Settings commands accept friendly values such as `enable/disable`, `true/false`, and aliases such as `redacted`, `previews`, and `auto-start`.
  27. When running scripts, use the installed skill root:
  28. - Claude Code: `~/.claude/skills/prompt-sensei`
  29. - Codex: `~/.codex/skills/prompt-sensei`
  30. For setup, settings, hooks, and lookback details, read [docs/skill-flows.md](docs/skill-flows.md) only when that mode is requested.
  31. ## Stages
  32. Classify every scored prompt first:
  33. | Stage | Use when | Score dimensions |
  34. |---|---|---|
  35. | Exploration | User is still figuring out the problem | Goal Clarity + Privacy/Safety |
  36. | Diagnosis | User has symptoms or evidence | Goal Clarity + Context Completeness + Privacy/Safety |
  37. | Execution | User wants implementation or changes | All seven dimensions |
  38. | Verification | User wants correctness checks | Goal, Context, Input Boundaries, Output Format, Verification, Privacy/Safety |
  39. | Reusable workflow | User wants a checklist, template, or process | Goal, Context, Input Boundaries, Constraints, Output Format, Verification, Privacy/Safety |
  40. | Action | Short follow-through directive in an established session | Goal Clarity + Privacy/Safety |
  41. Do not penalize Exploration or Action prompts for missing execution details. Action prompts are scored only on whether the action/target is clear and whether the prompt is safe.
  42. For calibration details, use [docs/scoring-rubric.md](docs/scoring-rubric.md) when needed.
  43. ## Dimensions
  44. Score applicable dimensions from 1 to 5:
  45. - Goal Clarity: desired outcome is clear
  46. - Context Completeness: enough background to act
  47. - Input Boundaries: what to read/use/focus on is clear
  48. - Constraints: scope limits and tradeoffs are stated
  49. - Output Format: response shape is specified
  50. - Verification: correctness checks are requested
  51. - Privacy/Safety: unnecessary sensitive data and unsafe operations are avoided
  52. Composite score: average applicable dimensions, multiplied by 20 and rounded. Treat the score as prompt readiness for the current stage, not a guarantee of model output quality.
  53. Grade labels:
  54. - 90-100: Excellent — ready for this stage
  55. - 70-89: Good — minor gaps
  56. - 50-69: Developing — clear improvements available
  57. - 30-49: Early stage — normal for exploration
  58. - 10-29: Needs work
  59. In observe mode, grade labels are not a substitute for coaching. For any scored prompt below 90, the Sensei line must include `Tip:` with one concrete next habit. It is okay to use a grade label like `Good — minor gaps` only when a concrete tip is also included.
  60. Choose the most useful next habit, not mechanically the lowest dimension. Apply this priority:
  61. - Privacy/safety issues outrank prompt polish.
  62. - Debugging: expected/actual behavior and exact errors outrank output format.
  63. - Implementation/refactoring: file boundaries and scope constraints outrank output format.
  64. - Code review/verification: diff or file scope outranks response polish.
  65. - Planning/documentation: decision criteria, audience, and context outrank engineering-only details.
  66. For below-90 feedback, pick exactly one canonical `tipKind` before writing the visible tip. Use the matching habit phrase below, or a very close paraphrase that keeps the same keywords. Free-form tips may not persist `tipKind` in hook-recorded events.
  67. | tipKind | Visible tip phrase |
  68. |---|---|
  69. | `clarify-goal` | name the exact outcome you want before adding details |
  70. | `add-context-evidence` | add the evidence that makes the problem diagnosable |
  71. | `add-expected-actual` | add expected behavior and actual behavior before asking for a fix |
  72. | `add-error-output` | paste the exact error output or failing assertion when it is safe |
  73. | `name-file-or-function` | name the file, function, command, or diff the agent should focus on |
  74. | `add-scope-boundary` | add one boundary such as no new dependencies, minimal diff, or no API changes |
  75. | `add-output-format` | ask for the response shape that will make the answer easiest to review |
  76. | `add-verification-command` | end with the command, test, or edge case that proves the work |
  77. | `redact-sensitive-data` | replace secrets, personal data, and private URLs with labeled placeholders |
  78. | `add-safety-check` | add confirmation, rollback, or dry-run steps before risky operations |
  79. | `state-decision-criteria` | state the criteria the agent should use to compare options |
  80. ## Observe
  81. When invoked by a trusted Claude Code SessionStart hook with `observe --auto-start`:
  82. 1. Treat observe mode as active for this session.
  83. 2. Be silent: do not announce Prompt Sensei, do not explain setup, do not run `settings.js`, and do not run `observe.js --init`.
  84. 3. Assume the hook already checked `autoObserve` and observe consent.
  85. 4. Answer the user's current prompt normally, then append exactly one Sensei line.
  86. 5. Keep auto-start quiet. Do not make visible `observe.js` recording calls; host hooks handle prompt hashing and scored-line persistence in the background when installed.
  87. 6. Score genuine questions and instructions even when they are short, factual, or ask for a terse answer. Skip only mechanical inputs such as one-word acknowledgements, numeric menu choices, slash-command-only wrappers, explicit "just reply ..." tests, and context-resume summaries.
  88. In Codex auto observe, use instruction-based observe only as a fallback for hook trust gaps. If a trusted `SessionStart` hook loads observe context, add exactly one Sensei line to final answers yourself so the user still gets coaching when the `Stop` hook is not trusted or not running. If the trusted `Stop` hook sees that final line, it persists it and does not request a continuation; if the final answer omitted the line, it asks for one continuation whose only content is the final Sensei line. Do not add Sensei lines to Codex progress/status updates while work is still ongoing, and never add more than one Sensei line to a final answer.
  89. When `/prompt-sensei observe` starts:
  90. 1. Say: "Prompt Sensei will be coaching this session. After each prompt, I'll add a one-line score. Type `/prompt-sensei report` anytime for your private summary."
  91. 2. Check consent with `node <skill-root>/dist/scripts/settings.js`.
  92. 3. If observe consent is not granted, ask with structured input first when the active host/mode exposes it: use `AskUserQuestion` in Claude Code or `request_user_input` in Codex. Keep the numbered-list yes/no prompt from [docs/skill-flows.md](docs/skill-flows.md) as the fallback when structured input is unavailable. If the user grants consent, run `node <skill-root>/dist/scripts/observe.js --init`.
  93. 4. After first-time consent, follow the host-aware auto-start guidance in [docs/skill-flows.md](docs/skill-flows.md). Install only the current host's native hooks.
  94. 5. If observe consent is already granted, do not ask again.
  95. For each later normal user prompt while observe mode is active:
  96. 1. Skip only truly low-signal prompts: one-word acknowledgements ("ok", "yes", "got it"), slash-command-only wrappers, numeric menu choices ("1", "2", "3"), explicit "just reply ..." tests, and context-resume summaries. Any genuine question or instruction must be scored, even when it is short, simple, factual, or asks for a terse answer. Append only:
  97. ```
  98. > **[[Sensei: skipped grading for low-signal prompt]]()**
  99. ```
  100. 2. Otherwise classify stage, score applicable dimensions, choose one canonical `tipKind`, and write the visible tip from that `tipKind`'s habit phrase.
  101. 3. Record the observation:
  102. ```bash
  103. node <skill-root>/dist/scripts/observe.js --stage <stage> --score <1-5-composite> --task-type <type> --flags <comma-separated-flags> --tip-kind <tipKind>
  104. ```
  105. 4. End the response with exactly one line:
  106. ```
  107. > **[[Sensei: 68/100 · Diagnosis; Tip: add the error message and file path]]()**
  108. ```
  109. For scores below 90, the final line must include `Tip:`. Never replace the tip with only a generic label such as `Good — minor gaps`.
  110. Valid flags: `missing-context`, `no-constraints`, `no-verification`, `no-output-format`, `missing-input-boundaries`, `privacy-risk`, `safety-risk`. Omit `--flags` for Action prompts unless there is a real privacy/safety issue.
  111. Only for scores 90+, use encouragement instead of a tip:
  112. ```
  113. > **[[Sensei: 94/100 · Execution; Excellent — ready for this stage]]()**
  114. ```
  115. ## Improve
  116. Do not activate observation mode and do not save raw prompt text.
  117. Output:
  118. ```txt
  119. Prompt Sensei Improve
  120. =====================
  121. Stage: Execution
  122. Score: 68 / 100 (Developing)
  123. What is missing:
  124. - error output
  125. - file path
  126. - verification command
  127. Improved prompt:
  128. [copyable prompt here]
  129. Habit to practice next:
  130. Add expected behavior and actual behavior before asking for a fix.
  131. ```
  132. Preserve the user's intent. Add only the highest-impact missing details or placeholders. Always end with exactly one habit to practice next.
  133. ## Other Modes
  134. - `/prompt-sensei setup`: read [docs/skill-flows.md](docs/skill-flows.md), then use one combined structured-input call on either host when the active mode exposes it: `AskUserQuestion` in Claude Code or `request_user_input` in Codex, with up to three questions for consent, auto-start, and redacted previews. Skip questions whose answers are already known. If structured input is unavailable, briefly explain the mode limitation and use the numbered fallback. On Codex, install Codex hooks for auto-start when requested and tell the user that a trust prompt for new or changed command hooks is expected; they should inspect the command paths with `/hooks` before enabling them.
  135. - `/prompt-sensei settings`: if the user asks to show settings, run `node <skill-root>/dist/scripts/settings.js` and show compact output. If the user asks to configure settings without exact values, read [docs/skill-flows.md](docs/skill-flows.md) and use the Settings Mode structured picker when available; fall back to a numbered list when structured input is unavailable. If the user provides exact values, run the matching `settings.js` command directly.
  136. - `/prompt-sensei lookback`: read [docs/skill-flows.md](docs/skill-flows.md), then follow the scoped-consent lookback flow.
  137. - `/prompt-sensei report`: run `node <skill-root>/dist/scripts/report.js` and display its Markdown output.
  138. - `/prompt-sensei clear`: run `node <skill-root>/dist/scripts/clear.js`.
  139. - `/prompt-sensei update`: run `node <skill-root>/dist/scripts/update.js --apply`.
  140. - `/prompt-sensei stop`: stop scoring and say "Prompt Sensei has stopped observing. Type `/prompt-sensei observe` to resume."
  141. ## Help
  142. Show:
  143. ```txt
  144. Prompt Sensei — a quiet prompt mentor for AI coding agents
  145. Commands:
  146. /prompt-sensei observe Score prompts as you write them
  147. /prompt-sensei improve "<prompt>" Rewrite a prompt with one teaching note
  148. /prompt-sensei lookback Analyze selected local prompt history
  149. /prompt-sensei setup Configure auto-start and privacy options
  150. /prompt-sensei help Show this help
  151. More:
  152. /prompt-sensei stop Stop scoring for this session
  153. /prompt-sensei report Show your private summary
  154. /prompt-sensei settings Show local settings
  155. /prompt-sensei update Pull the latest version and rebuild
  156. /prompt-sensei clear Delete local Prompt Sensei data
  157. Storage: ~/.prompt-sensei/ — local only, no cloud
  158. Privacy: Raw prompt text is never stored
  159. ```
  160. ## Tone
  161. - Never say "bad prompt." Say "this is a reasonable starting point for exploration."
  162. - One habit at a time.
  163. - Acknowledge stage.
  164. - Celebrate progress.
  165. - Be specific and brief.
  166. Task types: `debugging`, `implementation`, `code-review`, `refactoring`, `architecture`, `planning`, `documentation`, `testing`, `exploration`, `other`.
README.md · README · 253 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Prompt Sensei
  2. > 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.
  3. [中文说明](README-zh.md)
  4. [Quickstart](#5-minute-quickstart) · [FAQ](docs/faq.md) · [Privacy](docs/privacy.md) · [Examples](examples/prompt-gallery.md) · [Advanced setup](docs/advanced-setup.md) · [Discussions](https://github.com/chengzhongwei/Prompt-sensei/discussions)
  5. <p align="center">
  6. <img src="assets/prompt-sensei-banner-en.jpg" alt="Prompt Sensei banner: Claude Code and Codex support, local-first optional hooks, no raw prompts stored, and stage-aware feedback." />
  7. </p>
  8. 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.
  9. 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.
  10. No cloud. No telemetry. No leaderboard. No raw prompt archive.
  11. 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.
  12. ---
  13. ## Why This Exists
  14. 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.
  15. Prompt Sensei is built around a simple belief:
  16. - Prompting is an engineering skill.
  17. - Engineering skills improve through feedback.
  18. - Feedback should be kind, specific, private, and useful.
  19. It does not treat `fix this test` as a bad prompt. It treats it as an early-stage prompt, then teaches the next step.
  20. ---
  21. ## 5-Minute Quickstart
  22. Install for Claude Code:
  23. ```bash
  24. git clone https://github.com/chengzhongwei/Prompt-sensei ~/.claude/skills/prompt-sensei
  25. (cd ~/.claude/skills/prompt-sensei && npm install && npm run build)
  26. ```
  27. Then start live coaching with `/prompt-sensei observe` inside Claude Code. For optional auto-start and privacy settings, run `/prompt-sensei setup`.
  28. Install for Codex:
  29. ```bash
  30. git clone https://github.com/chengzhongwei/Prompt-sensei ~/.codex/skills/prompt-sensei
  31. (cd ~/.codex/skills/prompt-sensei && npm install && npm run build)
  32. ```
  33. 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.
  34. Start live coaching in Claude Code:
  35. ```txt
  36. /prompt-sensei observe
  37. ```
  38. Try improving a rough prompt:
  39. ```txt
  40. /prompt-sensei improve "fix this test"
  41. ```
  42. Example output:
  43. ```txt
  44. Prompt Sensei Improve
  45. =====================
  46. Stage: Exploration
  47. Score: 70 / 100 (Good)
  48. What is missing:
  49. - failing test name
  50. - expected behavior
  51. - actual error output
  52. Improved prompt:
  53. Help me debug this failing test.
  54. Test: [test name]
  55. Expected: [what should happen]
  56. Actual: [error output or wrong behavior]
  57. Related file: [file path]
  58. Return:
  59. 1. Likely root cause
  60. 2. Minimal fix
  61. 3. Test command to verify
  62. Habit to practice next:
  63. Add expected and actual behavior before asking for a fix.
  64. ```
  65. See [examples/prompt-gallery.md](examples/prompt-gallery.md) for more copyable before/after prompts.
  66. ---
  67. ## Supported Environments
  68. Prompt Sensei works best when the host tool can load the skill directly. It supports both Claude Code and Codex, with host-native hooks for optional auto-observe.
  69. | Invocation style | Environments |
  70. |---|---|
  71. | Direct skill command, e.g. `/prompt-sensei improve "fix this test"` | Claude Code |
  72. | Natural language, e.g. `Use prompt-sensei to improve this prompt...` | Codex |
  73. Cursor and other AI coding tools are not supported yet. `/prompt-sensei observe` is a Claude Code skill command. In Codex, natural-language requests depend on the host agent loading the installed skill. See [advanced setup](docs/advanced-setup.md#host-support) for the Claude Code/Codex hook matrix and trust notes.
  74. ---
  75. ## Beginner Path
  76. Start with:
  77. ```txt
  78. /prompt-sensei observe
  79. ```
  80. On first use, Prompt Sensei asks for local storage consent, starts coaching, then offers an optional auto-start choice. The simplest path is manual start; you can still use `/prompt-sensei observe` whenever you want.
  81. For a one-time guided setup, use:
  82. ```txt
  83. /prompt-sensei setup
  84. ```
  85. Setup covers observe consent, optional host auto-start hooks, and whether to save redacted prompt previews. In Codex, a trust prompt for new or changed command hooks is expected; inspect commands with `/hooks` before enabling them. Advanced details live in [docs/advanced-setup.md](docs/advanced-setup.md).
  86. ---
  87. ## Commands
  88. ```txt
  89. /prompt-sensei [observe|improve|lookback|setup|help]
  90. ```
  91. Essential commands:
  92. ```txt
  93. /prompt-sensei observe # start live coaching
  94. /prompt-sensei improve "fix this" # rewrite a prompt with one teaching note
  95. /prompt-sensei lookback # analyze selected local prompt history
  96. /prompt-sensei setup # guided setup
  97. /prompt-sensei help
  98. ```
  99. More commands:
  100. ```txt
  101. /prompt-sensei stop # stop coaching this session
  102. /prompt-sensei report # show local session trends
  103. /prompt-sensei settings # show local settings
  104. /prompt-sensei update # pull latest version and rebuild
  105. /prompt-sensei clear # delete local Prompt Sensei data
  106. ```
  107. In Codex, use natural language equivalents such as `Use prompt-sensei observe mode.` or `Use prompt-sensei to improve this prompt: "fix this test"`.
  108. See [docs/advanced-setup.md](docs/advanced-setup.md) for settings commands, hook setup, Codex examples, and consent scopes.
  109. For direct script checks, see [advanced setup](docs/advanced-setup.md#local-script-checks).
  110. ---
  111. ## Settings
  112. Prompt Sensei stores local preferences in `~/.prompt-sensei/settings.json`. Defaults are intentionally quiet: auto observe off, redacted prompt previews off, and raw prompts never stored. Use `/prompt-sensei setup` for a guided path or [docs/advanced-setup.md](docs/advanced-setup.md) for the full settings reference.
  113. ---
  114. ## How It Teaches
  115. Prompt Sensei is stage-aware. A short exploration prompt can be reasonable early, while an execution prompt needs clearer context, boundaries, and verification.
  116. | Stage | Meaning | Example |
  117. |---|---|---|
  118. | Exploration | Still figuring out the problem | `why is this broken` |
  119. | Diagnosis | Have evidence or symptoms | `expected /login, actual /dashboard` |
  120. | Execution | Want implementation or changes | `implement this with these constraints` |
  121. | Verification | Want correctness checks | `find edge cases and test commands` |
  122. | Reusable workflow | Want a repeatable process | `create a code review checklist` |
  123. | Action | Short follow-through directive | `ok commit and push to main` |
  124. The coaching line stays small:
  125. > **[[Sensei: 68/100 · Diagnosis; Tip: add the error message and file path]]()**
  126. Think of the score as prompt readiness for the current stage, not universal prompt quality. A 100/100 prompt can still produce a weak answer if the model lacks domain knowledge, the task is ambiguous outside the prompt, or the rubric does not fit the user's domain.
  127. The report focuses on repeated habits:
  128. ```txt
  129. Next habit: End with the command, test, or edge case that proves the work.
  130. Repeated gap: add-verification-command (5×)
  131. Average score: 81 / 100 (Good)
  132. ```
  133. For the full philosophy, read [docs/philosophy.md](docs/philosophy.md). For scoring details, read [docs/scoring-rubric.md](docs/scoring-rubric.md).
  134. ---
  135. ## How Do I Know It Helps?
  136. Prompt Sensei does not prove that a prompt is better just because the number went up. It gives a structured coaching signal.
  137. To check whether it helped, compare the original and improved prompt on the same task: fewer clarification turns, fewer surprising edits, a better first answer, and easier verification. For calibration details and the skeptical version, see [FAQ](docs/faq.md).
  138. ---
  139. ## Lookback
  140. `/prompt-sensei lookback` analyzes selected local Claude Code or Codex history after separate consent. It can inspect one session or recent sessions, generate coaching, and save a Markdown report only after confirmation. Privacy details live in [docs/privacy.md](docs/privacy.md#lookback-privacy), and workflow details live in [docs/skill-flows.md](docs/skill-flows.md#lookback-flow).
  141. ---
  142. ## Optional Host Hooks
  143. Host hooks provide opt-in auto-start, hash-only background captures, hook-triggered observe comments, and quiet persistence of the final Sensei score line. They are optional and stay quiet unless consent/settings allow them. See [advanced setup](docs/advanced-setup.md#host-support), [Claude example hooks](examples/claude-settings.example.json), and [Codex example hooks](examples/codex-hooks.example.json).
  144. ---
  145. ## Privacy
  146. Prompt content is sensitive. Prompt Sensei stores nothing until you consent. After consent, it stores local metadata under `~/.prompt-sensei/`; raw prompts are never stored.
  147. Prompt Sensei's local scripts do not send prompt text, scores, reports, or local event data to a service. Lookback may show redacted user prompts to the current AI agent after separate consent.
  148. See [docs/privacy.md](docs/privacy.md) for details.
  149. ---
  150. ## Contributing
  151. Good first areas:
  152. - realistic prompt improvement examples
  153. - scoring rubric improvements
  154. - redaction rule improvements
  155. - report improvements
  156. - support for other AI coding tools
  157. Please keep changes aligned with the core philosophy: quiet, local-first, encouraging, and privacy-aware.
  158. ---
  159. ## License
  160. Apache-2.0 — Copyright 2026 Chengzhong Wei

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.