Skip to content

Commit 2a35f32

Browse files
committed
docs(skills): update ado-cli skill with v0.2.x commands
Skill was missing several commands added in v0.2.x: Command Groups table: + version — Print the CLI version (--version flag also works) + schema — Dump the full command tree as JSON for LLM discovery + completion — Shell completion: bash, zsh, fish, powershell + ci — CI pipeline watching: ci watch (live status + streaming logs) ~ prs — Added 'diff' subcommand ~ prs comments — Expanded from 'comments' to 'add (new/reply), list (with --all), update (content/status)' ~ skills — From 'list, read' to 'list, describe, read, search, install' Frontmatter commands: list: + ado --version, ado version, ado schema, ado completion bash + ado prs diff, ado prs comments add/update + ado skills install Quick Examples section: + PR diff (3 modes: file list, per-file, unified) + PR comments (add, list --all, update) + Shell completion, version, schema --json
1 parent 0be521c commit 2a35f32

1 file changed

Lines changed: 36 additions & 2 deletions

File tree

priv/skills/ado-cli/SKILL.md

Lines changed: 36 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@ name: ado-cli
33
description: Main ado skill — setup, authentication, and complete command reference for all 24 service areas
44
version: "0.4.0"
55
commands:
6+
- ado --version
7+
- ado version
8+
- ado schema
9+
- ado completion bash
610
- ado login --org ORG
711
- ado login --method pat --org ORG --pat TOKEN
812
- ado logout
@@ -37,6 +41,9 @@ commands:
3741
- ado prs complete PROJECT REPO ID --merge-strategy squash
3842
- ado prs approve PROJECT REPO ID
3943
- ado prs comments list PROJECT REPO PR_ID
44+
- ado prs comments add PROJECT REPO PR_ID --content TEXT
45+
- ado prs comments update PROJECT REPO PR_ID THREAD COMMENT --content TEXT
46+
- ado prs diff PROJECT REPO PR_ID
4047
- ado releases list PROJECT
4148
- ado releases show PROJECT ID
4249
- ado iterations list PROJECT
@@ -60,6 +67,7 @@ commands:
6067
- ado skills describe NAME # skill frontmatter + command index
6168
- ado skills read NAME # full skill content
6269
- ado skills search "QUERY" # find skill by topic
70+
- ado skills install # embed all skills to LLM agents
6371
---
6472

6573
# ado
@@ -98,6 +106,9 @@ The CLI auto-detects the org from the token if `--org` is omitted.
98106
| Group | Subcommands |
99107
|-------|-------------|
100108
| `login`, `logout`, `whoami` | Authentication & status |
109+
| `version` | Print the CLI version (`--version` flag also works) |
110+
| `schema` | Dump the full command tree as JSON for LLM discovery |
111+
| `completion` | Shell completion: bash, zsh, fish, powershell |
101112
| `projects` | list, show, create, update, delete |
102113
| `repos` | list, show, create, delete |
103114
| `branch-policies` | list, show, create, update, delete |
@@ -108,7 +119,9 @@ The CLI auto-detects the org from the token if `--org` is omitted.
108119
| `pipelines-builds` | Classic builds: list, show, queue, cancel, tags, definitions |
109120
| `pipelines-folders` | Folders: list, create, delete |
110121
| `pipelines-artifacts` | Run artifacts: list, download |
111-
| `prs` | list, show, create, complete, abandon, approve, vote, comments |
122+
| `ci` | CI pipeline watching: `ci watch` (live status + streaming logs) |
123+
| `prs` | list, show, create, complete, abandon, approve, vote, diff, comments |
124+
| `prs comments` | Threads: add (new/reply), list (with --all), update (content/status) |
112125
| `releases` | list, show, create, update |
113126
| `iterations` | Sprints: list, show, create, update, delete |
114127
| `areas` | Area paths: list, show, create, update, delete |
@@ -122,7 +135,7 @@ The CLI auto-detects the org from the token if `--org` is omitted.
122135
| `security permissions` | ACLs: list, namespaces |
123136
| `banners` | Org-wide notifications: show, set, delete |
124137
| `packages` | Universal Packages: list, versions, show |
125-
| `skills` | list, read |
138+
| `skills` | list, describe, read, search, install (embed for LLM agents) |
126139

127140
## Conventions
128141

@@ -160,6 +173,16 @@ ado workitems create MyProject --type Bug --title "Fix login page"
160173
# Create a PR
161174
ado prs create MyProject MyRepo --title "Add feature" --source dev --target main
162175

176+
# View PR changes (3 modes: file list, per-file, unified diff)
177+
ado prs diff MyProject MyRepo 42
178+
ado prs diff MyProject MyRepo 42 --file src/app.ex
179+
ado prs diff MyProject MyRepo 42 --unified | delta
180+
181+
# Review PR comments
182+
ado prs comments add MyProject MyRepo 42 --content "LGTM!"
183+
ado prs comments list MyProject MyRepo 42 --all
184+
ado prs comments update MyProject MyRepo 42 7 5 --content "updated" --status fixed
185+
163186
# Trigger a pipeline with variables
164187
ado pipelines run MyProject 42 --branch main --variables "ENV=staging,DEBUG=true"
165188

@@ -176,6 +199,17 @@ ado projects list
176199

177200
# Check auth status
178201
ado whoami
202+
203+
# Print version (or use --version flag)
204+
ado version
205+
ado --version
206+
207+
# Dump the full command tree for LLM agents
208+
ado schema --json | jq '.schema.subcommands | length'
209+
210+
# Install shell completion (bash/zsh/fish/powershell)
211+
ado completion bash | eval
212+
ado completion zsh > "${fpath[1]}/_ado"
179213
```
180214

181215
## Help

0 commit comments

Comments
 (0)