CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ai-engineer

Build production-ready LLM applications, advanced RAG systems, and intelligent agents. Implements vector search, multimodal AI, agent orchestration, and enterprise AI integrations.

49

1.00x
Quality

48%

Does it follow best practices?

Impact

56%

1.00x

Average score across 3 eval scenarios

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/ai-engineer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a persona/catalog skill rather than an instructional one: nearly all 180 lines enumerate technologies, traits, and example prompts Claude already knows, with zero executable guidance. The four-step workflow is a vague skeleton with no validation checkpoints, and everything is inlined in one file with no progressive disclosure.

Suggestions

Replace the Capabilities/Knowledge Base catalogs with 2-3 concrete, executable patterns (e.g., a working hybrid RAG pipeline snippet and an agent-tool wiring example) and move the technology catalog to a references/ file loaded on demand.

Make the Instructions workflow concrete and verifiable: specify actual commands/scripts for each step and add explicit validation checkpoints (e.g., 'run the eval set and only proceed if retrieval hit-rate passes X').

Delete the Purpose, Behavioral Traits, Knowledge Base, and Example Interactions sections — they restate the persona and general knowledge without adding actionable value.

DimensionReasoningScore

Conciseness

The body is heavily padded with knowledge Claude already has: ~140 lines cataloging model names ("OpenAI GPT-4o/4o-mini, o1-preview..."), libraries ("LangChain/LangGraph... CrewAI... AutoGen"), and generic "Knowledge Base" and "Behavioral Traits" sections that add almost no instruction value. This matches "severely verbose; extensively explains concepts Claude already knows; heavily padded" — not 2 because there is no substantial core of lean instructional content surviving alongside the padding.

1 / 5

Actionability

There is no code, command, template, or concrete procedure anywhere — instructions are entirely abstract ("Clarify use cases, constraints, and success metrics", "Design the AI architecture, data flow, and model selection", "Implement production-ready code"). This matches "entirely vague or abstract; no concrete code or commands; only describes rather than instructs"; not 2 because even high-level hints toward executable steps are missing.

1 / 5

Workflow Clarity

The Instructions and Response Approach sections give a rough sequence (clarify → design → implement → validate; analyze → design → implement → monitor), but steps are poorly defined with no checkpoints, commands, or error-recovery loops, and the two lists overlap redundantly. Matches "rough sequence present but many gaps; steps poorly defined"; not 3 because no step is concrete or verifiable enough to count as a real checkpoint.

2 / 5

Progressive Disclosure

The skill is a single monolithic file with no bundle files (no references/, scripts/, or assets/ exist) and no pointer references at all; the ~140-line capability catalog is exactly the content that belongs in separate reference files. Matches "minimal structure; content that clearly belongs in separate files is inlined"; not 3 because there are no clearly signaled references to offset the inlined bulk, only section headers.

2 / 5

Total

6

/

20

Passed

Description

62%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 capability-oriented description with good natural trigger terms, but it omits any explicit "use when" trigger guidance, which caps its completeness. Its breadth across the entire AI engineering domain also creates moderate conflict risk with adjacent skills.

Suggestions

Add an explicit trigger clause, e.g. "Use when building or debugging LLM features, RAG pipelines, AI agents, chatbots, or embedding/vector-search systems."

Narrow the claimed scope (drop or de-emphasize generic terms like "enterprise AI integrations") to reduce overlap with prompt-engineering and general architecture skills.

Include common user phrasings such as "chatbot", "embeddings", and "retrieval pipeline" as trigger terms.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — "Build production-ready LLM applications, advanced RAG systems, and intelligent agents" plus "Implements vector search, multimodal AI, agent orchestration, and enterprise AI integrations" — which names the domain and multiple specific actions. Not score 5 because these are broad domain areas rather than the fine-grained, comprehensive action list of the top anchor; not 3 because coverage goes well beyond 1-2 actions.

4 / 5

Completeness

The "what" is clearly answered (build LLM apps, RAG systems, agents; implements vector search, orchestration, integrations) but there is no "Use when..." clause or equivalent explicit trigger guidance anywhere in the description — the guideline explicitly caps completeness at 3 for this. Not 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Natural trigger phrases users would say are present: "LLM applications", "RAG systems", "agents", "vector search", "AI integrations". Not 5 because common variations users actually say are missing (e.g., "chatbot", "embeddings", "prompt engineering", "AI feature"); not 3 because keyword coverage is genuinely good rather than partial.

4 / 5

Distinctiveness Conflict Risk

The scope is somewhat specific to the LLM application domain, but the very broad span (RAG + agents + vector search + multimodal + enterprise integrations + "production-ready") overlaps with prompt-engineering, data-science, and general software-architecture skills, matching "somewhat specific but could still overlap with similar skills". Not 4 because a narrower, focused trigger set would be needed for minor overlap risk only.

3 / 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/ai-engineer/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.