From 08753b49b3d3eeec2f455a2ebfdcfa5482faaa6a Mon Sep 17 00:00:00 2001 From: creazyfrog Date: Sat, 20 Jun 2026 22:01:39 -0700 Subject: [PATCH] docs: explain expected commands/ warning when installed as Claude Code plugin When agent-skills is installed as a Claude Code plugin, the plugin loader emits a cosmetic warning about the root commands/ folder being ignored in favour of .claude/commands/. The root commands/ directory is intentional (Antigravity CLI), so the warning confuses installers into thinking something is broken. Add a Note callout under 'Using Commands' in getting-started.md clarifying that the warning is expected and all Claude Code commands load correctly. Fixes #298 Co-Authored-By: Claude Sonnet 4.6 --- docs/getting-started.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/getting-started.md b/docs/getting-started.md index f40eb144..71593010 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -112,6 +112,12 @@ The `.claude/commands/` directory contains slash commands for Claude Code: | `/review` | code-review-and-quality | | `/ship` | shipping-and-launch | +> **Note:** When installed as a Claude Code plugin you may see a warning like +> _"Default commands/ folder is ignored because the manifest sets 'commands'"_. +> This is expected. The root `commands/` directory belongs to the Antigravity CLI +> and is intentionally separate from `.claude/commands/`. All Claude Code slash +> commands load correctly from `.claude/commands/`; the warning is cosmetic. + ## Using References The `references/` directory contains supplementary checklists: