This repository was archived by the owner on Aug 4, 2026. It is now read-only.
Sync skills with docs through d144903 (2026-07-30) - #8
Open
adrianthedev wants to merge 1 commit into
Open
Conversation
Reconcile the skills flagged by bin/docs_drift.rb against the docs changes between 3350dbe and d144903, and move docs-index.json to the new baseline. Trial licensing state is new in the docs: a trial is a fully valid license, and the sidebar "Avo Status" dot goes amber while one needs attention (no payment method on file, or the subscription behind it was cancelled) rather than because the license is broken. - avo-troubleshoot: new "Sidebar status dot is amber" symptom, table row, licensing.md added to the Docs list, and a description trigger for it. - avo-setup: one note in the license step so a trial key isn't mistaken for a broken one. Reviewed and left unchanged: avo-testing (the WebMock/clerk-host section it cites is untouched) and avo-update (its procedure is version-agnostic and already covers per-add-on upgrade sections). Verified the amber/trial behaviour against avo-licensing 4.0.10 (License#trial_at_risk?, AvoExtensions.app_status) and avo's sidebar indicator CSS before writing it. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RFCht2dX3dh5JN3kSf9Z5R
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 subscribe to this conversation on GitHub.
Already have an account?
Sign in.
2 participants
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.
Scheduled docs-drift reconciliation.
bin/docs_drift.rbflagged 4 changed pages between the old marker3350dbe(2026-07-28) and docsmainatd144903(2026-07-30).docs-index.jsonnow points atd144903.Docs commits in range:
d144903docs(intelligence): prompt customization, locals, and empty-state suggestions (#594)45d9adcAdd Intelligence addon page (not in sidebar yet) (#593)5b534c8docs: upgrade note for the opt-in card refresh control, and trial licensing state (#589)Changed pages
licensing.md(M)avo-setup## Trialssection: a trial is a fully valid license, and the sidebar Avo Status dot is green / amber / orange. Added a note to avo-setup's license step so a trial key isn't mistaken for a broken one, and routed diagnosis toavo-troubleshoot. Also addedlicensing.mdtoavo-troubleshoot's Docs list, which now covers the amber state.license-troubleshooting.md(M)avo-setup,avo-testing,avo-troubleshootavo-troubleshoot. The page gained one entry: "The sidebar status indicator is amber". That's a new symptom with a real diagnosis, so it got a symptom-table row and a section.avo-setupcovered by the row above.avo-testing— no change needed: it cites this page only for theWebMock::NetConnectNotAllowedError/ clerk-host allowlist, which is untouched by the diff.upgrade.md(M)avo-update## Upgrade to avo-dashboards 4.0.9— the per-card refresh control is now opt-in).avo-updatedeliberately enumerates no version sections; it teaches the procedure for working whichever chapters the lock diff crosses and already names the per-add-on chapter shape. It fetchesupgrade.mdat run time, so the new chapter is picked up with no edit. The underlyingself.refresh_buttonAPI is already documented inavo-dashboards-cards(added at the previous marker).intelligence.md(A)Skills edited
avo-troubleshoot— new### Sidebar status dot is ambersection (green/amber/orange meaning, the two causes and their different remedies, Refresh license + the response cache, theavo-licensing >= 4.0.10/avo >= 4.0.20floors); a matching symptom-table row;licensing.mdadded to the Docs list;descriptionextended to trigger on "the sidebar Avo Status dot showing amber or orange" and "a trial that says it's about to stop".avo-setup— one paragraph in step 6 (license key): a trial key wires up identically and gates nothing, and an amber dot is a trial needing attention rather than a broken key. Hands off toavo-troubleshoot.Skills reviewed and left alone
avo-testing— the section oflicense-troubleshooting.mdit draws on didn't change.avo-update— version-agnostic by design; the new upgrade chapter needs no skill edit.Verification
<Image|<CustomCode|<FieldTypesList" skills/' → empty.·- 'ruby bin/validate_skills.rb' → 'OK — 35 skills valid'.·- The trial behaviour was checked against source before writing, not taken from the docs alone: 'Avo::Licensing::License#trial_at_risk?' ('trial_in_progress? && (trial_canceled? || !trial_payment_method_on_file?)') and 'Avo::Licensing::Extensions::AvoExtensions.app_status' (':error' beats ':warning') in 'avo-licensing' 4.0.10, plus '.sidebar-status__indicator--{ok,warning,error}' in avo's 'sidebar.css'. The doc's stated version floors line up: avo-licensing is at 4.0.10, avo at 4.0.24.Not resolved — needs a human call
docs/4.0/intelligence.mdis new and no skill owns it. Avo Intelligence is a paid add-on with its own installer (avo:intelligence install), anintelligenceconfig namespace (thinking_effort,thinking_budget, each with anAVO_INTELLIGENCE_*env fallback), a prompt-ejection generator (avo:intelligence:eject extra_instructions/instructions), and a policy-drivendebug_level(:off/:tools, failing closed to:off). That is a vertical, not a paragraph to bolt onto an existing skill — it wants anavo-intelligenceskill. Per the run's instructions I did not create one. Worth noting the page is marked Beta and isn't in the sidebar yet, so it may be deliberate to wait.bin/docs_drift.rbcrashes under a non-UTF-8 locale. In this container (US-ASCIIdefault external encoding) line 64 raisesArgumentError: invalid byte sequence in US-ASCIIon theFile.read(path).scan(...)— some SKILL.md files contain non-ASCII characters. I worked around it withRUBYOPT="-E utf-8". The real fix isFile.read(path, encoding: "UTF-8")in that scan. Left untouched to keep this PR toskills/+docs-index.jsonas instructed — happy to send it as a one-line follow-up.Generated by Claude Code