[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78F2WJ5YAMXVZDCXWJF62CT":3,"skill-same:01M78F2WJ5YAMXVZDCXWJF62CT":108},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":45},"01M78F2WJ5YAMXVZDCXWJF62CT","azure-devops-cli",null,"Azure DevOps operations via Azure CLI (azure-devops extension). Configure org\u002Fproject from pipeline.manifest.json, create PRs after Phase 9 approval, list pipelines, and manage work items. Use when pr.type is azure-devops or azure-pipelines\u002F is present.","angpysha\u002Fapi2skill","angpysha","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F7025170?v=4","01M721R7EB17NTYWEFV7KW1B3Q","Andrii","01M78F2DTB4D5VB2WXKXBN0VFT",0,"MIT","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: azure-devops-cli\ndescription: >-\n  Azure DevOps operations via Azure CLI (azure-devops extension). Configure org\u002Fproject from\n  pipeline.manifest.json, create PRs after Phase 9 approval, list pipelines, and manage work\n  items. Use when pr.type is azure-devops or azure-pipelines\u002F is present.\ndisable-model-invocation: true\n---\n\n# azure-devops-cli\n\nDeterministic **Azure DevOps** integration using the official **Azure CLI** with the\n`azure-devops` extension (`az repos`, `az pipelines`, `az boards`, `az devops`). Reads\n`pipeline.manifest.json` `pr.*` for organization, project, repository, and target branch.\n\n**Not** Azure Resource Manager (`az group`, `az vm`) — only Azure DevOps services.\n\n## Prerequisites\n\n| Tool | Install |\n|------|---------|\n| Azure CLI | https:\u002F\u002Flearn.microsoft.com\u002Fcli\u002Fazure\u002Finstall-azure-cli |\n| `azure-devops` extension | `az extension add --name azure-devops` (or use script below) |\n\n### Authentication\n\nAzure DevOps CLI uses a **Personal Access Token (PAT)** — not the same session as `az login`\nfor Azure Resource Manager. Create a PAT in Azure DevOps:\n\n**User settings → Personal access tokens → New token**\n\n| Scope (minimum) | Used for |\n|-----------------|----------|\n| **Code** (Read & write) | `az repos` — PRs, branches |\n| **Work Items** (Read & write) | `az boards` — work items |\n| **Build** (Read) | `az pipelines` — list runs, status |\n\nSet expiration as your org policy allows. Never commit the PAT.\n\n#### Option A — environment variable (CI \u002F scripts)\n\n```bash\nexport AZURE_DEVOPS_EXT_PAT=\"your-pat-here\"\n```\n\n`ensure-azure-devops.ps1` and all skill scripts pick this up automatically.\n\n#### Option B — macOS Keychain (recommended for local dev)\n\nStore the PAT once in Keychain, then load it into the env var before `az devops login`:\n\n```bash\n# One-time: save PAT to Keychain (replace with your token)\nsecurity add-generic-password -a \"$USER\" -s AZDO_PAT -w \"your-pat-here\" -U\n\n# Update existing entry\nsecurity add-generic-password -a \"$USER\" -s AZDO_PAT -w \"new-pat\" -U\n```\n\nAdd to `~\u002F.zshrc` (set `AZDO_ORG` to match `pipeline.manifest.json` `pr.org`):\n\n```bash\nazdo-login() {\n  export AZURE_DEVOPS_EXT_PAT=\"$(security find-generic-password -s AZDO_PAT -w)\"\n  az devops login --organization \"https:\u002F\u002Fdev.azure.com\u002F${AZDO_ORG:-petrovskyitools}\"\n}\n```\n\nUsage:\n\n```bash\nexport AZDO_ORG=petrovskyitools   # or your org slug\nazdo-login\npwsh .cursor\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fensure-azure-devops.ps1\n```\n\n`az devops login` reads `AZURE_DEVOPS_EXT_PAT` from the environment — the function sets both.\n\n#### Option C — interactive pipe (quick test)\n\n```bash\necho \"$AZURE_DEVOPS_EXT_PAT\" | az devops login --organization https:\u002F\u002Fdev.azure.com\u002Fmy-org\n```\n\n#### Verify auth\n\n```powershell\npwsh .cursor\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fensure-azure-devops.ps1 -Json\npwsh .cursor\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fconfigure-azure-devops.ps1\n```\n\n| Context | Method |\n|---------|--------|\n| macOS local | Keychain + `azdo-login` → `AZURE_DEVOPS_EXT_PAT` |\n| Linux \u002F WSL | `export AZURE_DEVOPS_EXT_PAT=...` or secret manager |\n| CI \u002F agent | Pipeline secret → `AZURE_DEVOPS_EXT_PAT` env var |\n| Azure RM resources | Separate: `az login` (not used for DevOps CLI in this skill) |\n\n## Manifest configuration\n\nSet in `pipeline.manifest.json`:\n\n```json\n\"pr\": {\n  \"type\": \"azure-devops\",\n  \"org\": \"my-org\",\n  \"project\": \"MyProject\",\n  \"repo\": \"MyRepo\",\n  \"target_branch\": \"main\",\n  \"branch_prefix\": { \"feature\": \"feature\u002F\", \"fix\": \"fix\u002F\", \"chore\": \"chore\u002F\" }\n}\n```\n\n- `org` — organization name or full URL (`https:\u002F\u002Fdev.azure.com\u002Fmy-org`)\n- `project` — Azure DevOps project name\n- `repo` — Git repository name (for `az repos pr create`)\n\n## Commands\n\n```powershell\n$ADO = '.cursor\u002Fskills\u002Fazure-devops-cli\u002Fscripts'\n\n# 1. Verify CLI + extension + auth (+ optional install extension)\npwsh $ADO\u002Fensure-azure-devops.ps1 -InstallExtension\n\n# 2. Apply manifest defaults to az devops configure\npwsh $ADO\u002Fconfigure-azure-devops.ps1\n\n# 3. Mutating passthrough — org\u002Fproject injected automatically\npwsh $ADO\u002Faz-devops.ps1 pipelines run --name \"CI\" --branch main\npwsh $ADO\u002Faz-devops.ps1 boards work-item create --title \"Implement REQ-0006\" --type Task\n\n# 4. Read queries — JSON source + TOON projection (token-efficient)\n$Q = \"$ADO\u002Faz-devops-query.ps1\"\npwsh $Q -ListRecipes\npwsh $Q -Recipe pr-list -Session 20260610-my-feature -Stats\npwsh $Q -Recipe pr-show -Vars @{ id = 42 } -SaveOnly\npwsh $Q -Recipe pipeline-runs -Vars @{ pipelineId = 12; top = 5 }\npwsh $Q repos pipelines list --top 3   # freeform passthrough\n\n# 5. Phase 10 — create PR (ONLY after Phase 9 human approval)\npwsh $ADO\u002Fcreate-pr.ps1 `\n  -SourceBranch feature\u002FREQ-0006-my-feature `\n  -Title \"feat(REQ-0006): My feature\" `\n  -DescriptionFile docs\u002Fsdlc\u002Fcloseout\u002FREQ-0006-summary.md `\n  -Push -Approved `\n  -OutputJson _code_agent\u002Fpr-result.json\n```\n\n## Pipeline placement\n\n| Phase | Agent | Azure DevOps responsibility |\n|-------|-------|----------------------------|\n| **6** | `team-lead` (+ `devops`) | Link plan tasks to ADO work items when tracker maps to boards |\n| **7** | `devops` | Pipeline YAML changes; trigger validation builds via `az pipelines` |\n| **10** | `coordinator` | **PR creation** via `create-pr.ps1` after human approval |\n\n**Coordinator rule:** never pass `-Approved` or `-Push` until Phase 9 gate passes.\n\n## TOON query workflow (token-efficient reads)\n\nRead-only Azure DevOps data uses **JSON source + TOON projection** (same pattern as\n`checkpoint` skill):\n\n```mermaid\nflowchart LR\n  Recipe[az-devops-query.ps1] --> Az[\"az --query JMESPath -o json\"]\n  Az --> JsonFile[\"artifacts\u002Fado\u002F*.json\"]\n  JsonFile --> ToonFile[\"artifacts\u002Fado\u002F*.toon\"]\n  ToonFile --> Agent[Agent reads path or truncated stdout]\n```\n\n| Step | What |\n|------|------|\n| 1 | `az --query` drops unused fields (JMESPath) |\n| 2 | Shaped JSON saved as source of truth |\n| 3 | `agentic-tool toon encode` (or Python fallback) writes `.toon` |\n| 4 | Agent cites **paths** in chat — not full TOON bodies |\n\n### Query flags\n\n| Flag | Behavior |\n|------|----------|\n| `-Recipe {id}` | Named query from `catalog\u002Frecipes.json` |\n| `-Vars @{ ... }` | Template variables for recipe |\n| `-Session {code}` | Write under `_code_agent\u002F{session}\u002Fartifacts\u002Fado\u002F` |\n| `-SaveOnly` | Index line only (path + bytes) |\n| `-PrintToon` (default) | Also print TOON to stdout |\n| `-MaxChars N` | Truncate stdout; full content in file |\n| `-Stats` | Print JSON vs TOON token estimate |\n| `-ListRecipes` | TOON table of available recipes |\n\n### Recipe catalog\n\nSee [`catalog\u002FREADME.md`](catalog\u002FREADME.md). Recipes: `pr-list`, `pr-show`, `pipeline-list`,\n`pipeline-runs`, `pipeline-run-show`, `work-item-show`, `work-item-query`, `repo-list`.\n\n### TOON encoders (priority order)\n\n1. **`agentic-tool toon encode --stdin`** — Cysharp ToonEncoder (same as checkpoints)\n2. **`json-to-toon.py`** — Python fallback: `pip install 'toon-format==0.9.0b1'`\n\nStandalone encode:\n\n```powershell\nagentic-tool toon encode --file data.json --stats\necho '{\"items\":[1,2,3]}' | agentic-tool toon encode --stdin\npython3 .cursor\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fjson-to-toon.py --stdin --stats\n```\n\n### Token savings (measured)\n\nRun `pwsh scripts\u002Fbench-toon.ps1` to reproduce. Samples in `catalog\u002Fsamples\u002F`.\n\n| Shape | JSON tokens | TOON tokens | Saved |\n|-------|-------------|-------------|-------|\n| PR list (10 rows, shaped via `--query`) | 530 | 369 | **30%** |\n| PR list (10 rows, raw nested `az` output) | 1036 | 1114 | **-7%** (worse) |\n| Pipeline runs (2 rows, shaped) | 93 | 74 | **20%** |\n\n**Key insight:** JMESPath shaping before TOON is required. Raw nested JSON can cost *more* tokens as TOON.\nAlways use `-Recipe` or `--query` projection.\n\n## Common operations\n\n### Repos (pull requests, branches)\n\n```powershell\npwsh $Q -Recipe pr-list -Session $SESSION -SaveOnly\npwsh $Q -Recipe pr-show -Vars @{ id = 42 }\npwsh $ADO\u002Faz-devops.ps1 repos ref list --filter heads\u002F\n```\n\n### Pipelines (CI\u002FCD)\n\n```powershell\npwsh $Q -Recipe pipeline-list\npwsh $Q -Recipe pipeline-runs -Vars @{ pipelineId = 12; top = 5 }\npwsh $ADO\u002Faz-devops.ps1 pipelines run --id 12 --branch feature\u002FREQ-0006-slug\n```\n\n### Boards (work items)\n\n```powershell\npwsh $Q -Recipe work-item-show -Vars @{ id = 12345 }\npwsh $ADO\u002Faz-devops.ps1 boards work-item create --title \"Implement REQ-0006\" --type Task\npwsh $ADO\u002Faz-devops.ps1 boards work-item update --id 12345 --state \"Active\"\n```\n\nLink work items to a PR with `create-pr.ps1 -WorkItems 12345,12346`.\n\n## Phase 10 closeout flow\n\n```mermaid\nflowchart LR\n  A[Phase 9 approved] --> B[ensure-azure-devops.ps1]\n  B --> C[git push branch]\n  C --> D[create-pr.ps1 -Approved]\n  D --> E[pr-list recipe -SaveOnly]\n  E --> F[Record PR URL in checkpoint + epic summary]\n```\n\n1. Human approves Phase 9 closeout.\n2. Run `ensure-azure-devops.ps1` — must PASS.\n3. `create-pr.ps1 -Push -Approved` — pushes branch and opens PR.\n4. Record returned URL in session artifacts and epic summary.\n\n## Outputs\n\n| File | Purpose |\n|------|---------|\n| `_code_agent\u002F{session}\u002Fartifacts\u002Fado\u002F*.json` | Shaped query JSON (source of truth) |\n| `_code_agent\u002F{session}\u002Fartifacts\u002Fado\u002F*.toon` | Token-efficient LLM view |\n| `_code_agent\u002Fpr-result.json` | Machine-readable PR result (optional `-OutputJson`) |\n| PR URL (stdout) | Paste into closeout summary |\n\n### `pr-result.json` shape\n\n```json\n{\n  \"schemaVersion\": \"1\",\n  \"provider\": \"azure-devops\",\n  \"pullRequestId\": 42,\n  \"url\": \"https:\u002F\u002Fdev.azure.com\u002Forg\u002Fproject\u002F_git\u002Frepo\u002Fpullrequest\u002F42\",\n  \"sourceBranch\": \"feature\u002FREQ-0006-slug\",\n  \"targetBranch\": \"main\"\n}\n```\n\n## MCP vs CLI vs TOON\n\n| Situation | Use |\n|-----------|-----|\n| Interactive exploration in Cursor | Azure DevOps **MCP** |\n| Scripted read queries + token savings | **`az-devops-query.ps1`** + TOON files |\n| PR creation, pipeline run (mutating) | **`az-devops.ps1`** \u002F `create-pr.ps1` |\n| Manifest-driven org\u002Fproject defaults | This skill (all scripts) |\n| Environments without MCP | CLI + TOON query layer |\n\nMCP responses are already structured; the TOON layer targets **CLI JSON** specifically.\n\n## Constraints\n\n- Never commit PATs or print `AZURE_DEVOPS_EXT_PAT` \u002F Keychain values.\n- Never create or push PRs before Phase 9 approval.\n- Cite artifact **paths** and PR URLs in chat — not full `az` JSON or TOON dumps.\n- English for PR titles and descriptions.\n\n## Resources\n\n- Extension docs: https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fdevops\u002Fcli\n- Recipe catalog: `catalog\u002FREADME.md`\n- macOS login helper: `templates\u002Fazdo-login-macos.zsh`\n- Pipeline spec Phase 10: package `docs\u002Freference\u002Fpipeline-spec.md`\n- Test results for ADO pipelines: `dotnet-unit-tests` skill → `TestResults\u002Fazure-devops-results.json`\n","# azure-devops-cli\n\nDeterministic **Azure DevOps** integration using the official **Azure CLI** with the\n`azure-devops` extension (`az repos`, `az pipelines`, `az boards`, `az devops`). Reads\n`pipeline.manifest.json` `pr.*` for organization, project, repository, and target branch.\n\n**Not** Azure Resource Manager (`az group`, `az vm`) — only Azure DevOps services.\n\n## Prerequisites\n\n| Tool | Install |\n|------|---------|\n| Azure CLI | https:\u002F\u002Flearn.microsoft.com\u002Fcli\u002Fazure\u002Finstall-azure-cli |\n| `azure-devops` extension | `az extension add --name azure-devops` (or use script below) |\n\n### Authentication\n\nAzure DevOps CLI uses a **Personal Access Token (PAT)** — not the same session as `az login`\nfor Azure Resource Manager. Create a PAT in Azure DevOps:\n\n**User settings → Personal access tokens → New token**\n\n| Scope (minimum) | Used for |\n|-----------------|----------|\n| **Code** (Read & write) | `az repos` — PRs, branches |\n| **Work Items** (Read & write) | `az boards` — work items |\n| **Build** (Read) | `az pipelines` — list runs, status |\n\nSet expiration as your org policy allows. Never commit the PAT.\n\n#### Option A — environment variable (CI \u002F scripts)\n\n```bash\nexport AZURE_DEVOPS_EXT_PAT=\"your-pat-here\"\n```\n\n`ensure-azure-devops.ps1` and all skill scripts pick this up automatically.\n\n#### Option B — macOS Keychain (recommended for local dev)\n\nStore the PAT once in Keychain, then load it into the env var before `az devops login`:\n\n```bash\n# One-time: save PAT to Keychain (replace with your token)\nsecurity add-generic-password -a \"$USER\" -s AZDO_PAT -w \"your-pat-here\" -U\n\n# Update existing entry\nsecurity add-generic-password -a \"$USER\" -s AZDO_PAT -w \"new-pat\" -U\n```\n\nAdd to `~\u002F.zshrc` (set `AZDO_ORG` to match `pipeline.manifest.json` `pr.org`):\n\n```bash\nazdo-login() {\n  export AZURE_DEVOPS_EXT_PAT=\"$(security find-generic-password -s AZDO_PAT -w)\"\n  az devops login --organization \"https:\u002F\u002Fdev.azure.com\u002F${AZDO_ORG:-petrovskyitools}\"\n}\n```\n\nUsage:\n\n```bash\nexport AZDO_ORG=petrovskyitools   # or your org slug\nazdo-login\npwsh .cursor\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fensure-azure-devops.ps1\n```\n\n`az devops login` reads `AZURE_DEVOPS_EXT_PAT` from the environment — the function sets both.\n\n#### Option C — interactive pipe (quick test)\n\n```bash\necho \"$AZURE_DEVOPS_EXT_PAT\" | az devops login --organization https:\u002F\u002Fdev.azure.com\u002Fmy-org\n```\n\n#### Verify auth\n\n```powershell\npwsh .cursor\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fensure-azure-devops.ps1 -Json\npwsh .cursor\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fconfigure-azure-devops.ps1\n```\n\n| Context | Method |\n|---------|--------|\n| macOS local | Keychain + `azdo-login` → `AZURE_DEVOPS_EXT_PAT` |\n| Linux \u002F WSL | `export AZURE_DEVOPS_EXT_PAT=...` or secret manager |\n| CI \u002F agent | Pipeline secret → `AZURE_DEVOPS_EXT_PAT` env var |\n| Azure RM resources | Separate: `az login` (not used for DevOps CLI in this skill) |\n\n## Manifest configuration\n\nSet in `pipeline.manifest.json`:\n\n```json\n\"pr\": {\n  \"type\": \"azure-devops\",\n  \"org\": \"my-org\",\n  \"project\": \"MyProject\",\n  \"repo\": \"MyRepo\",\n  \"target_branch\": \"main\",\n  \"branch_prefix\": { \"feature\": \"feature\u002F\", \"fix\": \"fix\u002F\", \"chore\": \"chore\u002F\" }\n}\n```\n\n- `org` — organization name or full URL (`https:\u002F\u002Fdev.azure.com\u002Fmy-org`)\n- `project` — Azure DevOps project name\n- `repo` — Git repository name (for `az repos pr create`)\n\n## Commands\n\n```powershell\n$ADO = '.cursor\u002Fskills\u002Fazure-devops-cli\u002Fscripts'\n\n# 1. Verify CLI + extension + auth (+ optional install extension)\npwsh $ADO\u002Fensure-azure-devops.ps1 -InstallExtension\n\n# 2. Apply manifest defaults to az devops configure\npwsh $ADO\u002Fconfigure-azure-devops.ps1\n\n# 3. Mutating passthrough — org\u002Fproject injected automatically\npwsh $ADO\u002Faz-devops.ps1 pipelines run --name \"CI\" --branch main\npwsh $ADO\u002Faz-devops.ps1 boards work-item create --title \"Implement REQ-0006\" --type Task\n\n# 4. Read queries — JSON source + TOON projection (token-efficient)\n$Q = \"$ADO\u002Faz-devops-query.ps1\"\npwsh $Q -ListRecipes\npwsh $Q -Recipe pr-list -Session 20260610-my-feature -Stats\npwsh $Q -Recipe pr-show -Vars @{ id = 42 } -SaveOnly\npwsh $Q -Recipe pipeline-runs -Vars @{ pipelineId = 12; top = 5 }\npwsh $Q repos pipelines list --top 3   # freeform passthrough\n\n# 5. Phase 10 — create PR (ONLY after Phase 9 human approval)\npwsh $ADO\u002Fcreate-pr.ps1 `\n  -SourceBranch feature\u002FREQ-0006-my-feature `\n  -Title \"feat(REQ-0006): My feature\" `\n  -DescriptionFile docs\u002Fsdlc\u002Fcloseout\u002FREQ-0006-summary.md `\n  -Push -Approved `\n  -OutputJson _code_agent\u002Fpr-result.json\n```\n\n## Pipeline placement\n\n| Phase | Agent | Azure DevOps responsibility |\n|-------|-------|----------------------------|\n| **6** | `team-lead` (+ `devops`) | Link plan tasks to ADO work items when tracker maps to boards |\n| **7** | `devops` | Pipeline YAML changes; trigger validation builds via `az pipelines` |\n| **10** | `coordinator` | **PR creation** via `create-pr.ps1` after human approval |\n\n**Coordinator rule:** never pass `-Approved` or `-Push` until Phase 9 gate passes.\n\n## TOON query workflow (token-efficient reads)\n\nRead-only Azure DevOps data uses **JSON source + TOON projection** (same pattern as\n`checkpoint` skill):\n\n```mermaid\nflowchart LR\n  Recipe[az-devops-query.ps1] --> Az[\"az --query JMESPath -o json\"]\n  Az --> JsonFile[\"artifacts\u002Fado\u002F*.json\"]\n  JsonFile --> ToonFile[\"artifacts\u002Fado\u002F*.toon\"]\n  ToonFile --> Agent[Agent reads path or truncated stdout]\n```\n\n| Step | What |\n|------|------|\n| 1 | `az --query` drops unused fields (JMESPath) |\n| 2 | Shaped JSON saved as source of truth |\n| 3 | `agentic-tool toon encode` (or Python fallback) writes `.toon` |\n| 4 | Agent cites **paths** in chat — not full TOON bodies |\n\n### Query flags\n\n| Flag | Behavior |\n|------|----------|\n| `-Recipe {id}` | Named query from `catalog\u002Frecipes.json` |\n| `-Vars @{ ... }` | Template variables for recipe |\n| `-Session {code}` | Write under `_code_agent\u002F{session}\u002Fartifacts\u002Fado\u002F` |\n| `-SaveOnly` | Index line only (path + bytes) |\n| `-PrintToon` (default) | Also print TOON to stdout |\n| `-MaxChars N` | Truncate stdout; full content in file |\n| `-Stats` | Print JSON vs TOON token estimate |\n| `-ListRecipes` | TOON table of available recipes |\n\n### Recipe catalog\n\nSee [`catalog\u002FREADME.md`](catalog\u002FREADME.md). Recipes: `pr-list`, `pr-show`, `pipeline-list`,\n`pipeline-runs`, `pipeline-run-show`, `work-item-show`, `work-item-query`, `repo-list`.\n\n### TOON encoders (priority order)\n\n1. **`agentic-tool toon encode --stdin`** — Cysharp ToonEncoder (same as checkpoints)\n2. **`json-to-toon.py`** — Python fallback: `pip install 'toon-format==0.9.0b1'`\n\nStandalone encode:\n\n```powershell\nagentic-tool toon encode --file data.json --stats\necho '{\"items\":[1,2,3]}' | agentic-tool toon encode --stdin\npython3 .cursor\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fjson-to-toon.py --stdin --stats\n```\n\n### Token savings (measured)\n\nRun `pwsh scripts\u002Fbench-toon.ps1` to reproduce. Samples in `catalog\u002Fsamples\u002F`.\n\n| Shape | JSON tokens | TOON tokens | Saved |\n|-------|-------------|-------------|-------|\n| PR list (10 rows, shaped via `--query`) | 530 | 369 | **30%** |\n| PR list (10 rows, raw nested `az` output) | 1036 | 1114 | **-7%** (worse) |\n| Pipeline runs (2 rows, shaped) | 93 | 74 | **20%** |\n\n**Key insight:** JMESPath shaping before TOON is required. Raw nested JSON can cost *more* tokens as TOON.\nAlways use `-Recipe` or `--query` projection.\n\n## Common operations\n\n### Repos (pull requests, branches)\n\n```powershell\npwsh $Q -Recipe pr-list -Session $SESSION -SaveOnly\npwsh $Q -Recipe pr-show -Vars @{ id = 42 }\npwsh $ADO\u002Faz-devops.ps1 repos ref list --filter heads\u002F\n```\n\n### Pipelines (CI\u002FCD)\n\n```powershell\npwsh $Q -Recipe pipeline-list\npwsh $Q -Recipe pipeline-runs -Vars @{ pipelineId = 12; top = 5 }\npwsh $ADO\u002Faz-devops.ps1 pipelines run --id 12 --branch feature\u002FREQ-0006-slug\n```\n\n### Boards (work items)\n\n```powershell\npwsh $Q -Recipe work-item-show -Vars @{ id = 12345 }\npwsh $ADO\u002Faz-devops.ps1 boards work-item create --title \"Implement REQ-0006\" --type Task\npwsh $ADO\u002Faz-devops.ps1 boards work-item update --id 12345 --state \"Active\"\n```\n\nLink work items to a PR with `create-pr.ps1 -WorkItems 12345,12346`.\n\n## Phase 10 closeout flow\n\n```mermaid\nflowchart LR\n  A[Phase 9 approved] --> B[ensure-azure-devops.ps1]\n  B --> C[git push branch]\n  C --> D[create-pr.ps1 -Approved]\n  D --> E[pr-list recipe -SaveOnly]\n  E --> F[Record PR URL in checkpoint + epic summary]\n```\n\n1. Human approves Phase 9 closeout.\n2. Run `ensure-azure-devops.ps1` — must PASS.\n3. `create-pr.ps1 -Push -Approved` — pushes branch and opens PR.\n4. Record returned URL in session artifacts and epic summary.\n\n## Outputs\n\n| File | Purpose |\n|------|---------|\n| `_code_agent\u002F{session}\u002Fartifacts\u002Fado\u002F*.json` | Shaped query JSON (source of truth) |\n| `_code_agent\u002F{session}\u002Fartifacts\u002Fado\u002F*.toon` | Token-efficient LLM view |\n| `_code_agent\u002Fpr-result.json` | Machine-readable PR result (optional `-OutputJson`) |\n| PR URL (stdout) | Paste into closeout summary |\n\n### `pr-result.json` shape\n\n```json\n{\n  \"schemaVersion\": \"1\",\n  \"provider\": \"azure-devops\",\n  \"pullRequestId\": 42,\n  \"url\": \"https:\u002F\u002Fdev.azure.com\u002Forg\u002Fproject\u002F_git\u002Frepo\u002Fpullrequest\u002F42\",\n  \"sourceBranch\": \"feature\u002FREQ-0006-slug\",\n  \"targetBranch\": \"main\"\n}\n```\n\n## MCP vs CLI vs TOON\n\n| Situation | Use |\n|-----------|-----|\n| Interactive exploration in Cursor | Azure DevOps **MCP** |\n| Scripted read queries + token savings | **`az-devops-query.ps1`** + TOON files |\n| PR creation, pipeline run (mutating) | **`az-devops.ps1`** \u002F `create-pr.ps1` |\n| Manifest-driven org\u002Fproject defaults | This skill (all scripts) |\n| Environments without MCP | CLI + TOON query layer |\n\nMCP responses are already structured; the TOON layer targets **CLI JSON** specifically.\n\n## Constraints\n\n- Never commit PATs or print `AZURE_DEVOPS_EXT_PAT` \u002F Keychain values.\n- Never create or push PRs before Phase 9 approval.\n- Cite artifact **paths** and PR URLs in chat — not full `az` JSON or TOON dumps.\n- English for PR titles and descriptions.\n\n## Resources\n\n- Extension docs: https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fdevops\u002Fcli\n- Recipe catalog: `catalog\u002FREADME.md`\n- macOS login helper: `templates\u002Fazdo-login-macos.zsh`\n- Pipeline spec Phase 10: package `docs\u002Freference\u002Fpipeline-spec.md`\n- Test results for ADO pipelines: `dotnet-unit-tests` skill → `TestResults\u002Fazure-devops-results.json`\n",{"name":5,"description":7,"disable-model-invocation":24},true,"main","e2524bdd7bab86898b0f1d624b8152b4590a129b",".agents\u002Fskills\u002Fazure-devops-cli","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill","https:\u002F\u002Fwww.nuget.org\u002Fpackages\u002Fapi2skill","https:\u002F\u002Fgithub.com\u002Fangpysha",".NET Senior Software Engineer","2026-10-31 03:45:31",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":24},[35,38,41],{"tool":36,"command":37},"npx","npx skills add angpysha\u002Fapi2skill --skill azure-devops-cli",{"tool":39,"command":40},"bunx","bunx skills add angpysha\u002Fapi2skill --skill azure-devops-cli",{"tool":42,"command":43},"pnpm","pnpm dlx skills add angpysha\u002Fapi2skill --skill azure-devops-cli","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002FSKILL.md",[46,52,56,60,64,70,74,78,82,86,90,94,98,104],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"catalog\u002FREADME.md","REFERENCE","参考文档",2022,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fcatalog\u002FREADME.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"catalog\u002Frecipes.json",3217,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fcatalog\u002Frecipes.json",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"catalog\u002Fsamples\u002Fpr-list-raw.json",4142,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fcatalog\u002Fsamples\u002Fpr-list-raw.json",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"catalog\u002Fsamples\u002Fpr-list-shaped.json",2119,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fcatalog\u002Fsamples\u002Fpr-list-shaped.json",{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"scripts\u002Faz-devops-query.ps1","SCRIPT","脚本",6714,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Faz-devops-query.ps1",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"scripts\u002Faz-devops.ps1",999,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Faz-devops.ps1",{"path":75,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":76,"sourceHtmlUrl":77},"scripts\u002Fazure-devops-common.ps1",9684,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fazure-devops-common.ps1",{"path":79,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":80,"sourceHtmlUrl":81},"scripts\u002Fbench-toon.ps1",1538,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fbench-toon.ps1",{"path":83,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":84,"sourceHtmlUrl":85},"scripts\u002Fconfigure-azure-devops.ps1",1130,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fconfigure-azure-devops.ps1",{"path":87,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":88,"sourceHtmlUrl":89},"scripts\u002Fcreate-pr.ps1",3359,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fcreate-pr.ps1",{"path":91,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":92,"sourceHtmlUrl":93},"scripts\u002Fensure-azure-devops.ps1",3321,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fensure-azure-devops.ps1",{"path":95,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":96,"sourceHtmlUrl":97},"scripts\u002Fjson-to-toon.py",1581,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Fscripts\u002Fjson-to-toon.py",{"path":99,"resourceType":100,"resourceTypeDesc":101,"sizeBytes":102,"sourceHtmlUrl":103},"templates\u002Fazdo-login-macos.zsh","OTHER","其他",595,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Ftemplates\u002Fazdo-login-macos.zsh",{"path":105,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":106,"sourceHtmlUrl":107},"templates\u002Fpr-description.md",723,"https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fazure-devops-cli\u002Ftemplates\u002Fpr-description.md",[109,116,121,126,133,140],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":19},"01M78F622M7F4WW0H07FTQBFM1","petstore","Call the Swagger Petstore API. A sample API that uses a petstore as an example to demonstrate api2skill.","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002Ftests\u002FApi2Skill.Tests\u002Ffixtures\u002F__approved__\u002Fpetstore-fsx\u002FSKILL.md",[],[],{"skillNo":117,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":19},"01M78F5YMTHX818MXVCNZRSAGD","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002Ftests\u002FApi2Skill.Tests\u002Ffixtures\u002F__approved__\u002Fpetstore-csx\u002FSKILL.md",[],[],{"skillNo":122,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":123,"categories":124,"keywords":125,"publishedAt":19},"01M78F5VTFF0CCN3VNVVWJ5N33","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002Ftests\u002FApi2Skill.Tests\u002Ffixtures\u002F__approved__\u002Fpetstore-cs\u002FSKILL.md",[],[],{"skillNo":127,"name":128,"nameZh":6,"description":129,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":130,"categories":131,"keywords":132,"publishedAt":19},"01M78F5PFP98A6RCB6TBB9RYTV","api2skill-creator","Interview the user about an OpenAPI\u002FSwagger API (including multi-spec, base URL, and authorization), assemble exact api2skill CLI commands, guide secrets.json setup, and migrate existing generated skills after api2skill upgrades (update \u002F regenerate \u002F merge). Prefer Plan mode for multi-spec interviews and migrations.","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002Fsrc\u002FApi2Skill\u002Ftemplates\u002Fapi2skill-creator\u002FSKILL.md",[],[],{"skillNo":134,"name":135,"nameZh":6,"description":136,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":137,"categories":138,"keywords":139,"publishedAt":19},"01M78F5J49PSFJFDC003BHGYQM","speckit-taskstoissues","Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design artifacts.","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fspeckit-taskstoissues\u002FSKILL.md",[],[],{"skillNo":141,"name":142,"nameZh":6,"description":143,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":144,"categories":145,"keywords":146,"publishedAt":19},"01M78F5EH1C32843TGS23BGCSB","speckit-tasks","Generate an actionable, dependency-ordered tasks.md for the feature based on available design artifacts.","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fspeckit-tasks\u002FSKILL.md",[],[]]