Sync skills with docs through 33872ab (2026-08-02)

[adrianthedev]

Reconciles the skills flagged by bin/docs_drift.rb against docs.avohq.io changes since the previous marker 3350dbe (2026-07-28), and moves docs-index.json to 33872ab (2026-08-02).

Changed pages

Changed page	Skills citing it	What I did
keyboard-shortcuts.md (M)	avo-navigation-search	Edited. The page gained an ## Assistant section: Cmd/Ctrl+J opens the assistant, requires the Intelligence add-on, and is the one shortcut that still fires while you're typing. The skill stated the no-fire-while-typing rule as absolute, so that was actually wrong now — noted the exception, and added the shortcut with its add-on requirement and its continued obedience to config.hotkeys[:enabled].
license-troubleshooting.md (M)	avo-setup, avo-testing, avo-troubleshoot	Edited avo-troubleshoot. New The sidebar status indicator is amber entry — amber is a trial needing attention, not a license failure. Added a symptom-table row, then a fourth diagnostic step covering the green/amber/orange meanings, the two distinct causes (no payment method vs. cancelled subscription) and the fact that they have different remedies, the Refresh license step (Avo caches the license response between checks), and the avo-licensing 4.0.10 / Avo 4.0.20 version floors. Added licensing.md to its Docs list and extended the frontmatter description so the skill triggers on "the Avo Status dot is amber".
licensing.md (M)	avo-setup	Edited avo-setup. New ## Trials section. Added two sentences to the license step: a trial key is a fully valid license with nothing gated while it runs, and what amber means — with diagnosis pointed at avo-troubleshoot rather than duplicated here.
upgrade.md (M)	avo-update	No change needed. The addition is a new per-add-on section (Upgrade to avo-dashboards 4.0.9, the per-card refresh control becoming opt-in). avo-update doesn't enumerate guide sections — it teaches the procedure, and already covers per-add-on sections and silent default flips explicitly. The underlying API (self.refresh_button, default false) is already documented correctly in avo-dashboards-cards, which I checked.
intelligence.md (A)	—	Not owned by any skill. See below.
intelligence-agents-and-tools.md (A)	—	Not owned by any skill. See below.

Skills edited

• avo-navigation-search
• avo-setup
• avo-troubleshoot

Skills reviewed and left alone

• avo-testing — cites license-troubleshooting.md, but the only change on that page was the amber-trial entry. The net-connect / WebMock::NetConnectNotAllowedError material this skill is built on is untouched.
• avo-update — see the table.
• avo-dashboards-cards — not flagged (the cards-api.md changes predate the marker), checked anyway because of the upgrade.md note. Already documents refresh_button as an opt-in defaulting to false, on both the card and the dashboard, including that the two are independent.

Unresolved / needs a decision

No skill owns Avo Intelligence. Nine of the ten commits in this window are the new Intelligence add-on (avo-intelligence, paid add-on, Beta): intelligence.md (506 lines) and intelligence-agents-and-tools.md. Between them they cover the chat bar and dock, agents and tools with their gates, ChatPolicy#available_models and #destroy?, prompt customization and identity, record context and the attach ribbon, model switching and provider pinning, Active Storage reports and attach/detach, and running a resource's actions from the chat. That is comfortably a vertical of its own, and per the refresh brief I did not create it here — flagging it as follow-up.

Two consequences worth noting while it doesn't exist:

• The add-on's Cmd/Ctrl+J shortcut is now described in avo-navigation-search, which is the right home for the shortcut itself but not for the feature.
• I deliberately did not add intelligence.md to any skill's Docs line. Citations drive bin/docs_drift.rb, and a page this actively edited would flag avo-navigation-search on every Intelligence commit for something it doesn't own. The cross-reference names the add-on and the gem without a docs URL. Worth revisiting once an avo-intelligence skill exists.

Also: the docs note that the Intelligence installer only writes the initial migration, so installs from an earlier alpha are missing the attached_context column and raise on every new chat, with a hand-written migration given under Installation. Nothing to reconcile today — recording it so it isn't lost when the skill gets written.

Verification

• grep -rnE "\[!code|:::|<Option|``&lt;Image|&lt;CustomCode|&lt;FieldTypesList``" skills/ — no matches.
• ruby bin/validate_skills.rb — OK — 35 skills valid.

Note on the branch name

The refresh brief asks for docs-sync/<docs-HEAD-date>. This session is pinned by its harness to claude/upbeat-bohr-thf4bl and instructed never to push elsewhere, so the commit went there instead. Content is unaffected.

---

Generated by Claude Code