Azure / Azure/azure-sdk-tools

Review skill organization: break out Docs & Metadata Updates into a Prepare for Release skill

Open
#14,549 0 comments 0 reactions 0 assignees View on GitHub
AzSDK Tools Agent
Dominant language
C#
Stars
135
Forks
260
Avg merge
3d 1h
Merged PRs (30d)
143

Description

## Description

Review the current skill setup for the AzSDK Tools agent. Specifically, evaluate whether the **Docs & Metadata Updates** section currently in the **Generate SDK Locally** skill should be extracted and placed into a separate **Prepare for Release** skill.

The Generate SDK Locally skill may be doing too much by bundling doc/metadata update steps alongside SDK generation. A dedicated Prepare for Release skill would better scope the release-readiness steps (docs, metadata, changelog updates) as a distinct workflow.

## Tasks

- Review the current Generate SDK Locally skill and identify which steps relate to docs/metadata updates
- Determine if those steps are better suited for a standalone Prepare for Release skill
- If yes, draft the new skill and update the existing one
- Ensure no gaps in coverage between the two skills

## Original Context

Ronnie's request: *"Look at the skill setup for the AzSDK Tools agent and see if any should be broken up. Specifically the Docs & Metadata Updates — should those not be in the Generate SDK Locally skill and instead be placed in a Prepare for Release skill?"*

Contributor guide

Open the contributing guide

Research direction

Start by locating the AzSDK Tools agent's skill definitions and reading the Generate SDK Locally skill, especially its Docs & Metadata Updates section. Map the documentation, metadata, and changelog steps to the proposed workflows, then compare both skill scopes for coverage. Done means the skills have a clear separation with no missing release steps.

Written by the indexing model from the issue text.

Assessment

Domain
documentation, release, tooling
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.