CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

llm-prompt-optimizer

Use when improving prompts for any LLM. Applies proven prompt engineering techniques to boost output quality, reduce hallucinations, and cut token usage.

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/llm-prompt-optimizer/SKILL.md

The canonical home for this skill is llm-prompt-optimizer in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable — full copy-paste prompt templates with a diagnosis table, audit checklist, and concrete troubleshooting — but it spends most of its tokens restating prompt-engineering fundamentals (CoT, few-shot, delimiters, temperature) that Claude already knows, and inlines all detail with zero progressive disclosure. Trimming known concepts and splitting the pattern catalog into a reference file would cut token cost substantially without losing value.

Suggestions

Compress or remove the sections teaching concepts Claude already knows (chain-of-thought explanation, few-shot rationale, delimiter advice) to one-line pointers, keeping the diagnosis table, RSCIT structure, and audit checklist as the core method.

Move the pattern template catalog (CoT, few-shot, JSON output, hallucination-reduction, compression) into a references/ file such as PATTERNS.md, leaving SKILL.md as an overview that routes via the diagnosis table.

Make the workflow loop explicit — add a final step such as "test the optimized prompt on 5 varied inputs; if results are inconsistent, add 2 more few-shot examples and re-test" so validation and iteration are sequenced, not just implied by the checklist.

DimensionReasoningScore

Conciseness

The bulk of the body (~110 lines across sections 2-7) catalogs prompt-engineering fundamentals Claude already knows — chain-of-thought ("instruct the model to think step-by-step"), few-shot examples, delimiters, temperature tuning, JSON output schemas — so several full sections are unnecessary explanations. The writing style itself is compact rather than padded, which keeps it above anchor 1's "severely verbose/heavily padded".

2 / 5

Actionability

Every pattern is a copy-paste-ready prompt template (RSCIT before/after example, CoT template, few-shot sentiment examples, JSON schema with "return it as valid JSON only", anti-hallucination grounding wording, verbose-vs-compressed comparison), and troubleshooting gives concrete fixes with specific values ("temperature setting (0.0-0.3)", "exactly 3 bullet points, each under 20 words"). Fully executable guidance covering the common cases — anchor 5.

5 / 5

Workflow Clarity

The guide opens with a diagnosis table routing symptom→fix, closes with an audit checklist, and the troubleshooting section provides problem→solution recovery paths — most checkpoints are present. Not 5 because numbered steps 2-7 are actually a parallel pattern catalog rather than a true sequence, and the test-and-iterate loop ("test on 5+ varied inputs") is implied by the checklist rather than an explicit workflow step.

4 / 5

Progressive Disclosure

Sections are clearly organized and easy to navigate, but the skill is entirely monolithic: the ~110-line pattern/template catalog that could live in a separate references file is inlined in SKILL.md, and no external references or bundle files exist at all. This matches anchor 3's "content that should be separate is inline"; it is not anchor 4, whose example splits bulk detail into a separate file.

3 / 5

Total

14

/

20

Passed

Description

65%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description follows the 'Use when...' convention with good natural keywords covering the primary trigger plus hallucination and token-cost use cases, but the capability statement is generic — "applies proven prompt engineering techniques" with no named techniques — and leans on outcome claims rather than concrete actions. Solid and functional, with clear room to sharpen the what and enumerate trigger scenarios.

Suggestions

Replace the generic "Applies proven prompt engineering techniques" with named concrete techniques, e.g. "adds role/context/constraints structure, few-shot examples, chain-of-thought steps, and JSON output schemas to prompts".

Enumerate concrete trigger scenarios in the when-clause, e.g. "Use when prompts return inconsistent or hallucinated results, when reliable structured/JSON output is needed, or when designing system prompts".

Drop filler words like "proven" and vague claims like "boost output quality" that add no specific, verifiable information.

DimensionReasoningScore

Specificity

The only stated action is the generic "Applies proven prompt engineering techniques" — no technique is named — and the remaining verbs ("boost output quality, reduce hallucinations, cut token usage") are outcome claims rather than concrete actions. It names the domain but the actions are minimal or generic, matching anchor 2; anchor 3 would require 1-2 concrete named actions like few-shot examples or structured output patterns.

2 / 5

Completeness

Both halves are explicit: "Use when improving prompts for any LLM" (when) and "Applies proven prompt engineering techniques..." (what). Not 5 because the when-clause is a single trigger without enumerated concrete scenarios, and the what is generic rather than a list of concrete capabilities; not 3 because the 'Use when...' clause is explicitly present, not weakly implied.

4 / 5

Trigger Term Quality

Good natural keyword coverage — "improving prompts", "any LLM", "prompt engineering", "reduce hallucinations", "cut token usage" — covering the primary trigger and secondary use cases, mirroring anchor 4's example structure (domain + use-case keywords). A few natural terms are missing ("optimize", "rewrite", "system prompts"), keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

Prompt optimization is a clear niche with "improving prompts" as a distinct core trigger, but the broad outcome claims "reduce hallucinations" and "cut token usage" overlap with closely related skills (RAG/grounding, token-cost optimization) that users might mention those terms for. Mostly distinct with minor overlap risk — anchor 4.

4 / 5

Total

14

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/llm-prompt-optimizer/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.