Prompyai — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Prompyai (Agent Skill) and scored it 96/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 1 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 1 flagged
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<p align="center"> <img src="packages/landing/public/logo.png" alt="PrompyAI" width="120" /> </p>
<h1 align="center">PrompyAI</h1>
<p align="center"> Context-aware prompt intelligence for Claude CLI.<br/> Scores your prompts against your real codebase — file paths, symbols, session history — and rewrites them with AI. </p>
<p align="center"> <a href="https://www.npmjs.com/package/prompyai-mcp"><img src="https://img.shields.io/npm/v/prompyai-mcp" alt="npm" /></a> <a href="https://github.com/samouh-waleed/PrompyAI/blob/main/LICENSE"><img src="https://img.shields.io/github/license/samouh-waleed/PrompyAI" alt="license" /></a> <a href="https://prompyai.com"><img src="https://img.shields.io/badge/website-prompyai.com-7c3aed" alt="website" /></a> </p>
When you write a prompt in Claude CLI, PrompyAI automatically evaluates it against your actual project and returns:
Prompt Score: 43/100 [D]
Specificity 3/25 ==..............
Context Completeness 13/25 ========........
Task Clarity 15/25 =========.......
File & Folder Anchoring 10/25 ======..........
Key improvements:
1. Expand your prompt with more context
2. Add file paths using @mentions
3. Specify what format you expect the output in
4. Add acceptance criteria
Try something more like:
"Build the VS Code extension in packages/vscode-extension/ that integrates
with the PrompyAI MCP server at packages/mcp-server/. It should provide
real-time prompt scoring in the editor sidebar, show score breakdowns
(specificity, context, clarity, anchoring), and offer a 'rewrite prompt'
action. Use the shared types from packages/shared/."claude mcp add prompyai -- npx prompyai-mcp serveThat's it. No sign-up, no config files. Works immediately.
Requires Node.js 20+ and Claude CLI.
PrompyAI uses a two-layer architecture so all users get AI-enhanced output:
| User type | How it works |
|---|---|
API key users (ANTHROPIC_API_KEY set) | PrompyAI calls Claude Haiku directly for fast, dedicated AI rewrites |
| Subscription users (no API key) | PrompyAI returns codebase context to Claude, and Claude itself generates the enhanced prompt using your existing session |
Either way, the enhanced prompt is grounded in your real project — actual file paths, verified function names, and project architecture.
Each dimension scores 0–25, total 0–100.
| Dimension | What it measures |
|---|---|
| Specificity | Concrete actions vs vague verbs, output format, quantitative constraints |
| Context Completeness | File references, error messages, expected vs actual behavior |
| Task Clarity | Single focused task, success criteria, unambiguous language |
| File & Folder Anchoring | @mentions, project entity references, verified symbol names |
Grades: A (90+) · B (70+) · C (50+) · D (30+) · F (<30)
evaluate_promptAutomatically called on every user message. Scores your prompt against your project.
| Parameter | Required | Description |
|---|---|---|
prompt | yes | The prompt text to evaluate |
workspace_path | yes | Absolute path to your project |
active_file | no | Currently open file path |
session_id | no | Claude Code session ID for multi-turn context |
get_contextReturns your project summary: tech stack, recent files, key folders, AI instruction files.
| Parameter | Required | Description |
|---|---|---|
workspace_path | yes | Absolute path to your project |
prompyai_toggleTurns auto-evaluation on or off.
| Parameter | Required | Description |
|---|---|---|
enabled | yes | true to enable, false to disable |
| Variable | Required | Description |
|---|---|---|
ANTHROPIC_API_KEY | No | Enables direct AI suggestions via Claude Haiku (optional — works without it) |
PROMPYAI_TELEMETRY | No | Set to false to opt out of anonymous telemetry |
PrompyAI/
├── packages/
│ ├── mcp-server/ ← Core product (npm: prompyai-mcp)
│ ├── landing/ ← Website (prompyai.com)
│ └── shared/ ← Shared types for future IDE extensions
├── CLAUDE.md
└── README.mdUser prompt
→ WorkspaceIndexer (file tree, stack, symbols)
→ ContextResolver (map prompt to codebase)
→ HeuristicScorer (20+ rules, 4 dimensions)
→ AISuggestionGenerator (Haiku or Claude-as-AI-layer)
→ DisplayFormatter (pre-formatted output)pnpm install # Install dependencies
pnpm test # Run tests (220 tests)
pnpm typecheck # Type check
pnpm build # BuildMIT
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.