CtrlK
BlogDocsLog inGet started
Tessl Logo

write-template-playbooks

Write a template playbook for the build-an-agent skill: a 1-2 KB per-use-case file that teaches the builder agent to configure one kind of Agenta agent (changelog writer, issue triager, support router, and so on). Use when the ask is "write a template playbook", "add an agent template", "author a playbook for the build-an-agent skill", or "write the <X> playbook". Encodes the file format, the prompting checklist, and the platform facts authors get wrong.

74

Quality

93%

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

86%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 tight, highly actionable instruction skill: a complete skeleton, exact platform facts stated with the authority of shipped behavior, an explicit exclusion list, and clean pointer-table navigation to two real one-level-deep references. The only deductions are minor repetition between the skeleton and the platform-facts section, and the lack of an explicit final validation step for the authored playbook.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — it never explains general concepts, and the 'What a playbook NEVER contains' section actively prunes redundant content ('A playbook that re-teaches these wastes the 1-2 KB budget'). However, a few points are stated twice: the trigger-test copy appears in the skeleton's Verify section and again in full in fact #3 ('It is never a flask icon'), and the default-field guidance appears both in the Required context placeholder and in fact #1. These minor repetitions could be trimmed, matching the anchor-4 'minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

The guidance is fully executable: a complete fill-in markdown skeleton with per-section contents, exact tool and field names (request_input, discover_tools, delta.set.parameters.agent.tools, request_connection, commit_revision, x-ag-stepper), exact file paths for references, and precise formatting rules ('{type: "array", items: {type: "string", enum: [...]}}, oneOf: [{const, title, description}]'). An author can produce the deliverable directly from this plus the worked example it points to.

5 / 5

Workflow Clarity

The sequence is explicit and mapped ('Every section maps to the build loop: Match to step one, Required and Researchable to request_input, Explore to discover_tools plus test_run...'), and checkpoints exist in the form of the 'Read a reference when' table and the worked example for conformance. Minor gap: the authoring workflow itself has no explicit final validation step (e.g., 're-check the finished playbook against prompting-checklist.md and the 1-2 KB budget'), so checkpoints are present but not fully explicit — anchor 4 rather than 5.

4 / 5

Progressive Disclosure

The body is a well-organized overview that pushes detail to one-level-deep references, both of which exist as real files and are clearly signaled in a purpose-mapped table: 'Get the prompting rules... references/prompting-checklist.md' and 'Copy from a complete, spec-conforming example... references/worked-example.md'. An optional spec path is named for when the skeleton is insufficient. Navigation is easy and the split is appropriate — the skeleton and platform facts belong in-body, the checklist and example do not.

5 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: it states a concrete, bounded deliverable with size, purpose, and use-case examples, then supplies four explicit natural-language trigger phrases with synonym coverage. Both 'what' and 'when' are answered explicitly, and the niche is unmistakable.

DimensionReasoningScore

Specificity

The description lists multiple concrete, specific elements: 'Write a template playbook', 'a 1-2 KB per-use-case file', 'teaches the builder agent to configure one kind of Agenta agent (changelog writer, issue triager, support router)', and 'Encodes the file format, the prompting checklist, and the platform facts authors get wrong.' Coverage of the deliverable, its size, its audience, and its contents is comprehensive with no vague filler.

5 / 5

Completeness

Both 'what' and 'when' are explicitly answered: the what is a concrete deliverable ('a 1-2 KB per-use-case file that teaches the builder agent to configure one kind of Agenta agent') and the when is an explicit 'Use when' clause with concrete trigger phrases — exactly the anchor-5 pattern.

5 / 5

Trigger Term Quality

The trigger clause gives four natural user phrasings with synonym coverage: "Use when the ask is 'write a template playbook', 'add an agent template', 'author a playbook for the build-an-agent skill', or 'write the <X> playbook'." These are the exact phrasings a user would naturally say, covering write/add/author verb variations and template/playbook synonyms.

5 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — authoring playbooks specifically 'for the build-an-agent skill' — and its triggers name that skill explicitly ('author a playbook for the build-an-agent skill'), so it is unlikely to fire for unrelated template- or agent-writing requests. Minimal conflict risk.

5 / 5

Total

20

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository
Agenta-AI/agenta
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.