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.

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%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 content is a tight, well-structured instruction skill: a copy-paste skeleton, concrete platform rules, explicit validation steps, and clean one-level-deep references to real bundle files. It respects the token budget by omitting what the model already knows.

Dimension	Reasoning	Score
Conciseness	Lean and efficient: it explicitly omits what the model already knows (build loop, config schema, tool wire shapes) and reserves tokens for the non-obvious platform facts authors get wrong. Every section earns its place within the stated 1-2 KB budget discipline.	5 / 5
Actionability	Provides a copy-paste-ready markdown skeleton with exact section names and per-field rules, plus three concrete platform facts with pinned specifics (e.g. '#5190', 'delta.set.parameters.agent.tools', Lightning 'Test event' / Play 'Run') — fully executable guidance for an instruction-only skill.	5 / 5
Workflow Clarity	The skeleton lays out a clear sequenced build (Match → Required/Researchable → Explore → Defaults → Connections → Instructions → Verify → Report), maps each section to the build loop, and includes explicit Verify validation steps (blunt test_run + trigger test) as feedback checkpoints.	5 / 5
Progressive Disclosure	The body is a well-organized overview that defers detail to one-level-deep, clearly signaled references — a 'Read a reference when' table pointing to references/prompting-checklist.md and references/worked-example.md, both of which exist as real bundle files — plus the canonical spec path.	5 / 5
	Total	20 / 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.

The description is exemplary: third-person voice, concrete capabilities, comprehensive natural trigger phrases, and a clear niche. It answers both 'what' and 'when' without padding or over-claims.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Write a template playbook', 'teaches the builder agent to configure one kind of Agenta agent', and 'Encodes the file format, the prompting checklist, and the platform facts authors get wrong' — with comprehensive coverage of what the skill produces.	5 / 5
Completeness	Explicitly answers both what (a 1-2 KB per-use-case playbook encoding file format, prompting checklist, and platform facts) and when (a 'Use when the ask is...' clause with concrete trigger phrases).	5 / 5
Trigger Term Quality	Provides comprehensive natural trigger phrases a user would actually say — 'write a template playbook', 'add an agent template', 'author a playbook for the build-an-agent skill', 'write the <X> playbook' — including synonym variations.	5 / 5
Distinctiveness Conflict Risk	Occupies a clear niche ('template playbook for the build-an-agent skill') with distinct, specific triggers that make it unlikely to fire for unrelated skills.	5 / 5
	Total	20 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
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
Path: .agents/skills/write-template-playbooks/SKILL.md
Commit: a09a0f0

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.