Skip to content

Commit f6406bf

Browse files
committed
docs: add high-impact agents/commands and orchestration to Ch16 Section 7
- Add 'High-Impact Agents to Try First' table mapping Day 1 skills to agents - Add 'Slash Commands That Save the Most Time' with 7 curated commands - Cross-reference Appendix V and Episode 39 from the commands section - Update ep17 podcast bundle and build-bundles.js with new concepts - Regenerate ep17 script via Gemini 3.1 Pro Preview - Rebuild HTML (115/115), PODCASTS.md, feed.xml
1 parent 226ebe8 commit f6406bf

17 files changed

+1009
-1209
lines changed

PODCASTS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -277,7 +277,7 @@ Based on: [Chapter 15: Issue Templates](docs/15-issue-templates.md)
277277

278278
### Episode 17: Accessibility Agents
279279

280-
55 agents across 3 teams and 5 platforms, 54+ slash commands, custom agents, and agentic accessibility workflows.
280+
Six agents, 28 slash commands, custom agents, and agentic accessibility workflows.
281281

282282
Based on: [Chapter 16: Accessibility Agents](docs/16-accessibility-agents.md)
283283

@@ -609,7 +609,7 @@ Based on: [Appendix U: Resources and Links](docs/appendix-u-resources.md)
609609

610610
### Episode 39: Accessibility Agents - Complete Reference
611611

612-
All 55 agents, all 54+ slash commands, customization, and troubleshooting.
612+
All six agents, all 28 slash commands, customization, and troubleshooting.
613613

614614
Based on: [Appendix V: Accessibility Agents - Complete Reference](docs/appendix-v-accessibility-agents-reference.md)
615615

docs/16-accessibility-agents.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1765,6 +1765,35 @@ Four agents are specifically designed to coordinate others:
17651765

17661766
You do not need to use orchestrators to get value from individual agents. But when a task is complex enough to span multiple agents, orchestrators save you the work of manually chaining requests.
17671767

1768+
### High-Impact Agents to Try First
1769+
1770+
Rather than exploring all 55 agents at once, start with the ones that deliver immediate value based on Day 1 skills you already have:
1771+
1772+
| If You Can Already | Try This Agent | And This Command |
1773+
|--------------------|----------------|------------------|
1774+
| Read issues and write replies | `@issue-tracker` | `/triage`, `/issue-reply` |
1775+
| Review a PR diff | `@pr-review` | `/review-pr`, `/address-comments` |
1776+
| Check your contribution activity | `@analytics` | `/my-stats`, `/sprint-review` |
1777+
| Write issue templates | `@template-builder` | `/create-issue` |
1778+
| Track what changed overnight | `@daily-briefing` | `/daily-briefing` |
1779+
| Scan a page for accessibility issues | `@web-accessibility-wizard` | `/onboard-repo` |
1780+
| Check color contrast manually | `@contrast-master` | (invoke directly) |
1781+
| Test keyboard navigation | `@keyboard-navigator` | (invoke directly) |
1782+
1783+
### Slash Commands That Save the Most Time
1784+
1785+
These commands work without invoking a full agent - type them directly in Copilot Chat:
1786+
1787+
- **`/my-issues`** and **`/my-prs`** - Instant dashboard of your open work across all repos
1788+
- **`/review-pr #14`** - Full AI-generated review with inline suggestions, replacing manual line-by-line reading
1789+
- **`/triage #22`** - Label, priority, and assignment suggestions for any new issue
1790+
- **`/daily-briefing`** - Morning snapshot of repository activity, PRs needing review, and stale issues
1791+
- **`/a11y-update`** - Latest accessibility improvements with WCAG cross-references
1792+
- **`/draft-release v2.0`** - Generate release notes from merged PRs
1793+
- **`/onboard-repo`** - First-time scan of a repo with health assessment and recommended actions
1794+
1795+
The full list of 54+ commands is in [Appendix V](appendix-v-accessibility-agents-reference.md), and [Episode 39](../PODCASTS.md) walks through all of them with examples.
1796+
17681797
### Running Agents Beyond VS Code
17691798

17701799
Accessibility Agents' agents run on your machine, in your editor, when you ask for them. That is one scope.

html/PODCASTS.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -214,7 +214,7 @@ <h3>Episode 16: Issue Templates</h3>
214214
<p><a href="https://github.com/Community-Access/git-going-with-github/releases/download/podcasts/ep16-issue-templates.mp3">Download Episode 16 (MP3)</a></p>
215215
<hr>
216216
<h3>Episode 17: Accessibility Agents</h3>
217-
<p>55 agents across 3 teams and 5 platforms, 54+ slash commands, custom agents, and agentic accessibility workflows.</p>
217+
<p>Six agents, 28 slash commands, custom agents, and agentic accessibility workflows.</p>
218218
<p>Based on: <a href="docs/16-accessibility-agents.html">Chapter 16: Accessibility Agents</a></p>
219219
<audio controls preload="none">
220220
<source src="https://github.com/Community-Access/git-going-with-github/releases/download/podcasts/ep17-accessibility-agents.mp3" type="audio/mpeg">
@@ -435,7 +435,7 @@ <h3>Episode 38: Resources and Links</h3>
435435
<p><a href="https://github.com/Community-Access/git-going-with-github/releases/download/podcasts/ep38-resources.mp3">Download Episode 38 (MP3)</a></p>
436436
<hr>
437437
<h3>Episode 39: Accessibility Agents - Complete Reference</h3>
438-
<p>All 55 agents, all 54+ slash commands, customization, and troubleshooting.</p>
438+
<p>All six agents, all 28 slash commands, customization, and troubleshooting.</p>
439439
<p>Based on: <a href="docs/appendix-v-accessibility-agents-reference.html">Appendix V: Accessibility Agents - Complete Reference</a></p>
440440
<audio controls preload="none">
441441
<source src="https://github.com/Community-Access/git-going-with-github/releases/download/podcasts/ep39-accessibility-agents-reference.mp3" type="audio/mpeg">

html/docs/16-accessibility-agents.html

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1789,6 +1789,69 @@ <h3>Orchestrator Agents</h3>
17891789
</tr>
17901790
</tbody></table>
17911791
<p>You do not need to use orchestrators to get value from individual agents. But when a task is complex enough to span multiple agents, orchestrators save you the work of manually chaining requests.</p>
1792+
<h3>High-Impact Agents to Try First</h3>
1793+
<p>Rather than exploring all 55 agents at once, start with the ones that deliver immediate value based on Day 1 skills you already have:</p>
1794+
<table>
1795+
<thead>
1796+
<tr>
1797+
<th scope="col">If You Can Already</th>
1798+
<th scope="col">Try This Agent</th>
1799+
<th scope="col">And This Command</th>
1800+
</tr>
1801+
</thead>
1802+
<tbody><tr>
1803+
<td>Read issues and write replies</td>
1804+
<td><code>@issue-tracker</code></td>
1805+
<td><code>/triage</code>, <code>/issue-reply</code></td>
1806+
</tr>
1807+
<tr>
1808+
<td>Review a PR diff</td>
1809+
<td><code>@pr-review</code></td>
1810+
<td><code>/review-pr</code>, <code>/address-comments</code></td>
1811+
</tr>
1812+
<tr>
1813+
<td>Check your contribution activity</td>
1814+
<td><code>@analytics</code></td>
1815+
<td><code>/my-stats</code>, <code>/sprint-review</code></td>
1816+
</tr>
1817+
<tr>
1818+
<td>Write issue templates</td>
1819+
<td><code>@template-builder</code></td>
1820+
<td><code>/create-issue</code></td>
1821+
</tr>
1822+
<tr>
1823+
<td>Track what changed overnight</td>
1824+
<td><code>@daily-briefing</code></td>
1825+
<td><code>/daily-briefing</code></td>
1826+
</tr>
1827+
<tr>
1828+
<td>Scan a page for accessibility issues</td>
1829+
<td><code>@web-accessibility-wizard</code></td>
1830+
<td><code>/onboard-repo</code></td>
1831+
</tr>
1832+
<tr>
1833+
<td>Check color contrast manually</td>
1834+
<td><code>@contrast-master</code></td>
1835+
<td>(invoke directly)</td>
1836+
</tr>
1837+
<tr>
1838+
<td>Test keyboard navigation</td>
1839+
<td><code>@keyboard-navigator</code></td>
1840+
<td>(invoke directly)</td>
1841+
</tr>
1842+
</tbody></table>
1843+
<h3>Slash Commands That Save the Most Time</h3>
1844+
<p>These commands work without invoking a full agent - type them directly in Copilot Chat:</p>
1845+
<ul>
1846+
<li><strong><code>/my-issues</code></strong> and <strong><code>/my-prs</code></strong> - Instant dashboard of your open work across all repos</li>
1847+
<li><strong><code>/review-pr #14</code></strong> - Full AI-generated review with inline suggestions, replacing manual line-by-line reading</li>
1848+
<li><strong><code>/triage #22</code></strong> - Label, priority, and assignment suggestions for any new issue</li>
1849+
<li><strong><code>/daily-briefing</code></strong> - Morning snapshot of repository activity, PRs needing review, and stale issues</li>
1850+
<li><strong><code>/a11y-update</code></strong> - Latest accessibility improvements with WCAG cross-references</li>
1851+
<li><strong><code>/draft-release v2.0</code></strong> - Generate release notes from merged PRs</li>
1852+
<li><strong><code>/onboard-repo</code></strong> - First-time scan of a repo with health assessment and recommended actions</li>
1853+
</ul>
1854+
<p>The full list of 54+ commands is in <a href="appendix-v-accessibility-agents-reference.html">Appendix V</a>, and <a href="../PODCASTS.html">Episode 39</a> walks through all of them with examples.</p>
17921855
<h3>Running Agents Beyond VS Code</h3>
17931856
<p>Accessibility Agents&#39; agents run on your machine, in your editor, when you ask for them. That is one scope.</p>
17941857
<p>The same Markdown-authored pattern extends further:</p>

html/podcasts/bundles/ep17-accessibility-agents.html

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,9 +58,12 @@ <h3>Audio Production Direction</h3>
5858
<li>The full ecosystem: 55 agents across 3 teams and 5 platforms</li>
5959
<li>The three teams: Accessibility (26), GitHub Workflow (12), Developer Tools (6)</li>
6060
<li>Slash commands: the 54+ commands and when to use them</li>
61+
<li>High-impact agents and slash commands to try first</li>
62+
<li>Orchestrator agents and how teams work together</li>
6163
<li>Installing and configuring the agents</li>
6264
<li>Building custom agents for your own projects</li>
6365
<li>How agents amplify every skill learned in this workshop</li>
66+
<li>Cross-reference: Appendix V and Episode 39 for the complete reference</li>
6467
</ul>
6568
<hr>
6669
<h3>Concept Coverage Checklist</h3>
@@ -74,6 +77,10 @@ <h3>Concept Coverage Checklist</h3>
7477
<li><input aria-label="" disabled="" type="checkbox"> <strong>Team 2 - GitHub Workflow (12 agents): issues, PRs, analytics, templates</strong></li>
7578
<li><input aria-label="" disabled="" type="checkbox"> <strong>Team 3 - Developer Tools (6 agents): Python, desktop, custom tools</strong></li>
7679
<li><input aria-label="" disabled="" type="checkbox"> <strong>Slash commands: 54+ commands organized by workflow</strong></li>
80+
<li><input aria-label="" disabled="" type="checkbox"> <strong>High-impact starting points: which agents and commands to try first</strong></li>
81+
<li><input aria-label="" disabled="" type="checkbox"> <strong>Slash commands that save time: /my-issues, /review-pr, /triage, /daily-briefing, /a11y-update</strong></li>
82+
<li><input aria-label="" disabled="" type="checkbox"> <strong>Orchestrator agents: @nexus, @accessibility-lead, @web-accessibility-wizard</strong></li>
83+
<li><input aria-label="" disabled="" type="checkbox"> <strong>How the three teams connect in multi-agent workflows</strong></li>
7784
<li><input aria-label="" disabled="" type="checkbox"> <strong>How to invoke an agent in Copilot Chat</strong></li>
7885
<li><input aria-label="" disabled="" type="checkbox"> <strong>Installing and configuring agents from .github config files</strong></li>
7986
<li><input aria-label="" disabled="" type="checkbox"> <strong>Agent instruction files and how they customize behavior</strong></li>
@@ -82,6 +89,7 @@ <h3>Concept Coverage Checklist</h3>
8289
<li><input aria-label="" disabled="" type="checkbox"> <strong>How agents amplify skills: the manual skill first, then the agent</strong></li>
8390
<li><input aria-label="" disabled="" type="checkbox"> <strong>Real-world examples of agent-assisted contributions</strong></li>
8491
<li><input aria-label="" disabled="" type="checkbox"> <strong>Limitations: agents suggest, humans decide and verify</strong></li>
92+
<li><input aria-label="" disabled="" type="checkbox"> <strong>Go deeper: Appendix V has all 54+ commands, Episode 39 walks through every agent</strong></li>
8593
</ul>
8694
<h3>Prerequisites (briefly recap these)</h3>
8795
<p>Listeners may have heard these earlier episodes. Briefly remind them of:</p>
@@ -1857,6 +1865,69 @@ <h3>Orchestrator Agents</h3>
18571865
</tr>
18581866
</tbody></table>
18591867
<p>You do not need to use orchestrators to get value from individual agents. But when a task is complex enough to span multiple agents, orchestrators save you the work of manually chaining requests.</p>
1868+
<h3>High-Impact Agents to Try First</h3>
1869+
<p>Rather than exploring all 55 agents at once, start with the ones that deliver immediate value based on Day 1 skills you already have:</p>
1870+
<table>
1871+
<thead>
1872+
<tr>
1873+
<th scope="col">If You Can Already</th>
1874+
<th scope="col">Try This Agent</th>
1875+
<th scope="col">And This Command</th>
1876+
</tr>
1877+
</thead>
1878+
<tbody><tr>
1879+
<td>Read issues and write replies</td>
1880+
<td><code>@issue-tracker</code></td>
1881+
<td><code>/triage</code>, <code>/issue-reply</code></td>
1882+
</tr>
1883+
<tr>
1884+
<td>Review a PR diff</td>
1885+
<td><code>@pr-review</code></td>
1886+
<td><code>/review-pr</code>, <code>/address-comments</code></td>
1887+
</tr>
1888+
<tr>
1889+
<td>Check your contribution activity</td>
1890+
<td><code>@analytics</code></td>
1891+
<td><code>/my-stats</code>, <code>/sprint-review</code></td>
1892+
</tr>
1893+
<tr>
1894+
<td>Write issue templates</td>
1895+
<td><code>@template-builder</code></td>
1896+
<td><code>/create-issue</code></td>
1897+
</tr>
1898+
<tr>
1899+
<td>Track what changed overnight</td>
1900+
<td><code>@daily-briefing</code></td>
1901+
<td><code>/daily-briefing</code></td>
1902+
</tr>
1903+
<tr>
1904+
<td>Scan a page for accessibility issues</td>
1905+
<td><code>@web-accessibility-wizard</code></td>
1906+
<td><code>/onboard-repo</code></td>
1907+
</tr>
1908+
<tr>
1909+
<td>Check color contrast manually</td>
1910+
<td><code>@contrast-master</code></td>
1911+
<td>(invoke directly)</td>
1912+
</tr>
1913+
<tr>
1914+
<td>Test keyboard navigation</td>
1915+
<td><code>@keyboard-navigator</code></td>
1916+
<td>(invoke directly)</td>
1917+
</tr>
1918+
</tbody></table>
1919+
<h3>Slash Commands That Save the Most Time</h3>
1920+
<p>These commands work without invoking a full agent - type them directly in Copilot Chat:</p>
1921+
<ul>
1922+
<li><strong><code>/my-issues</code></strong> and <strong><code>/my-prs</code></strong> - Instant dashboard of your open work across all repos</li>
1923+
<li><strong><code>/review-pr #14</code></strong> - Full AI-generated review with inline suggestions, replacing manual line-by-line reading</li>
1924+
<li><strong><code>/triage #22</code></strong> - Label, priority, and assignment suggestions for any new issue</li>
1925+
<li><strong><code>/daily-briefing</code></strong> - Morning snapshot of repository activity, PRs needing review, and stale issues</li>
1926+
<li><strong><code>/a11y-update</code></strong> - Latest accessibility improvements with WCAG cross-references</li>
1927+
<li><strong><code>/draft-release v2.0</code></strong> - Generate release notes from merged PRs</li>
1928+
<li><strong><code>/onboard-repo</code></strong> - First-time scan of a repo with health assessment and recommended actions</li>
1929+
</ul>
1930+
<p>The full list of 54+ commands is in <a href="appendix-v-accessibility-agents-reference.html">Appendix V</a>, and <a href="../PODCASTS.html">Episode 39</a> walks through all of them with examples.</p>
18601931
<h3>Running Agents Beyond VS Code</h3>
18611932
<p>Accessibility Agents&#39; agents run on your machine, in your editor, when you ask for them. That is one scope.</p>
18621933
<p>The same Markdown-authored pattern extends further:</p>

podcasts/build-bundles.js

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -711,22 +711,30 @@ const episodes = [
711711
'Team 2 - GitHub Workflow (12 agents): issues, PRs, analytics, templates',
712712
'Team 3 - Developer Tools (6 agents): Python, desktop, custom tools',
713713
'Slash commands: 54+ commands organized by workflow',
714+
'High-impact starting points: which agents and commands to try first',
715+
'Slash commands that save time: /my-issues, /review-pr, /triage, /daily-briefing, /a11y-update',
716+
'Orchestrator agents: @nexus, @accessibility-lead, @web-accessibility-wizard',
717+
'How the three teams connect in multi-agent workflows',
714718
'How to invoke an agent in Copilot Chat',
715719
'Installing and configuring agents from .github config files',
716720
'Agent instruction files and how they customize behavior',
717721
'Building your own custom agent with agent.md files',
718722
'Agentic workflows: chaining multiple agents together',
719723
'How agents amplify skills: the manual skill first, then the agent',
720724
'Real-world examples of agent-assisted contributions',
721-
'Limitations: agents suggest, humans decide and verify'
725+
'Limitations: agents suggest, humans decide and verify',
726+
'Go deeper: Appendix V has all 54+ commands, Episode 39 walks through every agent'
722727
],
723728
focus: `- What accessibility agents are and how they extend Copilot
724729
- The full ecosystem: 55 agents across 3 teams and 5 platforms
725730
- The three teams: Accessibility (26), GitHub Workflow (12), Developer Tools (6)
726731
- Slash commands: the 54+ commands and when to use them
732+
- High-impact agents and slash commands to try first
733+
- Orchestrator agents and how teams work together
727734
- Installing and configuring the agents
728735
- Building custom agents for your own projects
729-
- How agents amplify every skill learned in this workshop`
736+
- How agents amplify every skill learned in this workshop
737+
- Cross-reference: Appendix V and Episode 39 for the complete reference`
730738
},
731739

732740
// ---- Appendices ----

podcasts/bundles/ep17-accessibility-agents.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,9 +33,12 @@ The audience is blind and low-vision developers attending a two-day workshop on
3333
- The full ecosystem: 55 agents across 3 teams and 5 platforms
3434
- The three teams: Accessibility (26), GitHub Workflow (12), Developer Tools (6)
3535
- Slash commands: the 54+ commands and when to use them
36+
- High-impact agents and slash commands to try first
37+
- Orchestrator agents and how teams work together
3638
- Installing and configuring the agents
3739
- Building custom agents for your own projects
3840
- How agents amplify every skill learned in this workshop
41+
- Cross-reference: Appendix V and Episode 39 for the complete reference
3942

4043
---
4144

@@ -51,6 +54,10 @@ When a concept is complex, use an analogy or real-world comparison to make it co
5154
- [ ] **Team 2 - GitHub Workflow (12 agents): issues, PRs, analytics, templates**
5255
- [ ] **Team 3 - Developer Tools (6 agents): Python, desktop, custom tools**
5356
- [ ] **Slash commands: 54+ commands organized by workflow**
57+
- [ ] **High-impact starting points: which agents and commands to try first**
58+
- [ ] **Slash commands that save time: /my-issues, /review-pr, /triage, /daily-briefing, /a11y-update**
59+
- [ ] **Orchestrator agents: @nexus, @accessibility-lead, @web-accessibility-wizard**
60+
- [ ] **How the three teams connect in multi-agent workflows**
5461
- [ ] **How to invoke an agent in Copilot Chat**
5562
- [ ] **Installing and configuring agents from .github config files**
5663
- [ ] **Agent instruction files and how they customize behavior**
@@ -59,6 +66,7 @@ When a concept is complex, use an analogy or real-world comparison to make it co
5966
- [ ] **How agents amplify skills: the manual skill first, then the agent**
6067
- [ ] **Real-world examples of agent-assisted contributions**
6168
- [ ] **Limitations: agents suggest, humans decide and verify**
69+
- [ ] **Go deeper: Appendix V has all 54+ commands, Episode 39 walks through every agent**
6270

6371
### Prerequisites (briefly recap these)
6472

@@ -1844,6 +1852,35 @@ Four agents are specifically designed to coordinate others:
18441852

18451853
You do not need to use orchestrators to get value from individual agents. But when a task is complex enough to span multiple agents, orchestrators save you the work of manually chaining requests.
18461854

1855+
### High-Impact Agents to Try First
1856+
1857+
Rather than exploring all 55 agents at once, start with the ones that deliver immediate value based on Day 1 skills you already have:
1858+
1859+
| If You Can Already | Try This Agent | And This Command |
1860+
|--------------------|----------------|------------------|
1861+
| Read issues and write replies | `@issue-tracker` | `/triage`, `/issue-reply` |
1862+
| Review a PR diff | `@pr-review` | `/review-pr`, `/address-comments` |
1863+
| Check your contribution activity | `@analytics` | `/my-stats`, `/sprint-review` |
1864+
| Write issue templates | `@template-builder` | `/create-issue` |
1865+
| Track what changed overnight | `@daily-briefing` | `/daily-briefing` |
1866+
| Scan a page for accessibility issues | `@web-accessibility-wizard` | `/onboard-repo` |
1867+
| Check color contrast manually | `@contrast-master` | (invoke directly) |
1868+
| Test keyboard navigation | `@keyboard-navigator` | (invoke directly) |
1869+
1870+
### Slash Commands That Save the Most Time
1871+
1872+
These commands work without invoking a full agent - type them directly in Copilot Chat:
1873+
1874+
- **`/my-issues`** and **`/my-prs`** - Instant dashboard of your open work across all repos
1875+
- **`/review-pr #14`** - Full AI-generated review with inline suggestions, replacing manual line-by-line reading
1876+
- **`/triage #22`** - Label, priority, and assignment suggestions for any new issue
1877+
- **`/daily-briefing`** - Morning snapshot of repository activity, PRs needing review, and stale issues
1878+
- **`/a11y-update`** - Latest accessibility improvements with WCAG cross-references
1879+
- **`/draft-release v2.0`** - Generate release notes from merged PRs
1880+
- **`/onboard-repo`** - First-time scan of a repo with health assessment and recommended actions
1881+
1882+
The full list of 54+ commands is in [Appendix V](appendix-v-accessibility-agents-reference.md), and [Episode 39](../PODCASTS.md) walks through all of them with examples.
1883+
18471884
### Running Agents Beyond VS Code
18481885

18491886
Accessibility Agents' agents run on your machine, in your editor, when you ask for them. That is one scope.

0 commit comments

Comments
 (0)