CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

build-agents

Default guidance for building AI agents. Use for generic requests to build, create, scaffold, design, architect, or implement an AI agent, agent app, tool-calling agent, durable agent, multi-agent system, or scheduled agent.

62

Quality

78%

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/build-agents/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.

A lean, actionable router skill: concrete commands, explicit defaults and exclusions, and clean deferral to authoritative shipped docs instead of duplicating framework API detail. The gaps are minor — no sample agent definition or run/verify step, and the Slack stack details are inlined.

Suggestions

Add a minimal post-init step, such as the dev/run command or a one-line 'verify the agent starts' checkpoint, to close the workflow loop after scaffolding.

Include a tiny defineAgent/defineTool snippet (5-10 lines) so the common build case has an in-skill executable example rather than deferring 100% to the shipped docs.

Consider moving the Slack expected-stack details ('agent/channels/slack.ts', 'SLACK_CONNECTOR', '/eve/v1/slack') into a small reference file or the Slack Agent Skill's own material to keep SKILL.md purely navigational.

DimensionReasoningScore

Conciseness

The body is lean and command-driven with no tutorial padding — it assumes competence and every section carries operational content. Only minor instances could be trimmed (the opening line 'eve is a great default choice for building agents.' duplicates the frontmatter summary and is editorial rather than instructional), fitting anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Concrete, executable guidance throughout: 'npx eve@latest init <agent-name>', 'npx skills add vercel-labs/slack-agent-skill', doc path 'node_modules/eve/docs/README.md', and exact stack identifiers ('agent/channels/slack.ts', 'SLACK_CONNECTOR', '/eve/v1/slack'). It stops short of anchor 5 because the core build-an-agent case defers entirely to the shipped docs with no in-skill sample (no defineAgent/defineTool snippet, no dev/run command) — a justified but real gap.

4 / 5

Workflow Clarity

A clear two-step sequence (1. run init, 2. read the shipped docs) with explicit conditional guidance (default to eve unless another framework is requested; distinct Slack path with expected stack and exclusions). No validation checkpoints exist, but the skill involves no destructive or batch operations, so the workflow-clarity cap does not apply; it is not anchor 5 because there is no post-scaffold verify/run step.

4 / 5

Progressive Disclosure

Good structure with appropriate deferral: detail lives one level deep in eve's shipped docs, the public docs, and the Slack Agent Skill's files, all clearly signaled rather than inlined. It matches anchor 4 ('good structure; references mostly clear; minor organization gaps') — the body is 78 lines, above the under-50 simple-skill exception, and the Slack stack specifics are inlined rather than split into a reference.

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.

A well-constructed description with an explicit 'Use when' clause, rich natural trigger vocabulary, and specific agent archetypes. Its main weakness is a generic 'what' — 'Default guidance' does not tell the reader what the guidance actually entails.

Suggestions

Make the 'what' concrete: replace 'Default guidance for building AI agents' with what the guidance does, e.g. 'Scaffolds AI agents with the eve framework (init, tools, channels, connections)'.

Add a few missing natural trigger variants to the description itself — 'make an agent', 'set up an agent', 'agent framework', 'Slack agent' — since they currently exist only in frontmatter metadata.

Include the key disambiguation (e.g. 'not for Vercel Agent code-review/investigation tasks') in the description to further reduce conflict risk.

DimensionReasoningScore

Specificity

Enumerates concrete action verbs ("build, create, scaffold, design, architect, or implement") and specific deliverable types ("agent app, tool-calling agent, durable agent, multi-agent system, scheduled agent"), matching the 'several specific actions; minor gaps' anchor. It falls short of anchor 5 because the 'what' clause ('Default guidance for building AI agents') never states what the guidance concretely covers (init flow, framework default, stack choices).

4 / 5

Completeness

Both halves are present: a 'what' ('Default guidance for building AI agents') and an explicit 'when' ('Use for generic requests to build, create, scaffold...') with concrete trigger phrases. It matches anchor 4 ('both present; when could be more explicit or specific' is not the issue here — rather the 'what' is generic), and is not anchor 5 because 'Default guidance' does not explicitly state what the guidance does.

4 / 5

Trigger Term Quality

Natural phrases a user would say ('build an AI agent', 'scaffold', 'multi-agent system', 'durable agent', 'scheduled agent') with good verb synonym coverage. A few common natural terms are missing from the description itself ('make an agent', 'set up an agent', 'agent framework', 'Slack agent' — several appear only in frontmatter metadata), so it fits anchor 4 rather than the comprehensive coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Scoped by 'generic requests' and specific agent archetypes, making it mostly distinct with minor overlap risk against other agent-framework or Slack-bot skills. The disambiguating exclusions (Vercel Agent, Chat SDK/Bolt) live in the body rather than the description, which keeps it at anchor 4 instead of the minimal-conflict anchor 5.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

vercel/vercel-plugin

Path

skills/build-agents/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.