CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-academy-mission-builder

Scaffold and author content for the microsoft/agent-academy GitHub repo. Use this skill whenever the user wants to create a new mission, lab, or module for Agent Academy — whether that's a course mission (Recruit, Operative, Commander) or a standalone Special Ops mission. Trigger whenever the user says "write a mission", "scaffold a lab", "create a Special Ops", "new Agent Academy module", or describes an agent-building concept they want to turn into a hands-on lesson. Also trigger when the user says "add a module to agent academy", "I want to contribute a mission", or asks about badge creation for Special Ops. This skill handles: repo structure lookup, duplicate detection, mission naming, markdown scaffolding, step-by-step content drafting, cross-linking, tag/category suggestions, difficulty rating, and badge image generation for Special Ops missions.

72

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable and clearly sequenced, with full templates and explicit checkpoints. Its main weaknesses are mild verbosity and inlining large templates that duplicate existing reference files rather than pointing to them.

Suggestions

Move the Special Ops template (and optionally the Course Mission template) into reference files and link to them, reusing the existing references/special-ops-template.md, instead of inlining both full templates in SKILL.md.

Trim non-essential prose such as the 'mission briefing officer' metaphor and the scripted closing line, keeping the lean Phase instructions.

Clarify the 'Reference Files' list by distinguishing bundle references (references/tags.md) from repo files (WRITING_STYLE.md, docs/.../index.md) so navigation is unambiguous.

DimensionReasoningScore

Conciseness

Mostly efficient with actionable templates and instructions, but padded in places — the 'mission briefing officer' metaphor and the scripted closing line ('The bones are done...') add little. Not a 3 because some prose could be trimmed; not a 1 because it avoids explaining concepts Claude already knows.

2 / 3

Actionability

Provides two full copy-paste markdown templates, concrete file paths (docs/recruit/[NN]-[slug]/index.md), exact reconnaissance search queries, naming formula examples, and a badge URL pattern — fully executable guidance.

3 / 3

Workflow Clarity

Sequenced clearly as Phases 0–7 with an explicit duplicate-detection checkpoint ('If something very similar exists, flag it and ask') and a concrete Phase 7 deliverables list, matching the clear-sequence-with-checkpoints anchor.

3 / 3

Progressive Disclosure

Well-organized sections and real one-level references (references/tags.md exists), but the large course/Special-Ops templates are inlined in the body rather than split to the special-ops-template.md reference that already exists. Not a 3 because content that should be separate is inline; not a 1 because references are one-level and clearly signaled.

2 / 3

Total

10

/

12

Passed

Description

100%

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: it names concrete capabilities, provides explicit trigger phrases, answers both what and when, and is tightly scoped to a clear niche. No changes needed.

DimensionReasoningScore

Specificity

Lists many concrete actions — 'repo structure lookup, duplicate detection, mission naming, markdown scaffolding, step-by-step content drafting, cross-linking, tag/category suggestions, difficulty rating, and badge image generation' — matching the multiple-specific-actions anchor.

3 / 3

Completeness

Explicitly states both what the skill does and when to trigger it ('Use this skill whenever...', 'Trigger whenever the user says...'), satisfying both what-and-when with explicit triggers.

3 / 3

Trigger Term Quality

Covers natural phrasings users would actually say ('write a mission', 'scaffold a lab', 'create a Special Ops', 'I want to contribute a mission', 'badge creation'), with good variation.

3 / 3

Distinctiveness Conflict Risk

Scoped tightly to the microsoft/agent-academy repo with distinctive triggers (Agent Academy, Special Ops, badge creation), making conflict with other skills unlikely.

3 / 3

Total

12

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing, 3 suspicious

Warning

Total

15

/

16

Passed

Repository
microsoft/agent-academy
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.