{"id":"961a5dfc-3c4a-4482-a0da-ea6984e55eae","shortId":"G4s3Wu","kind":"skill","title":"prompt-optimization","tagline":"Analyzes and optimizes prompts using BP-001~008 patterns and 3-step flow (detect, optimize, balance). Use when \"optimize this prompt\", \"review prompt quality\", \"analyze prompt issues\", or creating/reviewing rashomon skill content.","description":"# Prompt Optimization Skill\n\n## Core Philosophy\n\n1. **Model-Agnostic**: Patterns effective across GPT, Claude, Gemini, etc.\n2. **Evidence-Based**: Based on peer-reviewed research and industry consensus\n3. **Actionable**: Each detection provides specific, implementable improvements\n4. **Non-Destructive**: Suggest improvements while preserving user intent and minimizing constraint creep (see `references/execution-quality.yaml` over_optimization criteria)\n\n## Pattern Detection\n\n### P1: Critical (Must Fix)\n\nHigh confidence research evidence for negative impact.\n\n| ID | Pattern | Research Basis |\n|----|---------|----------------|\n| BP-001 | Negative Instructions | Attention focuses on forbidden content, increasing violation probability. Inverse scaling confirmed |\n| BP-002 | Vague Instructions | Primary failure cause. 40% of performance variance |\n| BP-003 | Missing Output Format | Directly linked to hallucination reduction |\n\n### P2: High Impact (Should Fix)\n\nConsistent improvement when addressed.\n\n| ID | Pattern | Research Basis |\n|----|---------|----------------|\n| BP-004 | Unstructured Prompt | \"Structure > Length\" confirmed |\n| BP-005 | Missing Context | \"More context = higher accuracy\" confirmed |\n| BP-006 | Complex Task Without Decomposition | ICLR 2023: 28% error reduction with decomposition |\n\n### P3: Enhancement (Could Fix)\n\nIncremental improvements in specific contexts.\n\n| ID | Pattern | Research Basis |\n|----|---------|----------------|\n| BP-007 | Biased Examples | 40% of few-shot effectiveness depends on exemplar selection |\n| BP-008 | No Uncertainty Permission | Allowing \"I don't know\" reduces hallucination |\n\n## 3-Step Optimization Flow\n\n### Step 1: Initial Analysis\n\n**Input**: Target prompt\n**Process**: Detect patterns (BP-001 through BP-008)\n**Output**: `.claude/.rashomon/step1-analysis.md`\n\nContents:\n- Detected issues by severity\n- Location in prompt\n- Original prompt preserved\n\n### Step 2: Optimization\n\n**Input**: Step 1 analysis\n**Process**:\n- Classify each improvement as Structural, Context Addition, Expressive, or Variance (see Improvement Classification below). Apply only Structural and Context Addition changes.\n- Consolidate redundant improvements\n- Apply in priority order (P1 > P2 > P3)\n**Output**: `.claude/.rashomon/step2-optimized.md`\n\nContents:\n- Before/after for each change\n- Rationale\n- Optimized prompt\n\n### Step 3: Balance Adjustment\n\n**Input**: Step 2 output\n**Process**:\n- Reference `references/execution-quality.yaml`\n- Confirm all critical aspects are preserved\n- Confirm constraints are proportionate (prompt length increase ≤50%, no constraints that limit valid solutions unnecessarily — see `references/execution-quality.yaml` over_optimization)\n**Output**: Final optimized prompt. Clean up temporary files (`.claude/.rashomon/step1-*.md`, `step2-*.md`) after completion.\n\n## Conditional Application\n\n### BP-004 (Unstructured)\n\nApply 4-block pattern IF:\n- Prompt longer than 3 sentences\n- Contains multiple distinct instructions\n- Has implicit section boundaries\n\nSkip when:\n- Single simple instruction\n- Already clearly structured\n- Structure would add unnecessary verbosity\n\n### BP-006 (Decomposition)\n\nDecompose IF:\n- 3+ distinct objectives\n- Sequential dependencies\n- Each step can be quality-checked\n\n**Key Insight**: Goal is EVALUABLE GRANULARITY with QUALITY CHECKPOINTS, not decomposition itself.\n\n## Improvement Classification\n\n| Classification | Definition | Interpretation |\n|---------------|------------|----------------|\n| **Structural** | Prompt structure, clarity, specificity improvements | Prompt writing technique |\n| **Context Addition** | Project-specific information added from codebase investigation | Information advantage |\n| **Expressive** | Different phrasing, equivalent substance | Neutral |\n| **Variance** | Within LLM probabilistic variance | Original prompt sufficient |\n\n**Principle**: Distinguish between prompt writing improvements (Structural) and information additions (Context Addition).\n\nReference: `references/execution-quality.yaml` for detailed criteria.\n\n## References\n\n- `references/patterns.yaml` - Detailed pattern definitions\n- `references/execution-quality.yaml` - Quality evaluation criteria\n- `references/skills.md` - Skill-specific optimization (BP adaptation, 9 editing principles, progressive disclosure, grading)","tags":["prompt","optimization","rashomon","shinpr","agent-skills","ai-tools","claude-code","claude-code-plugin","developer-tools","evaluation","llm","prompt-engineering"],"capabilities":["skill","source-shinpr","skill-prompt-optimization","topic-agent-skills","topic-ai-tools","topic-claude-code","topic-claude-code-plugin","topic-developer-tools","topic-evaluation","topic-llm","topic-prompt-engineering","topic-prompt-evaluation","topic-prompt-optimization","topic-skills"],"categories":["rashomon"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/shinpr/rashomon/prompt-optimization","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add shinpr/rashomon","source_repo":"https://github.com/shinpr/rashomon","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 9 github stars · SKILL.md body (4,340 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T07:03:39.611Z","embedding":null,"createdAt":"2026-04-23T13:04:21.178Z","updatedAt":"2026-04-24T07:03:39.611Z","lastSeenAt":"2026-04-24T07:03:39.611Z","tsv":"'-001':10,110,241 '-002':125 '-003':136 '-004':159,360 '-005':166 '-006':175,394 '-007':201 '-008':215,244 '1':41,231,263 '2':52,259,313 '2023':181 '28':182 '3':14,65,226,308,370,398 '4':73,363 '40':131,204 '50':331 '9':495 'accuraci':172 'across':47 'action':66 'ad':442 'adapt':494 'add':390 'addit':272,285,437,471,473 'address':153 'adjust':310 'advantag':447 'agnost':44 'allow':219 'alreadi':385 'analysi':233,264 'analyz':4,28 'appli':280,290,362 'applic':358 'aspect':321 'attent':113 'balanc':19,309 'base':55,56 'basi':108,157,199 'before/after':300 'bias':202 'block':364 'boundari':379 'bp':9,109,124,135,158,165,174,200,214,240,243,359,393,493 'caus':130 'chang':286,303 'check':409 'checkpoint':418 'clariti':430 'classif':278,423,424 'classifi':266 'claud':49 'claude/.rashomon/step1-':351 'claude/.rashomon/step1-analysis.md':246 'claude/.rashomon/step2-optimized.md':298 'clean':347 'clear':386 'codebas':444 'complet':356 'complex':176 'condit':357 'confid':99 'confirm':123,164,173,318,324 'consensus':64 'consist':150 'consolid':287 'constraint':85,325,333 'contain':372 'content':35,117,247,299 'context':168,170,195,271,284,436,472 'core':39 'could':189 'creating/reviewing':32 'creep':86 'criteria':91,478,487 'critic':95,320 'decompos':396 'decomposit':179,186,395,420 'definit':425,483 'depend':210,402 'destruct':76 'detail':477,481 'detect':17,68,93,238,248 'differ':449 'direct':140 'disclosur':499 'distinct':374,399 'distinguish':463 'edit':496 'effect':46,209 'enhanc':188 'equival':451 'error':183 'etc':51 'evalu':414,486 'evid':54,101 'evidence-bas':53 'exampl':203 'exemplar':212 'express':273,448 'failur':129 'few-shot':206 'file':350 'final':344 'fix':97,149,190 'flow':16,229 'focus':114 'forbidden':116 'format':139 'gemini':50 'goal':412 'gpt':48 'grade':500 'granular':415 'hallucin':143,225 'high':98,146 'higher':171 'iclr':180 'id':105,154,196 'impact':104,147 'implement':71 'implicit':377 'improv':72,78,151,192,268,277,289,422,432,467 'increas':118,330 'increment':191 'industri':63 'inform':441,446,470 'initi':232 'input':234,261,311 'insight':411 'instruct':112,127,375,384 'intent':82 'interpret':426 'invers':121 'investig':445 'issu':30,249 'key':410 'know':223 'length':163,329 'limit':335 'link':141 'llm':456 'locat':252 'longer':368 'md':352,354 'minim':84 'miss':137,167 'model':43 'model-agnost':42 'multipl':373 'must':96 'negat':103,111 'neutral':453 'non':75 'non-destruct':74 'object':400 'optim':3,6,18,22,37,90,228,260,305,342,345,492 'order':293 'origin':255,459 'output':138,245,297,314,343 'p1':94,294 'p2':145,295 'p3':187,296 'pattern':12,45,92,106,155,197,239,365,482 'peer':59 'peer-review':58 'perform':133 'permiss':218 'philosophi':40 'phrase':450 'preserv':80,257,323 'primari':128 'principl':462,497 'prioriti':292 'probabilist':457 'probabl':120 'process':237,265,315 'progress':498 'project':439 'project-specif':438 'prompt':2,7,24,26,29,36,161,236,254,256,306,328,346,367,428,433,460,465 'prompt-optim':1 'proportion':327 'provid':69 'qualiti':27,408,417,485 'quality-check':407 'rashomon':33 'rational':304 'reduc':224 'reduct':144,184 'redund':288 'refer':316,474,479 'references/execution-quality.yaml':88,317,340,475,484 'references/patterns.yaml':480 'references/skills.md':488 'research':61,100,107,156,198 'review':25,60 'scale':122 'section':378 'see':87,276,339 'select':213 'sentenc':371 'sequenti':401 'sever':251 'shot':208 'simpl':383 'singl':382 'skill':34,38,490 'skill-prompt-optimization' 'skill-specif':489 'skip':380 'solut':337 'source-shinpr' 'specif':70,194,431,440,491 'step':15,227,230,258,262,307,312,404 'step2':353 'structur':162,270,282,387,388,427,429,468 'substanc':452 'suffici':461 'suggest':77 'target':235 'task':177 'techniqu':435 'temporari':349 'topic-agent-skills' 'topic-ai-tools' 'topic-claude-code' 'topic-claude-code-plugin' 'topic-developer-tools' 'topic-evaluation' 'topic-llm' 'topic-prompt-engineering' 'topic-prompt-evaluation' 'topic-prompt-optimization' 'topic-skills' 'uncertainti':217 'unnecessari':391 'unnecessarili':338 'unstructur':160,361 'use':8,20 'user':81 'vagu':126 'valid':336 'varianc':134,275,454,458 'verbos':392 'violat':119 'within':455 'without':178 'would':389 'write':434,466 '~008':11","prices":[{"id":"9fe3cd47-a782-4f40-a8f9-cbdba667648b","listingId":"961a5dfc-3c4a-4482-a0da-ea6984e55eae","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"shinpr","category":"rashomon","install_from":"skills.sh"},"createdAt":"2026-04-23T13:04:21.178Z"}],"sources":[{"listingId":"961a5dfc-3c4a-4482-a0da-ea6984e55eae","source":"github","sourceId":"shinpr/rashomon/prompt-optimization","sourceUrl":"https://github.com/shinpr/rashomon/tree/main/skills/prompt-optimization","isPrimary":false,"firstSeenAt":"2026-04-23T13:04:21.178Z","lastSeenAt":"2026-04-24T07:03:39.611Z"}],"details":{"listingId":"961a5dfc-3c4a-4482-a0da-ea6984e55eae","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"shinpr","slug":"prompt-optimization","github":{"repo":"shinpr/rashomon","stars":9,"topics":["agent-skills","ai-tools","claude-code","claude-code-plugin","developer-tools","evaluation","llm","prompt-engineering","prompt-evaluation","prompt-optimization","skills"],"license":"mit","html_url":"https://github.com/shinpr/rashomon","pushed_at":"2026-04-04T07:32:14Z","description":"Measure prompt and skill improvements with blind A/B comparison.","skill_md_sha":"445d2fcb876c9447baaed9c5b29e83af4f46df91","skill_md_path":"skills/prompt-optimization/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/shinpr/rashomon/tree/main/skills/prompt-optimization"},"layout":"multi","source":"github","category":"rashomon","frontmatter":{"name":"prompt-optimization","description":"Analyzes and optimizes prompts using BP-001~008 patterns and 3-step flow (detect, optimize, balance). Use when \"optimize this prompt\", \"review prompt quality\", \"analyze prompt issues\", or creating/reviewing rashomon skill content."},"skills_sh_url":"https://skills.sh/shinpr/rashomon/prompt-optimization"},"updatedAt":"2026-04-24T07:03:39.611Z"}}