CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.

67

2.06x
Quality

51%

Does it follow best practices?

Impact

95%

2.06x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

40%

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 too abstract and reads more like a category label than a functional skill description. It fails to enumerate specific actions or outputs (e.g., generating skill YAML, structuring instructions, defining triggers) and relies on vague framing ('guide for creating effective skills'). While it does include a 'Use when' clause and some domain-specific terms, the lack of concrete capabilities significantly limits its usefulness for skill selection.

Suggestions

List specific concrete actions the skill performs, e.g., 'Generates skill YAML frontmatter, structures step-by-step instructions, defines trigger terms, and provides Azure SDK code patterns for Foundry agent skills.'

Expand trigger terms to include natural variations users might say, such as 'write a new skill', 'skill template', 'Azure SDK skill', 'Foundry agent skill', 'update skill file', '.md skill'.

Clarify the 'when' clause with more specific scenarios, e.g., 'Use when the user asks to author, edit, or review a skill file targeting Azure SDK integrations or Microsoft Foundry agent workflows.'

DimensionReasoningScore

Specificity

The description uses vague language like 'creating effective skills' and 'working with Azure SDKs and Microsoft Foundry services' without listing any concrete actions. It doesn't specify what the skill actually does beyond being a 'guide'.

1 / 3

Completeness

It has a weak 'what' (guide for creating skills) and an explicit but vague 'when' clause ('Use when creating new skills or updating existing skills'). The 'what' is too abstract to be truly useful, but the 'when' clause is present, preventing a score of 1.

2 / 3

Trigger Term Quality

It includes some relevant keywords like 'Azure SDKs', 'Microsoft Foundry', and 'skills', but misses common variations and natural terms users might say such as 'Azure SDK patterns', 'Foundry agent', 'skill template', or 'skill authoring'.

2 / 3

Distinctiveness Conflict Risk

The mention of 'Azure SDKs and Microsoft Foundry services' provides some specificity, but 'creating effective skills for AI coding agents' is broad enough to overlap with any general skill-authoring or meta-skill guidance.

2 / 3

Total

7

/

12

Passed

Implementation

62%

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

This is a comprehensive and highly actionable meta-skill for creating Azure SDK skills, with excellent workflow clarity and concrete executable examples. However, it severely violates its own conciseness principles — it's extremely long, repeats the authentication callout block multiple times, inlines multi-language code examples that belong in reference files, and explains concepts the target audience (an AI agent) already understands. The skill would benefit enormously from practicing what it preaches about progressive disclosure and token efficiency.

Suggestions

Move the multi-language authentication code examples (Python, C#, Java, TypeScript, Rust) into `references/azure-sdk-patterns.md` and keep only one representative example inline in SKILL.md.

Move the detailed Best Practices variant table and the Required Authentication Callout rules into a reference file (e.g., `references/python-conventions.md`), keeping only a brief summary and pointer in the main body.

Remove the 'About Skills' section entirely — an AI agent creating skills doesn't need to be told what skills are. Similarly, trim explanatory prose throughout (e.g., 'Skills are modular knowledge packages that transform general-purpose agents into specialized experts').

Consolidate the authentication callout: it appears as a template, then again in the example skill structure. Show it once and reference it the second time.

DimensionReasoningScore

Conciseness

This skill is extremely verbose at ~500+ lines. It extensively explains concepts an AI agent already knows (what skills are, what progressive disclosure means, general software engineering practices). The authentication callout block is repeated multiple times (template, example, and explanation). The multi-language code examples for authentication patterns are largely redundant when the skill could reference a single pattern file. Many sections like 'About Skills' and the detailed variant tables could be dramatically condensed.

1 / 3

Actionability

The skill provides highly concrete, executable guidance throughout: specific directory structures, exact bash commands for symlinks, complete YAML frontmatter examples, full code samples in multiple languages, precise file paths for tests, and copy-paste ready templates for acceptance criteria and test scenarios. The checklist at the end is directly actionable.

3 / 3

Workflow Clarity

The 8-step skill creation process is clearly sequenced with explicit validation checkpoints (Step 6 testing with specific commands, Step 7 documentation updates with verification steps). Each step has clear inputs and outputs. The checklist at the end serves as a final validation gate covering prerequisites, creation, categorization, testing, and documentation.

3 / 3

Progressive Disclosure

The skill references external files like `references/azure-sdk-patterns.md`, `references/workflows.md`, and `references/output-patterns.md`, which is good. However, no bundle files are provided, so we can't verify these exist. More critically, the SKILL.md itself is monolithic — the lengthy authentication patterns across 5 languages, the detailed variant tables for best practices, and the full test scenario examples should be split into reference files rather than inlined. The skill acknowledges the 500-line limit but appears to violate its own guidance.

2 / 3

Total

9

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (871 lines); consider splitting into references/ and linking

Warning

Total

10

/

11

Passed

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