agentleFS
MicrosoftKnown publishermicrosoft/sqlcon-eu-2026-demos/corenote/migration/skills/recommend-sku-sizing/SKILL.md

recommend-sku-sizing

Skill0 starsChanged 53 days agoMITView on GitHub

Collect performance data and calculate Azure SQL SKU recommendations only after the source is explicitly confirmed local/on-premises. Never use for a generic SKU request or bare server name; route unresolved requests through run-migration-assessment.

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 3 are distinctive, and 6 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 6

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use directly or from run-migration-assessment when a local/on-premises server needs performance-based Azure SQL sizing.

    line 11
  2. Very specific:

    If the source is not explicit, do not ask for an instance name, output folder, credentials, collection duration, or target platform.

    line 25
  3. Very specific:

    Run the host-specific lookup from references/command-execution.md.

    line 39
  4. Distinctive:

    No result -> explain that performance collection is required and ask whether to continue.

    line 43
  5. Distinctive:

    Use local server connection for missing connection details.

    line 51
  6. Very specific:

    Use the parameter-alignment rule in references/command-execution.md.

    line 55
  7. Very specific:

    Run the exact detached collection and SKU command from references/command-execution.md.

    line 60
  8. Very specific:

    When requested, run the completion check from references/command-execution.md.

    line 66
  9. Distinctive:

    Always ask for collection duration.

    line 80

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Recommend SKU Sizing

When to Use

Use directly or from run-migration-assessment when a local/on-premises server needs performance-based Azure SQL sizing. Invoke after the server is confirmed Local. Route Azure identifiers and unresolved servers through run-migration-assessment.

Workflow

Step 0: Enforce Source Routing

Proceed only when the current conversation explicitly identifies the source as Local or on-premises, or already provides local evidence such as an IP address, connection string, or config file. The words SQL Server, server, or SKU recommendation alone do not establish that the source is Local.

If the source is not explicit, do not ask for an instance name, output folder, credentials, collection duration, or target platform. Invoke run-migration-assessment so it can ask whether the source is Azure or Local.

Step 1: Check the Host and Confirm Inputs

Apply OS requirements, then assessment prerequisites, before collecting local inputs. Confirm the output folder with selectable Default (%LOCALAPPDATA%\Microsoft\SqlAssessment) and Custom choices. Wait for the answer and use the selected path.

Step 2: Check Existing Results

Run the host-specific lookup from references/command-execution.md.

  • Existing result -> render it with its generation time and refresh only if explicitly requested.
  • No result -> explain that performance collection is required and ask whether to continue.

SKU filenames are not instance-specific. Use a per-instance output folder to associate results with the selected server.

Step 3: Collect Parameters

Use local server connection for missing connection details. Ask for collection duration with selectable 2-hour and 24-hour (Recommended) options, plus "I don't want a SKU recommendation". Allow a custom duration. Stop if the user declines. Convert the duration to seconds. Use the parameter-alignment rule in references/command-execution.md. Do not start a collection that cannot complete one persistence cycle.

Step 4: Start Collection

Run the exact detached collection and SKU command from references/command-execution.md. Show the collection-started output from assessment output.

Step 5: Check and Render Results

When requested, run the completion check from references/command-execution.md.

  • Complete -> read the newest SKU JSON report when available. Extract only the recommended target's compute and storage configuration and populate those fields in the Skill Response Template in assessment output. Include readiness if readiness results are already available in the current conversation context. Otherwise omit the Migration Readiness section and show the SKU data only.
  • Running -> show collection status.
  • Stopped without time-series data -> report failure and show the log path.

Notes

  • Confirm the output folder before checking files.
  • Always ask for collection duration.
  • Reuse existing performance data when the user returns.
  • Static common counter files alone do not mean collection completed.

Error Handling

  • Collection stops -> check connectivity and restart with the same folder.
  • Output permission denied -> confirm write access or select another folder.
  • Tool or extension unavailable -> follow assessment prerequisites.

References

  • references/command-execution.md
  • Local server connection
  • OS requirements
  • Assessment prerequisites
  • Assessment output

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.