CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

customer-support-agent

Use this skill when building a customer support agent with knowledge base lookup, ticket creation, and human escalation logic.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./external/anthropic-official/customer-support-agent/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 tight, executable code pattern with complete tool schemas and a working agent loop, and it avoids padding or re-teaching known concepts. Its gaps are the unbounded while True loop with no error-handling or iteration guidance, and mild redundancy between the Quick Reference table, the tool descriptions, and the frontmatter source line.

Suggestions

Add a max-iteration guard and a brief note on handling tool errors (e.g., returning tool_result with is_error) in the agent loop, since an unbounded while True can spin on repeated tool calls.

Trim redundancy: drop 'Based on the Anthropic Cookbook customer support pattern' (already in frontmatter source) and either cut the Quick Reference table or fold its escalation guidance into the system prompt only.

Tighten the tool stubs section into a short table of integration points (docs system, ticketing system, order API, handoff channel) instead of code stubs that mirror the tool names already shown.

DimensionReasoningScore

Conciseness

The body is lean and code-forward with no explanations of concepts Claude already knows, but 'Based on the Anthropic Cookbook customer support pattern' duplicates the frontmatter source field and the Quick Reference table restates tool descriptions already in the code — efficient with minor instances that could be trimmed, matching anchor 4 rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

The agent loop is essentially copy-paste ready (full tool schemas, concrete model id, working control flow), but execute_tool delegates to undefined stubs (search_docs, create_zendesk_ticket, lookup_order, hand_off_to_agent). The flexibility is explicitly flagged ('implement with your docs', 'or your ticketing system'), which the rubric permits, so this is mostly executable with minor gaps — anchor 4, not the fully-executable anchor 5.

4 / 5

Workflow Clarity

The control flow is clearly sequenced (send, return on end_turn, execute tools and append results on tool_use, loop) and the system prompt embeds a checkpoint ('Always confirm before taking actions that affect the customer's account'), but there is no max-iteration or error-handling guard for the unbounded while True loop and no guidance on tool failures — clear sequence with minor validation gaps, anchor 4 rather than anchor 3 (checkpoints are present, not missing).

4 / 5

Progressive Disclosure

No bundle files exist and the single-file content is appropriately inline for one code pattern, organized into clear sections (Overview, Agent Architecture, Tool Implementation Stubs, Quick Reference). The redundant Quick Reference table adds little navigational value, so this fits anchor 4's good structure with minor organization gaps rather than anchor 5's well-signaled, cleanly split layout.

4 / 5

Total

16

/

20

Passed

Description

75%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 is concise, concrete, and includes an explicit 'Use when building…' trigger with three named capabilities. Its main weakness is that the when-clause restates the what rather than adding distinct trigger phrases, and it omits the order-status capability and common synonyms like 'customer service' or 'helpdesk'.

Suggestions

Add distinct trigger phrases to the when-clause, e.g. 'Use when the user asks to build a support bot, helpdesk automation, or customer service agent'.

Include common synonyms such as 'customer service', 'helpdesk', or 'support chatbot' to broaden natural trigger coverage.

Mention the order-status lookup capability to align the description with the four tools the body actually implements.

DimensionReasoningScore

Specificity

Names the domain ('customer support agent') and three concrete capabilities ('knowledge base lookup, ticket creation, and human escalation logic'), but omits order-status lookup that the body implements — several specific actions with a minor coverage gap, matching the anchor-4 example rather than the comprehensive anchor 5.

4 / 5

Completeness

Both what ('knowledge base lookup, ticket creation, and human escalation logic') and when ('Use this skill when building a customer support agent') are explicitly present, but the when-clause largely restates the what and lacks distinct concrete trigger phrases, matching anchor 4 rather than the anchor-5 pattern of separate, specific triggers.

4 / 5

Trigger Term Quality

'customer support agent', 'ticket creation', 'escalation', and 'knowledge base' are natural phrases users would say, but common synonyms like 'customer service', 'helpdesk', or 'support chatbot' are missing — good coverage with a few natural terms absent, so anchor 4 rather than anchor 3 (which requires sparser keywords) or 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (support agent with KB lookup, ticketing, and escalation) with mostly distinct triggers; only minor overlap risk with generic agent-building skills, fitting anchor 4 rather than anchor 5's fully minimal conflict risk.

4 / 5

Total

16

/

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

ProwlrBot/prowlr-marketplace

Path

external/anthropic-official/customer-support-agent/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.