CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-prompt-quality-bar

Universal quality bar and final audit rubric for any agent system prompt. Activate this whenever you are unsure which archetype skill applies, or as a final review pass before writing the system prompt. It defines the required run contract, completion criteria, fallback paths, response format, and anti-patterns every produced agent prompt must satisfy.

70

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 an exemplary instruction-only skill: concrete bad/good pairs for every required section, a verifiable audit checklist with a revise-on-failure loop, and well-organized anti-pattern guidance with fixes. Its only real gaps are minor redundancy between the section templates and the audit rubric, and cross-references that are named but not linked as navigable pointers.

DimensionReasoningScore

Conciseness

The body is dense, checklist-style guidance ("Replace broad 'ask the user' language with explicit choices"; "no `<...>`, 'TBD', 'TODO'") with no padding explaining concepts Claude already knows. Not a 5 because completion criteria, fallback behavior, and response format each appear twice — once in the section templates and again in the audit rubric — which could be tightened into a single cross-referenced list.

4 / 5

Actionability

Every required section ships with concrete Bad/Good example pairs ("Bad: 'You are a helpful AI assistant.' / Good: 'You are Acme's Tier-1 Email Triager...'") plus a copy-paste-ready completion-criteria template and an 11-item checkable audit list. Per the rubric's scoring note, an instruction-only skill without code is not penalized when the guidance is this actionable, matching the top anchor.

5 / 5

Workflow Clarity

The sequence is explicit — numbered run contract (1–6), nine named sections, then a mandatory audit rubric with the feedback loop "If any item fails, revise the system prompt before writing it" — and "How to use this skill" adds a four-step path for the novel-outcome case. This is prompt authoring, not a destructive/batch operation, so no cap applies; the checklist-plus-retry structure matches the 5 anchor.

5 / 5

Progressive Disclosure

No bundle files exist, and the single-file body is well-sectioned with clear headers while domain detail is correctly externalized to the archetype skills. Below 5 because the "Cross-references" section names sibling skills (coding-agent, research-agent, ...) as plain text rather than signaling them as navigable references, and the file exceeds the under-50-line simple-skill exception.

4 / 5

Total

18

/

20

Passed

Description

83%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 strong description that clearly states both what the skill provides and when to activate it, with concrete component enumeration and a well-positioned niche relative to sibling archetype skills. Its only weaknesses are a single umbrella verb limiting action specificity and a few missing natural trigger synonyms.

DimensionReasoningScore

Specificity

Enumerates several concrete components it provides — "required run contract, completion criteria, fallback paths, response format, and anti-patterns" — in third person ("It defines"), rather than vague filler. Not a 5 because the coverage hangs off one umbrella verb ("defines") rather than a list of distinct concrete actions.

4 / 5

Completeness

Explicitly answers both questions: "what" ("Universal quality bar and final audit rubric for any agent system prompt... defines the required run contract, completion criteria, fallback paths, response format, and anti-patterns") and "when" with concrete triggers ("Activate this whenever you are unsure which archetype skill applies, or as a final review pass before writing the system prompt"). This matches the top anchor; the explicit 'Use when'-style clause rules out the 4 anchor's weaker 'when'.

5 / 5

Trigger Term Quality

Natural trigger phrases like "agent system prompt", "final review pass", and "writing the system prompt" are present and phrased the way a user would say them. Missing a few common synonyms (e.g. "prompt engineering", "agent instructions"), so it falls just short of the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche — the compile-check/audit layer — explicitly positioned relative to the archetype skills ("whenever you are unsure which archetype skill applies"), which reduces conflict risk. The scope "any agent system prompt" is still broad with minor overlap against those related skills, keeping it below the minimal-conflict 5 anchor.

4 / 5

Total

17

/

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
mastra-ai/mastra
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.