microsoft / microsoft/azure-sql-database-container
[Feature]: Add install verification step and Windows guidance to the agent skills install docs
@croblesm is already working on this.
Since Jul 16, 2026.
- Dominant language
- Shell
- Stars
- 17
- Forks
- 4
- Avg merge
- 9h 49m
- Merged PRs (30d)
- 15
Description
Use case
A developer on Windows follows the site's primary install path (npx skills add) to use the agent skills with Claude Code, Codex, or Cursor. The installer reports success, but the skills never load in the agent (see bug #[X]). Because the failure is silent, the developer's next observation is an unskilled agent defaulting to SQLite/Postgres/the mssql/server image, and the natural conclusion is "the skills don't work," which reads as a product failure rather than an install failure.
Current workaround
Manually copying the skill folders into the agent's documented skills directory (e.g. .claude/skills for Claude Code), per the README's manual install method. Verified working: all 10 skills load and trigger as designed after the copy.
Proposed behavior
- A one-line verification step at the end of the install instructions: start the agent and ask "what skills do you have available," and confirm the azuresql-db skills appear. Catches silent install failures immediately.
- A Windows note documenting the manual copy as the reliable path until the CLI's Windows install (symlink step) is validated.
Who benefits
All developers
Urgency
Important for my Public Preview adoption
Additional context
Related: bug #[X] (root cause: skills installed to .agents/skills, agent-specific link not created on Windows). Only Claude Code verified; other agents likely affected the same way.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.