senior-prompt-engineer

Analyze, optimize, and evaluate LLM prompts, RAG pipelines, and agent configurations.

2|1|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/bhaktofmahakal/ai-counsellor-hf --skill senior-prompt-engineer-bhaktofmahakal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: senior-prompt-engineer
Source: https://github.com/bhaktofmahakal/ai-counsellor-hf/tree/main/.claude/skills/senior-prompt-engineer
Command: npx skills add https://github.com/bhaktofmahakal/ai-counsellor-hf --skill senior-prompt-engineer-bhaktofmahakal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Writing effective LLM prompts and agent workflows is often trial-and-error, leading to wasted tokens, ambiguous outputs, and unvalidated agent designs. This Skill provides static analysis tools and reference frameworks to systematically improve prompt quality, measure RAG retrieval performance, and validate agent architectures before deployment. ## Core Features & Use Cases - Prompt Optimizer: Analyzes prompts for token count, cost estimation, clarity scores, ambiguity issues, and redundant content, then generates optimized versions and extracts few-shot examples. - RAG Evaluator: Measures context relevance, retrieval precision, answer faithfulness, and groundedness against question/context datasets. - Agent Orchestrator: Validates agent configurations (ReAct, Plan-Execute, tool-use patterns), visualizes workflows as ASCII or Mermaid diagrams, and estimates per-run token costs. - Use Case: Before shipping a customer-support agent, run its YAML config through the orchestrator to catch missing tool configs and infinite-loop risks, then optimize the system prompt to cut token costs by removing redundant instructions. ## Quick Start Ask the assistant to analyze your prompt file with the prompt optimizer script to get a clarity score, token count, and concrete improvement suggestions.

Frequently Asked Questions about senior-prompt-engineer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a prompt for token count and clarity issues?▼

Run prompt_optimizer.py with the --analyze flag on your prompt file to get token count, estimated cost, clarity and structure scores, plus detected ambiguity and redundancy issues. Use --tokens for a quick count or --optimize to generate a cleaned-up version.

How do I evaluate RAG retrieval quality with metrics?▼

Use rag_evaluator.py with JSON files containing retrieved contexts and evaluation questions. It reports context relevance, precision@k, answer faithfulness, and groundedness, flagging questions where no relevant context appeared in the top results.

What agent patterns does the orchestrator support?▼

The agent orchestrator supports ReAct, Plan-and-Execute, tool-use, multi-agent, and custom patterns defined in YAML or JSON configs. It validates tool registrations, detects potential infinite loops, and visualizes flows as ASCII or Mermaid diagrams.

Does the prompt optimizer require external Python packages?▼

No, the scripts use only the Python standard library including argparse, json, and re. Token counts are character-ratio approximations rather than exact tokenizer counts, so no tiktoken or model SDK installation is needed.

When should I use few-shot prompting instead of zero-shot?▼

Use few-shot prompting with 3-5 examples when you need consistent output formatting or domain-specific patterns that zero-shot instructions cannot reliably produce. The reference guide recommends mixing simple, edge-case, and complex examples while keeping formatting consistent.

Why does my agent config fail validation?▼

Common causes include duplicate tool names, missing required_config entries for tools, and absent tool descriptions. Run the orchestrator with --validate to see a per-tool status report listing exact errors and warnings.