kienbui1995/magic-powers/ado-api-cli
Claude Code and agent skill by kienbui1995/magic-powers
Trust tier 2
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
Use when automating Azure DevOps operations — az devops CLI, REST API calls, PAT management, service principal automation, webhooks, and scripting repeatable ADO administrative tasks.
Install
npx vskill@latest install kienbui1995/magic-powers/ado-api-cliSKILL.md
The same SKILL.md was published earlier as kienbui1995/magic-powers/ado-api-cli.
ADO REST API & CLI Automation
When to Use
- Automating project provisioning (new team → create project, teams, areas, iterations)
- Bulk operations (add users, update permissions, create work items from CSV)
- Integrating ADO with external systems via webhooks or REST API
- Building governance scripts (audit policy compliance, report on inactive users)
- CI/CD automation scripts that interact with ADO APIs
Core Jobs
1. az devops CLI Setup
2. PAT Management
Create PAT (via UI): User Settings → Personal Access Tokens → New Token
PAT scope best practices:
| Scope | Use case | |
|---|---|---|
| Code (Read) | Clone repos in CI | |
| Build (Read & Execute) | Trigger pipelines | |
| Work Items (Read & Write) | Update work items from scripts | |
| Full Access | Admin scripts — minimize lifetime (7 days) |
PAT security:
- Never commit PATs to repos — use secrets manager
- Set expiry date (max 1 year, prefer 90 days)
- Use service principal instead of PAT for long-running automation
3. REST API Usage
4. Webhooks & Service Hooks
Common service hook events:
git.push— code pushed to branchgit.pullrequest.created— PR openedbuild.complete— pipeline finishedworkitem.created/workitem.updated— work item changes
5. Python SDK Automation
Install: pip install azure-devops
Key Concepts
- PAT (Personal Access Token) — short-lived credentials for API access; tied to user
- Service principal — AAD app identity for automated, user-independent access
- REST API version — always specify
api-version(e.g.,7.1); avoidapi-version=previewin production - WIQL — Work Item Query Language; use in
wit_client.query_by_wiql() - Service hook — outbound webhook from ADO to external systems on events
Checklist
- [ ] Using service principal (not PAT) for production automation?
- [ ] PATs have minimum required scopes?
- [ ] PAT expiry dates set (90 days recommended)?
- [ ] API calls specify explicit api-version?
- [ ] Secrets stored in Azure Key Vault (not hardcoded)?
- [ ] Webhook payloads validated with shared secret?
Key Outputs
- Automation scripts for common provisioning tasks
- Service hooks configured for integration with external systems
- PAT rotation schedule documented
- Python/bash scripts for bulk ADO operations
Output Format
- 🔴 Critical — PATs committed to repos, Full Access PAT used for automation, no expiry on PATs
- 🟡 Warning — using PAT instead of service principal for long-running automation, no api-version specified in REST calls
- 🟢 Suggestion — use azure-devops Python SDK instead of raw REST calls, store scripts in
.azuredevops/folder in repo
Anti-Patterns
- Using personal Full Access PAT in CI/CD scripts (breaks on user offboarding)
- Hardcoding PATs in scripts (security incident waiting to happen)
- Polling ADO API in a loop (use webhooks/service hooks instead)
- Not specifying api-version (breaking changes when Microsoft updates API)
Integration
ado-organization— automate project/team provisioningado-pipelines-ops— automate service connection and variable group creationado-security-policies— automate security group membership and policy configuration
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/ado-api-cli/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/kienbui1995/magic-powers/ado-api-cli)