CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-mgmt-botservice-dotnet

Azure Resource Manager SDK for Bot Service in .NET. Management plane operations for creating and managing Azure Bot resources, channels (Teams, DirectLine, Slack), and connection settings.

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/azure-mgmt-botservice-dotnet/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 well-structured, largely executable SDK skill whose code examples cover the core bot and channel management tasks. Weaker points are missing validation steps around destructive operations, some padded reference/version material, and one promised capability (connection settings) without an example.

Suggestions

Add a validation step to destructive/batch workflows, e.g., after Delete Bot, list channels or get the bot to confirm removal, and catch 404 as success.

Trim the version numbers and the circular 'When to Use' section, and move enum/value tables (BotServiceKind, SkuName, MsaAppType) into a reference file or rely on the linked API docs.

Add a BotConnectionSettingResource workflow example so the connection-settings capability named in the description has concrete coverage.

DimensionReasoningScore

Conciseness

The workflows are mostly efficient code, but the body includes time-sensitive details ('Current Versions: Stable v1.1.1, Preview v1.1.0-beta.1') outside any deprecation section, inline enum/API reference tables (BotServiceKind, SkuName, MsaAppType, Key Types) that mostly restate what Claude can find via the linked API reference, and a circular 'When to Use' section ('This skill is applicable to execute the workflow or actions described in the overview'). This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'.

3 / 5

Actionability

Concrete, executable C# covering installation, auth, and the eight core workflows (create bot, configure DirectLine/Teams/Web Chat channels, get/list, regenerate keys, update, delete), plus error handling. Minor gaps keep it below 5: connection settings are promised in the description and Key Types table but never shown, and workflows 3-4 reference a `channels` variable only defined in workflow 2.

4 / 5

Workflow Clarity

Workflows are numbered and clearly sequenced with an error-handling section, but there are no validation checkpoints (e.g., verify a channel is enabled after creation) and the destructive Delete Bot workflow has no verification step, which caps workflow clarity at 3 per the destructive-operations guideline. It is above 2 because the sequence itself is coherent and well defined.

3 / 5

Progressive Disclosure

No bundle files exist, and the single file is well organized with clear section headers and an explicit Reference Links table pointing to NuGet, API reference, and source. Minor gaps: the enum value tables and Related SDKs sections are reference material that could live in a separate file, keeping it below a 5-quality split.

4 / 5

Total

14

/

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.

A specific, third-person description that clearly states what the SDK manages, with good natural trigger terms for the Azure bot niche. Its main weakness is the missing 'Use when...' trigger guidance, which caps completeness and leaves activation conditions implicit.

Suggestions

Append an explicit trigger clause, e.g. 'Use when provisioning or managing Azure Bot Service resources, configuring channels (DirectLine, Teams, Slack, Web Chat), or setting up OAuth connection settings in .NET with C#.'

Add natural synonym terms users would say — 'C#', 'ARM', 'provision/deploy Azure bot' — to broaden trigger matching.

Mention one or two more concrete operations (e.g., regenerating DirectLine keys, listing channels) to move specificity toward comprehensive coverage.

DimensionReasoningScore

Specificity

Names several concrete actions — 'creating and managing Azure Bot resources, channels (Teams, DirectLine, Slack), and connection settings' — which matches the 'lists several specific actions; minor gaps in coverage' anchor. It falls short of 5 because operations like listing/regenerating keys or updating bots are not mentioned, and it is clearly above 3 since more than 1-2 concrete actions are enumerated.

4 / 5

Completeness

The 'what' is clear (management plane operations for bots, channels, and connection settings) but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 4 because the 'when' is entirely absent rather than merely implicit-but-present.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'Azure Bot resources', 'channels (Teams, DirectLine, Slack)', '.NET', 'connection settings'. Missing a few natural variations users would say such as 'C#', 'provision', or 'ARM', which keeps it below the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

'Management plane operations' plus the specific Azure Bot Service/.NET niche makes it mostly distinct with minor overlap risk against the closely related Bot Framework/Bot Builder SDK (referenced in the body as a separate package). It does not reach 5 because terms like 'Bot' and 'channels' alone could still collide with bot-framework conversational skills.

4 / 5

Total

15

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/azure-mgmt-botservice-dotnet/SKILL.md

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.