Skills Generation Run Deploy

The content PR lives on diberry/azure-dev-docs-pr, branch squad/ai-dev-tools-docset:

cd C:\Users\diberry\project-dina\repos
# Already cloned as azure-dev-docs-pr-diberry

Full Generation Workflow

Step 1: Build

cd microsoft-mcp-doc-generation/skills-generation
dotnet build skills-generation.slnx --configuration Release

Step 2: Run tests

dotnet test skills-generation.slnx
# Expected: 152 passed, 0 failed

Step 3: Generate all 24 skills

dotnet run --project SkillsGen.Cli --configuration Release -- \
  generate-skills --all --no-llm --source local \
  --source-path "C:\Users\diberry\project-dina\repos\GitHub-Copilot-for-Azure\plugin\skills" \
  --tests-path "C:\Users\diberry\project-dina\repos\GitHub-Copilot-for-Azure\tests" \
  --out "../generated-skills/"
# Expected: 24/24 passed, ~3-5 seconds

Step 4: Run Vale lint

pwsh scripts/lint-vale.ps1 -TargetDir ../generated-skills/
# Expected: ~21 issues (mostly false positives)

Step 5: Deploy to content PR

cd C:\Users\diberry\project-dina\repos\azure-dev-docs-pr-diberry
git checkout squad/ai-dev-tools-docset

# Remove old and copy new
Get-ChildItem "articles/azure-skills/skills/*.md" | Remove-Item
$genDir = "C:\Users\diberry\project-dina\repos\microsoft-mcp-doc-generation\generated-skills"
Get-ChildItem "$genDir\*.md" | ForEach-Object {
    Copy-Item $_.FullName "articles/azure-skills/skills/$($_.Name)"
}

# Commit and push
git add articles/azure-skills/skills/
git commit -m "Regenerate skill pages

Co-authored-by: Copilot <[email protected]>"
git push origin squad/ai-dev-tools-docset

Step 6: Wait for Acrolinx

Acrolinx re-scores automatically on every push to the content PR (~2-3 min). Check the PR comments for the latest scorecard.

Single Skill Generation

For iterating on one skill:

dotnet run --project SkillsGen.Cli --configuration Release -- \
  generate-skill azure-storage --no-llm --source local \
  --source-path "C:\Users\diberry\project-dina\repos\GitHub-Copilot-for-Azure\plugin\skills" \
  --tests-path "C:\Users\diberry\project-dina\repos\GitHub-Copilot-for-Azure\tests" \
  --out "../generated-skills/"

CLI Options Reference

Important: Rate Limit Prevention

NEVER use --source github for iterative work. Each skill needs 2 API calls (SKILL.md + triggers.test.ts). With 24 skills and retries, this exhausts the GitHub API quota quickly. Always clone once and use --source local.