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.

66

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.github/skills/agent-academy-mission-builder/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 body delivers a clear, actionable, well-sequenced workflow for scaffolding Agent Academy missions, with concrete templates, naming formulas, and duplicate-detection steps. Its main weaknesses are token efficiency and bundle usage: the inline Special Ops template and naming rules duplicate existing reference files, and three of the four references/ files are orphaned (including a dangling 'See badge section' pointer where references/badge-spec.md should be cited).

Suggestions

Replace the inlined Special Ops template and detailed naming rules with pointers to references/special-ops-template.md and references/naming-guide.md, keeping only a short summary inline, to remove duplication and cut tokens.

Fix the dangling 'See badge section' pointer in Phase 2 by referencing references/badge-spec.md explicitly, and signal references/badge-spec.md, naming-guide.md, and special-ops-template.md in a Reference Files section so all bundle files are discoverable.

Trim the 'mission briefing officer' analogy paragraph and other scene-setting prose in the intro, which add tokens without instructional value.

DimensionReasoningScore

Conciseness

The body is mostly efficient, but it inlines two large artifacts that already exist as bundle files: a ~75-line Special Ops markdown template (duplicating references/special-ops-template.md) and detailed naming rules (duplicating references/naming-guide.md). Mild padding like the 'mission briefing officer' analogy paragraph adds tokens without instruction value. This fits the 3 anchor ('mostly efficient but includes some unnecessary explanation') rather than 2, since there is no conceptual over-explanation and most sections carry real guidance.

3 / 5

Actionability

Guidance is concrete throughout: exact file paths ('docs/[rank]/[NN]-[slug]/index.md'), specific duplicate-check search queries, a naming formula with worked examples ('Adaptive Cards → Operation Flash Card'), a star-to-difficulty mapping, and full markdown templates. It falls short of 5 because 'See badge section' (Phase 2) points to a section that does not exist in the body, leaving the badge workflow without a usable pointer.

4 / 5

Workflow Clarity

The Phase 0–7 sequence is clearly ordered and includes user-facing checkpoints: report reconnaissance findings before proceeding, surface close duplicates and ask whether to pivot, offer 2–3 name options for the user to pick, and end with an explicit pre-filled-vs-manual summary. It is not a destructive or batch-risk operation requiring validation caps, so the 4 anchor fits ('most checkpoints present; minor validation gaps') — a systematic final self-check of the generated markdown is the missing checkpoint.

4 / 5

Progressive Disclosure

The body is well sectioned and one reference is clearly signaled ('See references/tags.md for full tag taxonomy'), but the other three bundle files — badge-spec.md, naming-guide.md, and special-ops-template.md — are never referenced; their content is instead inlined or pointed at via a dangling 'See badge section' pointer. This matches the 3 anchor ('references present but not clearly signaled; content that should be separate is inline') better than 2, since structure and one correct reference exist.

3 / 5

Total

14

/

20

Passed

Description

96%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 description: it clearly states what the skill does with a comprehensive list of concrete capabilities, and provides abundant explicit trigger phrases a user would naturally say. The only weakness is the slightly broad trigger around agent-building concepts, which could invite overlap with generic agent-development or lesson-writing skills.

DimensionReasoningScore

Specificity

The description enumerates nine concrete capabilities — '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' — giving comprehensive, specific coverage rather than vague claims. This matches the 5 anchor ('multiple specific concrete actions; comprehensive coverage') and exceeds the 4 anchor, which expects minor gaps in coverage.

5 / 5

Completeness

It explicitly answers both questions: what the skill does ('Scaffold and author content for the microsoft/agent-academy GitHub repo... This skill handles: ...') and when to use it ('Use this skill whenever the user wants to create a new mission...', 'Trigger whenever the user says...'). This matches the 5 anchor (clear what AND when with concrete trigger phrases), not the 4 anchor where 'when' could be more explicit.

5 / 5

Trigger Term Quality

It includes many natural user phrasings with synonyms: 'write a mission', 'scaffold a lab', 'create a Special Ops', 'new Agent Academy module', 'add a module to agent academy', 'I want to contribute a mission', and 'badge creation'. Coverage is comprehensive with variations of how a user would actually ask, matching the 5 anchor rather than the 4 anchor ('a few natural terms missing').

5 / 5

Distinctiveness Conflict Risk

It is clearly scoped to a specific repository and mission types (Recruit/Operative/Commander, Special Ops), making it mostly distinct. However, 'describes an agent-building concept they want to turn into a hands-on lesson' is broad enough to overlap with generic agent-building or tutorial-authoring skills, a minor conflict risk that keeps it at the 4 anchor rather than the 5 anchor's 'minimal conflict risk'.

4 / 5

Total

19

/

20

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.

Validation — 15 / 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.