CtrlK
BlogDocsLog inGet started
Tessl Logo

microsoft-docs

استعلام عن الوثائق الرسمية لشركة Microsoft للعثور على المفاهيم والدروس والأمثلة البرمجية عبر Azure و .NET و Agent Framework و Aspire و VS Code و GitHub والمزيد. يستخدم Microsoft Learn MCP كالإعداد الافتراضي، مع Context7 و Aspire MCP للمحتوى المتواجد خارج learn.microsoft.com.

63

Quality

74%

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 ./translations/ar/.agents/skills/microsoft-docs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 is a well-structured, highly actionable tool-routing skill with concrete MCP tools, library IDs, and version-gated guidance. It is concise and well-organized, with the main weakness being incidental boilerplate (the translation disclaimer) rather than structural issues.

DimensionReasoningScore

Conciseness

Mostly lean — routing tables, brief tool descriptions, and tight query examples — with only minor trimmable padding such as the Co-op Translator disclaimer boilerplate; assumes Claude's competence rather than over-explaining.

4 / 5

Actionability

Fully actionable: names exact tools (microsoft_docs_search, microsoft_code_sample_search, microsoft_docs_fetch), concrete Context7 library IDs, a sequenced resolve-then-query setup, and copy-ready good/bad query examples covering common cases.

5 / 5

Workflow Clarity

Clear default-then-exception routing with version-gated guidance (Aspire CLI 13.2+ vs 13.1) and a numbered Context7 setup sequence; a search/routing skill without destructive steps, so validation checkpoints are less critical, but minor gaps keep it just below 5.

4 / 5

Progressive Disclosure

Well-organized into clearly signaled sections (default MCP, per-category exceptions, Context7 setup, query writing) with no bundle files present; self-contained content is appropriately placed, with only minor organization gaps.

4 / 5

Total

17

/

20

Passed

Description

66%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 clearly conveys what the skill does and its Microsoft-docs niche with strong keyword coverage, but lacks an explicit 'Use when...' trigger clause that would lift completeness. It is third-person throughout (masdar form), avoiding the voice penalty.

Suggestions

Add an explicit trigger clause such as 'Use when the user asks about Microsoft documentation, Azure, .NET, Aspire, VS Code, or GitHub docs' to raise completeness from 3.

Include common synonyms/file extensions users might say (e.g., 'M365', 'Power Platform', 'Learn docs') to push trigger-term coverage toward 5.

DimensionReasoningScore

Specificity

Names the domain (Azure, .NET, Agent Framework, Aspire, VS Code, GitHub) and concrete actions ('استعلام عن الوثائق... للعثور على المفاهيم والدروس والأمثلة البرمجية') plus the specific MCP tools used; minor gaps in coverage keep it just below 5.

4 / 5

Completeness

Has a clear 'what' (query Microsoft docs across listed technologies via Learn MCP/Context7/Aspire MCP) but no explicit 'Use when...' trigger clause, so 'when' is only weakly implied — capped at 3 per the missing-trigger guideline.

3 / 5

Trigger Term Quality

Good natural keyword coverage with product names users actually say (Azure, .NET, Aspire, VS Code, GitHub); a few common phrasings are missing, so not a 5.

4 / 5

Distinctiveness Conflict Risk

Clearly scoped to the Microsoft documentation ecosystem with specific MCP routing, giving it a distinct niche; minor overlap risk with general Context7/search skills keeps it at 4.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
microsoft/ai-agents-for-beginners
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.