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

94%

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

93%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 dense, well-organized instruction skill that loads Claude with platform specifics it could not otherwise know and provides a copy-paste skeleton plus targeted reference pointers. The only gap is an implicit rather than explicit error-recovery loop in the Verify workflow.

Suggestions

Make the Verify error-recovery loop explicit, e.g. 'If the test_run verdict or trigger test fails, revise the instructions/tools and re-run before reporting success.'

Add a one-line note on how to recover when a required Connection is missing beyond 'request_connection and stop' (e.g., whether to retry after the user connects).

Dimension	Reasoning	Score
Conciseness	Lean and efficient; assumes Claude's competence and adds only domain-specific knowledge Claude lacks (Agenta platform facts, the #5190 default-field behavior, test_run delta mechanics) with no padding about basic concepts.	5 / 5
Actionability	Fully executable: a copy-paste markdown skeleton plus exact, specific rules (default field type matching, delta.set.parameters.agent.tools carries the FULL tools list, Lightning 'Test event' / Play 'Run' trigger tests) and concrete file paths.	5 / 5
Workflow Clarity	Clear sequence with an explicit section-to-build-loop mapping and Verify checkpoints (test_run verdict, trigger test), but the error-recovery 'if validation fails, fix and retry' loop is implicit rather than spelled out.	4 / 5
Progressive Disclosure	Clear overview with a well-signaled 'Read a reference when' table pointing one level deep to references/prompting-checklist.md and references/worked-example.md, both of which exist as real bundle files.	5 / 5
	Total	19 / 20 Passed

Description

95%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 strong, well-constructed description that concretely states what the skill does and gives explicit, natural trigger phrases. The only minor weakness is that the capability verbs ('encodes', 'teaches') are slightly more abstract than fully concrete action language.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ('Write a template playbook', 'teaches the builder agent to configure one kind of Agenta agent', 'Encodes the file format, the prompting checklist, and the platform facts authors get wrong'), but 'encodes' is more abstract than the anchor-5 example's hands-on verbs, leaving minor gaps.	4 / 5
Completeness	Explicitly answers both 'what' (write a 1-2 KB playbook that teaches the builder agent to configure one Agenta agent type) and 'when' (a concrete 'Use when the ask is...' clause with multiple trigger phrases).	5 / 5
Trigger Term Quality	Comprehensive natural trigger coverage including synonyms and phrasings 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'.	5 / 5
Distinctiveness Conflict Risk	Clear niche (template playbooks for the build-an-agent skill) with distinct, specific triggers and minimal overlap risk with other skills.	5 / 5
	Total	19 / 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: e4008fa

Reviewed: 5 days 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.