docs: add Caldova AI Tour edition of the Copilot CLI workshop - #157
Open
GeekTrainer wants to merge 2 commits into
Open
docs: add Caldova AI Tour edition of the Copilot CLI workshop#157GeekTrainer wants to merge 2 commits into
GeekTrainer wants to merge 2 commits into
Conversation
Fold the "return to / launch Copilot CLI" steps into each lesson's first exercise instead of a standalone callout, move all mid-file link-reference definitions into a single trailing cluster per file, and drop the unused agent-skill screenshot. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 7fd1673d-806b-4db8-bffd-9841a406d247
Add the Caldova-themed cli-caldova harness (built from the geektrainer/ caldova-careers template), wire it into the Starlight sidebar, refresh the create-from-template screenshot, and extend the cSpell dictionary. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 7fd1673d-806b-4db8-bffd-9841a406d247
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new Caldova-themed Copilot CLI workshop harness under docs/cli-caldova/ and updates the existing docs/cli/ harness to use a more consistent lesson structure (inlining “return to/start Copilot CLI” steps and consolidating link references), with the new harness wired into the Starlight sidebar.
Changes:
- Introduces a full 0–8 Caldova CLI lesson set plus overview (
docs/cli-caldova/). - Refactors several existing CLI lessons to remove the standalone “start Copilot CLI session” callout and standardize link-reference placement.
- Updates the Starlight sidebar (
website/astro.config.mjs) and extends cSpell words (.vscode/settings.json).
Show a summary per file
| File | Description |
|---|---|
| website/astro.config.mjs | Adds the new Caldova CLI section to the Starlight sidebar. |
| docs/cli/README.md | Moves link references to the bottom for consistency. |
| docs/cli/0-prerequisites.md | Moves link references to the bottom for consistency. |
| docs/cli/2-custom-instructions.md | Reworks “start session” guidance into numbered steps and consolidates references at the end. |
| docs/cli/3-generating-code.md | Replaces the session-start callout with inline steps for returning to Copilot CLI. |
| docs/cli/4-mcp.md | Replaces the session-start callout with inline steps and consolidates references at the end. |
| docs/cli/5-agent-skills.md | Adds a “Creating agent skills” section and replaces the session-start callout with inline steps. |
| docs/cli/6-custom-agents.md | Replaces the session-start callout with inline steps and consolidates references at the end. |
| docs/cli/7-slash-commands.md | Replaces the session-start callout with inline steps and updates step numbering. |
| docs/cli-caldova/README.md | New Caldova CLI harness overview/landing page. |
| docs/cli-caldova/0-prerequisites.md | New Caldova Exercise 0 (create-from-template + codespace setup). |
| docs/cli-caldova/1-install-copilot-cli.md | New Caldova Exercise 1 (install/auth Copilot CLI). |
| docs/cli-caldova/2-custom-instructions.md | New Caldova Exercise 2 (instructions workflow and branching). |
| docs/cli-caldova/3-generating-code.md | New Caldova Exercise 3 (plan mode + generating the filtering feature). |
| docs/cli-caldova/4-mcp.md | New Caldova Exercise 4 (add Playwright MCP + test feature). |
| docs/cli-caldova/5-agent-skills.md | New Caldova Exercise 5 (agent skills and PR workflow skill). |
| docs/cli-caldova/6-custom-agents.md | New Caldova Exercise 6 (custom agents + accessibility scenario). |
| docs/cli-caldova/7-slash-commands.md | New Caldova Exercise 7 (slash commands, sharing, model selection, delegation). |
| docs/cli-caldova/8-review.md | New Caldova Exercise 8 (wrap-up and resources). |
| .vscode/settings.json | Adds Caldova-related terms to the cSpell dictionary. |
Review details
- Files reviewed: 20/22 changed files
- Comments generated: 4
- Review effort level: Low
|
|
||
| To create a copy of the repository for the code you'll create, you'll make an instance from the [template][template-repository]. The new instance will contain all of the necessary files for the lab, and you'll use it as you work through the exercises. | ||
|
|
||
| 1. In a new browser window, navigate to the GitHub repository for this lab: `https://github.com/geektrainer/caldova-careers`. |
| lastUpdated: 2026-06-30 | ||
| --- | ||
|
|
||
| You just generated the filtering feature with Copilot CLI. Before you open a pull request, you should confirm it works in the browser. Rather than click through the app yourself, you'll connect the **Playwright MCP server** and let Copilot drive a real browser to test the feature for you. |
| [allow-all-warning]: https://docs.github.com/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools | ||
| 1. In the prompt window for Copilot CLI, send the following command: | ||
| 1. Return to your codespace. If you closed it, navigate to your repository on GitHub.com, select **Code** > **Codespaces**, then reopen your existing codespace. | ||
| 2. Return to your open Copilot CLI session. If the terminal is closed or you exited Copilot CLI, open a terminal by selecting <kbd>Ctrl</kbd>+<kbd>\`</kbd>, then start it from the repository root by running `copilot --yolo --enable-all-github-mcp-tools`. Trust the project folder if prompted, then run `/models` and select **Auto**. |
| Let's create a GitHub gist we could share with our team. | ||
|
|
||
| 1. Return to your codespace. If you closed it, navigate to your repository on GitHub.com, select **Code** > **Codespaces**, then reopen your existing codespace. | ||
| 2. Return to your open Copilot CLI session. If the terminal is closed or you exited Copilot CLI, open a terminal by selecting <kbd>Ctrl</kbd>+<kbd>\`</kbd>, then start it from the repository root by running `copilot --yolo --enable-all-github-mcp-tools`. Trust the project folder if prompted, then run `/models` and select **Auto**. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a Caldova-themed AI Tour edition of the Copilot CLI workshop (
docs/cli-caldova/), built against thegeektrainer/caldova-careerstemplate, and refines the existingdocs/cli/harness for consistency. Content only — the Caldova app itself lives in its own repository and is not included here.Type of change
website/Astro + Starlight wrapper).github/copilot-instructions.md, instructions, agents, skills)What's in this PR
New Caldova harness (
docs/cli-caldova/)website/astro.config.mjs..vscode/settings.json).Original harness refinements (
docs/cli/)Screenshot
ex0-repository-settings.pngto show the create-from-template flow forcaldova-careers.Verification
cd website && rm -rf dist && npm run buildsucceeds (278 pages built; 277index.htmlexcluding 404)Screenshots
Updated create-from-template screenshot:
docs/_images/ex0-repository-settings.png.Notes for reviewers
geektrainer/caldova-careerstemplate repo. This PR is workshop content only.ex0-repository-settings.pngshows GitHub's newer multi-step create UI (including an org-specific "Required properties" section from the demo org); the crop ends just below the Description field.