Skillsinsights-to-prompts

Insights To Prompts

Turn a Claude Code /insights report into before/after rewrites of the prompts that caused friction — both the prompts you type in sessions and the prompt text inside your own skills.

5 files and 419 lines, free under MIT. Built from arm-pz/insights-to-prompts at 432793c.

What it is for

Turn a Claude Code /insights report into before/after rewrites of the prompts that caused friction — both the prompts you type in sessions and the prompt text inside your own skills. Reads ~/.claude/usage-data (report.html, cached facets) plus session transcripts with a bundled script, ranks friction that better wording could have prevented, and rewrites the worst offenders.

Reach for it when

  • The user says "improve my prompts from insights", "what am I prompting badly", "turn my insights report into better prompts", "coach my Claude Code prompting", or "why does Claude keep misreading me".

Not for

  • Adding rules to CLAUDE.md, hooks or settings (use harness-audit)
  • Rewriting one prompt pasted in chat with no report behind it (use a sharpen-prompt skill)
  • Building a new skill from prompts (use prompts-to-skill)

Know what you are installing.

Version, date and limits are read from the repo on every sync, and the check runs every night. Real-world runs are listed only with their evidence.

Version
Unversionedcommit 432793c
Updated
Not recorded yet
Works in
Claude Code, Codex, Cursor, Qoder and any agent that loads a SKILL.mdplain text; no API keys
Nightly check
Not checked yetIt joins the nightly check after its first run. How it is checked
Last real-world run
No public run yetRuns are published only with their evidence.
Known limits
Not built for:
  • Adding rules to CLAUDE.md, hooks or settings (use harness-audit)
  • Rewriting one prompt pasted in chat with no report behind it (use a sharpen-prompt skill)
  • Building a new skill from prompts (use prompts-to-skill)

Every file it installs

Measured from the packed archive at commit 432793c. A skill is plain text your agent reads, so this list is all of it.

FileLinesBytes
SKILL.md524,349 B
references/digest-format.md131,279 B
references/rewrite-rules.md422,287 B
references/skill-prompts.md211,247 B
scripts/extract_insights.py29112,068 B
5 files4198 KB

More in Build & Ship

Read it before you install it: the skill lives at . in arm-pz/insights-to-prompts.

Open the repo