prompt-optimization-analyzer

Analyze skill prompts for token waste, anti-patterns, and trigger issues.

6|1|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/auldsyababua/instructor-workflow --skill prompt-optimization-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prompt-optimization-analyzer
Source: https://github.com/auldsyababua/instructor-workflow/tree/main/skills/prompt-optimization-analyzer
Command: npx skills add https://github.com/auldsyababua/instructor-workflow --skill prompt-optimization-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill acts as an active diagnostic tool to identify inefficiencies, anti-patterns, and token waste in AI prompts. it helps users understand why their skills might not be triggering correctly, are too verbose, or produce inconsistent results, ultimately saving on token costs and improving AI reliability.

Core Features & Use Cases

  • Comprehensive Prompt Analysis: Evaluates prompts for trigger patterns, token efficiency, anti-patterns (ambiguity, conflicts), clarity, structure, and example quality.
  • Actionable Optimization Suggestions: Provides specific, prioritized recommendations with before/after examples to reduce token usage and improve prompt effectiveness.
  • Debugging & Reliability: Helps debug why skills aren't triggering or are behaving unexpectedly, enhancing overall AI agent reliability.
  • Use Case: A user has a complex skill that's consuming too many tokens and sometimes fails to trigger. This skill can analyze the prompt, pinpoint redundant sections, suggest clearer trigger phrases, and provide a rewritten, more efficient version.

Quick Start

Analyze the attached 'my-skill-prompt.md' for optimization opportunities and provide a detailed report.

Frequently Asked Questions about prompt-optimization-analyzer

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

FAQPage Schema
How do I reduce token usage in my AI prompts?

Token efficiency involves removing redundant phrases, consolidating examples, and using concise trigger patterns. This Skill analyzes your prompt to identify verbose sections, conflicting instructions, and unnecessary repetition, then recommends specific cuts and rewrites that maintain clarity while lowering token consumption.

Why isn't my skill triggering correctly?

Trigger failures often stem from ambiguous activation phrases, conflicting conditions, or unclear context. This Skill diagnoses trigger pattern issues by evaluating how your prompt signals intent to the AI agent, pinpoints miscommunication, and suggests clearer trigger wording with concrete before-and-after examples.

What are common anti-patterns in prompt design?

Prompt anti-patterns include ambiguous instructions, contradictory rules, over-explanation, and unclear expected outputs. This Skill detects these structural flaws through systematic review, ranks findings by severity, and provides actionable fixes to improve prompt reliability and AI consistency.

How do I prepare my skill prompt for publication?

Publication-ready prompts must be efficient, clear, and robust. This Skill runs a comprehensive diagnostic checklist covering trigger patterns, token efficiency, anti-pattern detection, and structural clarity, then outputs a prioritized report with recommended fixes so your skill performs reliably at scale.

Can I debug why my prompt produces inconsistent results?

Inconsistency usually traces to ambiguous instructions, missing context, or conflicting rules in your prompt. This Skill identifies these sources through structured analysis, explains why outputs vary, and suggests rewrites that establish clear expectations and consistent AI behavior.