- automating-with-hooks.md: Add PermissionRequest and notification hook
events to the event reference table; document permissionDecision 'allow'
return value for preToolUse; add PermissionRequest and notification
practical examples
- creating-effective-skills.md: Document built-in CLI skills (v1.0.17)
that ship with the CLI without configuration
- using-copilot-coding-agent.md: Add Critic agent best-practice tip
(v1.0.18, experimental mode for Claude models)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Add postToolUseFailure hook event to automating-with-hooks.md:
clarify that postToolUse now only fires on success, add new event
to the events table, and add a practical example with migration note
- Add /mcp auth command and device code flow (RFC 8628) to
understanding-mcp-servers.md authentication section
- Add mcp.config.list/add/update/remove server RPCs section to
understanding-mcp-servers.md
- Add /share html command to copilot-configuration-basics.md CLI
Session Commands section
- Update lastUpdated dates to 2026-04-01
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add documentation for new features released in the past 7 days:
- /rewind command and double-Esc timeline picker (v1.0.12)
- /allow-all on/off/show subcommands (v1.0.12)
- .claude/settings.json and .claude/settings.local.json as additional
repo config sources (v1.0.12)
- preCompact hook event in the events table (v1.0.5, previously missing)
- Plugin hooks CLAUDE_PROJECT_DIR and CLAUDE_PLUGIN_DATA env variables
and {{project_dir}}/{{plugin_data_dir}} template variables (v1.0.12)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Aaron Powell <me@aaron-powell.com>
* Initial pass at bringing a website experience to copilot cli for beginners
* dropped the number from the heading
* Adding codeowner
* agentic workflow to keep the docs in sync
* Making it more aligned with the source material
* Removing the badges and TOC since we get some of that from astro
* updating the agentic workflow
* Adding learning hub to llms.txt
* Removing nav that comes from the source markdown files
- automating-with-hooks: add subagentStart event to hook events table,
add cross-platform PascalCase event name compatibility note, add
subagentStart example, expand hook config file location FAQ to include
settings.json and config.json locations
- defining-custom-instructions: document that applyTo accepts both
string and array formats (added in v1.0.6)
- installing-and-using-plugins: document --plugin-dir flag and the
External Plugins section in /plugin list (added in v1.0.10)
Source: github/copilot-cli releases v1.0.6 through v1.0.10
(March 16–20, 2026)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Fixing the action link
* Fix sidebar navigation text contrast in light mode
- Use --sl-color-text-invert instead of --sl-color-white for active
sidebar item, fixing near-black text on dark purple background
(contrast ~2.5:1 → ~7.1:1)
- Bump inactive sidebar links to font-weight 500 for better readability
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---------
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Add search functionality to Learning Hub index page
Add a client-side search bar that filters articles by title, description,
and tags. Sections with no matching results are hidden automatically.
Uses the existing .search-bar CSS pattern from the cookbook page.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* chore: remove deprecated layouts, theme script, and learning-hub config
Phase 5 cleanup of Starlight migration:
- Delete BaseLayout.astro (replaced by StarlightPage)
- Delete ArticleLayout.astro (replaced by Starlight docs rendering)
- Delete theme.ts (Starlight has built-in theme toggle)
- Delete src/config/learning-hub.ts (sidebar order now in astro.config.mjs)
- Replace learning-hub glob collection with Starlight docs collection in content.config.ts
- Keep search.ts (still used by homepage and all resource page scripts)
Build verified: 23 pages, no errors.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Migrate website to Starlight with full-text resource search
- Replace bespoke Astro layouts with Starlight integration
- Homepage and resource pages use StarlightPage wrapper
- Learning Hub articles rendered via Starlight docs collection
- Starlight provides search, theme toggle, sidebar, ToC, a11y
- Add custom Pagefind integration for resource search
- All 614 agents/skills/instructions/hooks/workflows/plugins
indexed as custom records with deep-link URLs
- Type filter pills (horizontal pill toggles) above results
- Search results link directly to resource modals via #file= hash
- Move global.css to src/styles/ for Vite processing
- Scope CSS reset to #main-content to avoid Starlight conflicts
- Full-width page gradient via body:has(#main-content)
- Light/dark theme support with Starlight gray scale inversion
- Delete old layouts (BaseLayout, ArticleLayout), theme.ts, config
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Address PR review feedback
- Fix pagefind-resources.ts header comment (pagefind:true not false)
- Remove unused base variable in cookbook/index.astro
- Replace hardcoded /awesome-copilot/ paths with relative links in index.md
- Delete stale public/styles/global.css (source of truth is src/styles/)
- Replace fragile getBasePath() with Astro config base in pagefind integration
- Document pagefind:true reasoning in astro.config.mjs
- Use proper visually-hidden pattern + :focus-visible ring for filter pills
- Remove dead header/nav/theme CSS from global.css (~160 lines)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---------
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- New article covering plugin concepts, finding/installing/managing plugins,
marketplace browsing, and how this repo serves as a plugin marketplace
- Add 'installing-and-using-plugins' to fundamentalsOrder in index.astro
and ArticleLayout.astro
- Add Plugin entry to terminology glossary
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Expand 'Specifying an Agent' into full 'Using Custom Agents' section
with agent profile format, storage locations, and selection methods
- Add 'Agent Skills and the Coding Agent' section covering how skills
are automatically loaded, directory structure, and SKILL.md format
- Add comparison table: Instructions vs Skills vs Custom Agents
- Add 'Leveraging Community Resources' section linking to this repo's
agents, skills, and hooks directories
- Update best practices with skills and agent recommendations
- Update FAQ to cover both agents and skills
- Add skills article to related articles and Next Steps
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Replace 'Building Custom Agents (coming soon)' with real links
- Add Hook and Coding Agent entries to the glossary
- Add MCP Servers learning hub link to glossary MCP entry
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add four high-priority articles identified by gap analysis against
nishanil/copilot-guide:
- Building Custom Agents: personas, tools, MCP integration, patterns
- Understanding MCP Servers: what MCP is, configuration, agent usage
- Automating with Hooks: lifecycle events, hooks.json, practical examples
- Using the Copilot Coding Agent: setup steps, issue assignment, PR workflow
Update index.astro fundamentalsOrder to include all 10 articles.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Replace all prompt file references with skills guidance throughout the
Learning Hub. Skills are the preferred customization primitive because
they support agent discovery via extended frontmatter, can bundle
reference files and scripts, and are portable across coding agent
systems via the Agent Skills specification.
- Create what-are-agents-skills-instructions.md (replaces prompts article)
- Create creating-effective-skills.md (replaces prompts tutorial)
- Delete what-are-agents-prompts-instructions.md and creating-effective-prompts.md
- Update copilot-configuration-basics.md directory structure and examples
- Update defining-custom-instructions.md comparisons and cross-references
- Update glossary: deprecate Prompt entry, add Skill definition
- Update understanding-copilot-context.md and before-after examples
- Update learning-hub index.astro slugs
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Add Astro Content Collection for learning-hub articles
- Move 5 fundamentals articles into website/src/content/learning-hub/
- Create ArticleLayout.astro for rendering markdown articles
- Create index page listing all articles in recommended reading order
- Create dynamic [slug].astro route for individual articles
- Add Learning Hub to main navigation and homepage cards
- Add article prose and index page CSS styles
- Update internal links to use website URLs
