Docs: Update Agent Skills documentation by jkcinouye · Pull Request #22388 · google-gemini/gemini-cli

jkcinouye · 2026-03-13T22:27:10Z

Summary

This PR pulls the agent skills documentation into a nested nav and adds supporting documentation.

Details

In this pull:

Updates the navigation to link to overview, user guide, developer guide, and best practices.
Adds a guide for individuals using and installing skills.
Makes a specific guide for developing skills.
Creates best practices guide.

Related Issues

Closes #22387

How to Validate

Pre-Merge Checklist

github-actions · 2026-03-13T22:31:21Z

Size Change: -4 B (0%)

Total Size: 33.9 MB

Filename	Size	Change
`./bundle/chunk-JN5CHBNK.js`	0 B	-656 kB (removed)	🏆
`./bundle/chunk-KCLS5ACN.js`	0 B	-3.8 kB (removed)	🏆
`./bundle/chunk-MWSZOHVV.js`	0 B	-14.7 MB (removed)	🏆
`./bundle/chunk-UF2FL2RV.js`	0 B	-12.6 kB (removed)	🏆
`./bundle/chunk-VI6SSBSQ.js`	0 B	-19.5 kB (removed)	🏆
`./bundle/chunk-YCHNBIZJ.js`	0 B	-2.72 MB (removed)	🏆
`./bundle/chunk-YDY3RVL2.js`	0 B	-49.2 kB (removed)	🏆
`./bundle/chunk-ZUJBNTS7.js`	0 B	-3.43 kB (removed)	🏆
`./bundle/core-UKTT2DZO.js`	0 B	-48.2 kB (removed)	🏆
`./bundle/devtoolsService-Y4CD2LRB.js`	0 B	-28 kB (removed)	🏆
`./bundle/gemini-6WOZSFVT.js`	0 B	-580 kB (removed)	🏆
`./bundle/interactiveCli-SSOU3UQJ.js`	0 B	-1.32 MB (removed)	🏆
`./bundle/liteRtServerManager-6QXTYWDK.js`	0 B	-2.11 kB (removed)	🏆
`./bundle/oauth2-provider-DUQ2LGII.js`	0 B	-9.16 kB (removed)	🏆
`./bundle/chunk-4Z32HHMJ.js`	3.8 kB	+3.8 kB (new file)	🆕
`./bundle/chunk-6FTEMOJH.js`	14.7 MB	+14.7 MB (new file)	🆕
`./bundle/chunk-EY7EBNA7.js`	19.5 kB	+19.5 kB (new file)	🆕
`./bundle/chunk-F6JIHBHM.js`	3.43 kB	+3.43 kB (new file)	🆕
`./bundle/chunk-IQ5HUEAO.js`	12.6 kB	+12.6 kB (new file)	🆕
`./bundle/chunk-LT67U7B3.js`	2.72 MB	+2.72 MB (new file)	🆕
`./bundle/chunk-O6EHKK7P.js`	656 kB	+656 kB (new file)	🆕
`./bundle/chunk-XYVVBBO2.js`	49.2 kB	+49.2 kB (new file)	🆕
`./bundle/core-OSKNGTFW.js`	48.2 kB	+48.2 kB (new file)	🆕
`./bundle/devtoolsService-WRCP2XFQ.js`	28 kB	+28 kB (new file)	🆕
`./bundle/gemini-A4MY7UPD.js`	580 kB	+580 kB (new file)	🆕
`./bundle/interactiveCli-Z3SCPHCD.js`	1.32 MB	+1.32 MB (new file)	🆕
`./bundle/liteRtServerManager-6QOIFE4Z.js`	2.11 kB	+2.11 kB (new file)	🆕
`./bundle/oauth2-provider-PUSGTFYE.js`	9.16 kB	+9.16 kB (new file)	🆕

ℹ️ View Unchanged

Filename	Size	Change
`./bundle/bundled/third_party/index.js`	8 MB	0 B
`./bundle/chunk-34MYV7JD.js`	2.45 kB	0 B
`./bundle/chunk-5AUYMPVF.js`	858 B	0 B
`./bundle/chunk-5PS3AYFU.js`	1.18 kB	0 B
`./bundle/chunk-664ZODQF.js`	124 kB	0 B
`./bundle/chunk-DAHVX5MI.js`	206 kB	0 B
`./bundle/chunk-IUUIT4SU.js`	56.5 kB	0 B
`./bundle/chunk-RJTRUG2J.js`	39.8 kB	0 B
`./bundle/chunk-XRLFHCHC.js`	1.97 MB	0 B
`./bundle/cleanup-QTIXALQW.js`	0 B	-932 B (removed)	🏆
`./bundle/devtools-36NN55EP.js`	696 kB	0 B
`./bundle/dist-T73EYRDX.js`	356 B	0 B
`./bundle/events-XB7DADIJ.js`	418 B	0 B
`./bundle/examples/hooks/scripts/on-start.js`	188 B	0 B
`./bundle/examples/mcp-server/example.js`	1.43 kB	0 B
`./bundle/gemini.js`	5.14 kB	0 B
`./bundle/getMachineId-bsd-TXG52NKR.js`	1.55 kB	0 B
`./bundle/getMachineId-darwin-7OE4DDZ6.js`	1.55 kB	0 B
`./bundle/getMachineId-linux-SHIFKOOX.js`	1.34 kB	0 B
`./bundle/getMachineId-unsupported-5U5DOEYY.js`	1.06 kB	0 B
`./bundle/getMachineId-win-6KLLGOI4.js`	1.72 kB	0 B
`./bundle/memoryDiscovery-FN3IAPBT.js`	980 B	0 B
`./bundle/multipart-parser-KPBZEGQU.js`	11.7 kB	0 B
`./bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js`	222 kB	0 B
`./bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js`	229 kB	0 B
`./bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js`	13.4 kB	0 B
`./bundle/node_modules/@google/gemini-cli-devtools/dist/src/types.js`	132 B	0 B
`./bundle/sandbox-macos-permissive-open.sb`	890 B	0 B
`./bundle/sandbox-macos-permissive-proxied.sb`	1.31 kB	0 B
`./bundle/sandbox-macos-restrictive-open.sb`	3.36 kB	0 B
`./bundle/sandbox-macos-restrictive-proxied.sb`	3.56 kB	0 B
`./bundle/sandbox-macos-strict-open.sb`	4.82 kB	0 B
`./bundle/sandbox-macos-strict-proxied.sb`	5.02 kB	0 B
`./bundle/src-QVCVGIUX.js`	47 kB	0 B
`./bundle/start-LXCGXPDW.js`	0 B	-652 B (removed)	🏆
`./bundle/tree-sitter-7U6MW5PS.js`	274 kB	0 B
`./bundle/tree-sitter-bash-34ZGLXVX.js`	1.84 MB	0 B
`./bundle/cleanup-VYVLY243.js`	932 B	+932 B (new file)	🆕
`./bundle/start-GYQUMBMI.js`	652 B	+652 B (new file)	🆕

_{compressed-size-action}

Co-authored-by: Sam Roberts <158088236+g-samroberts@users.noreply.github.com>

gemini-code-assist · 2026-04-01T19:01:14Z

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the Agent Skills documentation by restructuring it into a comprehensive, nested navigation system. It introduces new guides for skill development and best practices while updating existing content to provide clearer instructions on the skill lifecycle and management.

Highlights

Documentation Restructuring: Organized Agent Skills documentation into a nested navigation structure to improve discoverability and logical flow.
New Guides Added: Introduced dedicated guides for using skills, developing skills, and following best practices.
Content Updates: Refined existing documentation to clarify the skill lifecycle, discovery tiers, and management commands.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

gemini-code-assist

Code Review

This pull request significantly expands and reorganizes the documentation for Agent Skills in the Gemini CLI. It introduces a new 'Best Practices' guide, a 'Using Agent Skills' management guide, and updates the existing 'Creating Skills' and 'Getting Started' tutorials to reflect the latest CLI commands and directory structures. The sidebar configuration was also updated to provide a more structured navigation experience. One minor issue was identified regarding a broken relative link to the GEMINI.md documentation.

_{Note: Security Review has been skipped due to the limited scope of the PR.}

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Co-authored-by: Sam Roberts <158088236+g-samroberts@users.noreply.github.com> Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

jkcinouye added 3 commits March 6, 2026 12:29

Saving pre-work

5240610

Docs: Add agent skills docs.

67fd469

Docs: Build out and promote Agent Skills docs

a498768

gemini-cli Bot added area/documentation Gemini CLI documentation tasks and issues 🔒 maintainer only ⛔ Do not contribute. Internal roadmap item. labels Mar 13, 2026

jkcinouye added 3 commits March 16, 2026 13:13

Docs: Revise agent skills docs

4e0be30

Docs: Agent Skills documentation.

f5c1e10

Docs: Organizing Agent Skills docs

6a5024d

g-samroberts reviewed Mar 31, 2026

View reviewed changes

Comment thread docs/cli/tutorials/skills-getting-started.md Outdated

jkcinouye marked this pull request as ready for review April 1, 2026 19:00

jkcinouye requested review from a team as code owners April 1, 2026 19:00

Update docs/cli/tutorials/skills-getting-started.md

ca4926c

Co-authored-by: Sam Roberts <158088236+g-samroberts@users.noreply.github.com>

Merge branch 'main' into docs-update-agent-skills

85bfae2

gemini-code-assist Bot reviewed Apr 1, 2026

View reviewed changes

Comment thread docs/cli/skills.md Outdated

g-samroberts approved these changes Apr 1, 2026

View reviewed changes

Comment thread docs/cli/creating-skills.md Outdated

jkcinouye changed the title ~~(Draft) Docs: Update Agent Skills documentation~~ Docs: Update Agent Skills documentation Apr 2, 2026

jkcinouye and others added 5 commits April 9, 2026 09:31

Update docs/cli/skills.md

24e947f

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Agent skills: Formatting fix.

5de7cfd

Merge branch 'main' into docs-update-agent-skills

cc2238d

Merge branch 'main' into docs-update-agent-skills

0a3a77a

Merge branch 'main' into docs-update-agent-skills

934f0ea

jkcinouye added this pull request to the merge queue Apr 30, 2026

Merged via the queue into main with commit 778da08 Apr 30, 2026
26 of 27 checks passed

jkcinouye deleted the docs-update-agent-skills branch April 30, 2026 20:38

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Docs: Update Agent Skills documentation #22388

Docs: Update Agent Skills documentation #22388
jkcinouye merged 13 commits intomainfrom
docs-update-agent-skills

jkcinouye commented Mar 13, 2026

Uh oh!

github-actions Bot commented Mar 13, 2026 •

edited

Loading

Uh oh!

Uh oh!

gemini-code-assist Bot commented Apr 1, 2026

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

jkcinouye commented Mar 13, 2026

Summary

Details

Related Issues

How to Validate

Pre-Merge Checklist

Uh oh!

github-actions Bot commented Mar 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

gemini-code-assist Bot commented Apr 1, 2026

Summary of Changes

Highlights

Footnotes

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

github-actions Bot commented Mar 13, 2026 •

edited

Loading