CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

llm-application-dev-prompt-optimize

Evaluate and improve LLM prompts using examples, structured instructions, and measured comparisons. Use when refining prompt reliability, output quality, or model-specific behavior.

42

Quality

53%

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 ./skills/llm-application-dev-prompt-optimize/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

25%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 a short shell of padded framing (persona, circular use/don't-use sections, unsourced statistics) whose actual instructional content is a handful of vague directives. Its one concrete element — the playbook reference — points to a file that does not exist, leaving the skill with no usable guidance.

Suggestions

Replace the vague Instructions bullets with a concrete, sequenced optimization workflow, e.g. capture the current prompt and target model, restructure with explicit structure/examples, run both versions on the same inputs, and compare outputs before adopting.

Either create resources/implementation-playbook.md with the promised patterns and examples, or inline the essential patterns into SKILL.md and drop the dangling reference (also note the conventional bundle directory is references/).

Delete the persona sentence, the circular 'Do not use this skill when' section, and the unverifiable 40%/30%/50-80% statistics; use the reclaimed tokens for one worked before/after prompt example.

DimensionReasoningScore

Conciseness

Several sections are padded rather than informative: the persona line "You are an expert prompt engineer specializing in...", the circular "Do not use this skill when - The task is unrelated to prompt optimization", and unsourced marketing statistics ("improve accuracy by 40%, reduce hallucinations by 30%, and cut costs by 50-80%"). This matches 'noticeably verbose; several unnecessary explanations or padded sections' — the token waste is proportional even though the body is short.

2 / 5

Actionability

The Instructions are abstract directives ("Clarify goals, constraints, and required inputs", "Apply relevant best practices and validate outcomes") with no concrete technique, example, or command — they describe rather than instruct. It avoids a 1 only because one concrete pointer exists ("open resources/implementation-playbook.md"), but that file does not exist in the bundle, so the only specific guidance is a dead end.

2 / 5

Workflow Clarity

The bullets form only a rough sequence (clarify → apply → validate → provide steps) with many gaps, poorly defined steps, and no validation checkpoints of any kind, matching the 'rough sequence present but many gaps; validation absent' anchor. The 'validate outcomes' bullet names validation without saying how or when to check anything.

2 / 5

Progressive Disclosure

Although the body has sections and a clearly signaled, one-level-deep reference, that reference is dangling: no resources/ directory or implementation-playbook.md exists in the bundle, and all detailed content is delegated to it ("If detailed examples are required, open resources/implementation-playbook.md"). The disclosure chain is broken, which is worse than an unhelpfully-signaled but real reference, and the Resources section merely duplicates the inline pointer.

2 / 5

Total

8

/

20

Passed

Description

58%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.

A solid, third-person description that clearly pairs a what-clause with an explicit Use-when clause. Its main weaknesses are generic core verbs, missing high-frequency natural trigger terms like "prompt engineering" and "optimize prompts", and trigger phrases abstract enough to risk overlap with adjacent LLM-development skills.

Suggestions

Add natural trigger phrasings users actually say, e.g. 'Use when the user asks to optimize, tune, or iterate on prompts, or mentions prompt engineering'.

Replace generic verbs with more concrete capabilities, e.g. 'Rewrites and restructures prompts, runs side-by-side model comparisons, and measures output quality before and after'.

Narrow the when-clause to prompt-specific triggers (drop generic terms like 'output quality') to reduce conflict with general LLM app-development skills.

DimensionReasoningScore

Specificity

The description names the domain ("LLM prompts") and two actions ("Evaluate and improve") plus a short method list ("using examples, structured instructions, and measured comparisons"), which matches the '1-2 concrete actions, but not comprehensive' anchor. It does not reach 4 because the verbs are generic and there is no coverage of what evaluation or improvement concretely involves (e.g., A/B testing prompts, iterating on outputs, comparing model responses).

3 / 5

Completeness

It explicitly answers both 'what' ("Evaluate and improve LLM prompts using examples, structured instructions, and measured comparisons") and 'when' ("Use when refining prompt reliability, output quality, or model-specific behavior"), matching the both-present-but-could-be-more-explicit anchor. It falls short of 5 because the trigger phrases are condition-level abstractions rather than concrete user-mention triggers (no user-style phrasing like 'when the user asks to improve a prompt').

4 / 5

Trigger Term Quality

Relevant keywords are present ("LLM prompts", "prompt reliability", "output quality", "refining") but common natural phrasings users would actually say are missing — notably "prompt engineering", "optimize prompts", and "tune/improve a prompt" — fitting the 'some relevant keywords but missing common variations or synonyms' anchor.

3 / 5

Distinctiveness Conflict Risk

The prompt-optimization niche is somewhat specific, but broad triggers like "output quality" and "model-specific behavior" overlap with general LLM application-development and evaluation skills, matching the 'somewhat specific but could still overlap with similar skills' anchor rather than the 'mostly distinct' anchor 4.

3 / 5

Total

13

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

rmyndharis/antigravity-skills

Path

skills/llm-application-dev-prompt-optimize/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.