# senior-prompt-engineer

senior-prompt-engineer — a skill for Claude Code that reviews prompt architecture, scores RAG quality, and diagrams agent workflows. Flags redundant instructions and missing output contracts during prompt tuning.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 239 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/senior-prompt-engineer/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-senior-prompt-engineer

## What it does

Compatible with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It bundles deterministic Python utilities alongside deep reference patterns. The `prompt_optimizer.py` script inspects inherited prompts to catch shouting capitals, artificial step-by-step thinking instructions, and missing JSON or XML contracts while reporting heuristic token counts.

For retrieval pipelines, `rag_evaluator.py` scores answers against source contexts via ROUGE-L, Precision@K, and MRR. The `agent_orchestrator.py` script validates YAML specifications, renders execution flows as Mermaid or ASCII graphs, and calculates per-run expenses. Pattern libraries cover ReAct, Plan-Execute, and multi-agent coordination approaches with pseudocode.

Static scripts do not maintain price lists: financial projections require real rates supplied via `--input-price` and `--output-price` CLI flags.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill senior-prompt-engineer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/senior-prompt-engineer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/senior-prompt-engineer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill senior-prompt-engineer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/senior-prompt-engineer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill senior-prompt-engineer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/senior-prompt-engineer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/senior-prompt-engineer/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/senior-prompt-engineer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill senior-prompt-engineer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/senior-prompt-engineer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/senior-prompt-engineer/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill senior-prompt-engineer -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/senior-prompt-engineer/SKILL.md

## When to use it
- detect vague phrasing and forced chain-of-thought blocks in inherited prompts
- score RAG answer faithfulness against retrieved source context files
- validate agent YAML architecture and render ASCII or Mermaid flowcharts

## Example prompts
- Run heuristic review using `python scripts/prompt_optimizer.py assets/sample_prompt_flawed.txt --analyze`
- Evaluate context groundedness with `python scripts/rag_evaluator.py --contexts assets/sample_contexts.json --questions assets/sample_questions.json --min-faithfulness 0.7`
- Render flow and project costs using `python scripts/agent_orchestrator.py assets/sample_agent.yaml --estimate-cost --input-price 0.003 --output-price 0.015`

## Similar
- [senior-ml-engineer](https://affpapa.org/en/nevibecode/skills/senior-ml-engineer.md) — skill · 915 installs
- [ai-engineer](https://affpapa.org/en/nevibecode/skills/ai-engineer.md) — skill · 1300 installs
- [prompt-engineer](https://affpapa.org/en/nevibecode/agents/josstei-prompt-engineer.md) — subagent · ★ 489 repo stars
- [deepeval](https://affpapa.org/en/nevibecode/skills/deepeval.md) — skill · 2900 installs
- [opik-evaluate](https://affpapa.org/en/nevibecode/skills/opik-evaluate.md) — skill · 122 installs
- [arize-evaluator](https://affpapa.org/en/nevibecode/skills/arize-arize-evaluator.md) — skill · 3300 installs

## Other versions with the same name
- [senior-prompt-engineer · alirezarezvani](https://affpapa.org/en/nevibecode/skills/senior-prompt-engineer.md) — 970 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
