docs(skill): flow layer reference, O-D default-to-flow rule, install pin - #3673
Merged
lixun910 merged 3 commits intoAug 29, 2026
Merged
Conversation
Plain 'pip install keplergl' resolves to the 0.3.x stable on PyPI (old API, sdist fails to build on Python 3.14), which breaks every example in the skill. Pin to the 0.4.0 prerelease until it goes stable. Co-Authored-By: Claude Code <noreply@anthropic.com>
Document the 'flow' layer type for aggregated O-D flow maps: column assignments (Lat/Lng and H3 modes, count/sourceName/targetName), the never-auto-created rule (a configless export falls back to an arc layer for O-D data), colorRange-only coloring, and the full list of flowVisConfig knobs. Verified headless Chrome renders the worked example as a Flow layer with animated lines and location totals.
Port the layer-selection guidance from the fsq-spatial-desktop map-visualization skill: a 'Picking a Layer Type' section in SKILL.md (default to flow for origin-destination requests, arc only on explicit unaggregated requests), a strengthened flow-vs-arc intro in flow-layer.md, and suggested sequential palettes. Verified the fsq fork's flow-layer.ts is an older copy of this repo's file (missing the fields-based accessors, globe occlusion and tooltip fixes), so its column-alias autodetector — which lives in that repo's spatial-agent, not kepler.gl — stays out of this skill. Co-Authored-By: Claude Code <noreply@anthropic.com>
lixun910
merged commit Aug 29, 2026
c4f489f
into
xli-move-skill-to-bindings-python
6 of 8 checks passed
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 join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
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.
Stacked on #3671 (merge that first — this PR contains its commits as the base).
What
Content updates to the kepler.gl agent skill (now at
bindings/python/skill/after #3671), adapted from the fsq-spatial-desktopmap-visualizationskill:skill-references/flow-layer.md(new) — documents the'flow'layer for aggregated O-D flow maps: the never-auto-created rule (a configless O-D export falls back to anarclayer — this is the behavior observed in testing), Lat/Lng and H3 column modes, full worked example (10 airports + flights),flowVisConfigknob reference,colorRange-only coloring, pitfalls, suggested sequential palettes.SKILL.md— new "Picking a Layer Type" section with the O-D requests default toflowrule (flow renders fine even for a handful of pairs;arconly on explicit unaggregated request; never substitute geojson/line for an O-D request), Flow row + flow reference link + auto-creation fallback Key Rule.SKILL.mdinstall fix —pip install keplergl==0.4.0rc4instead of plainpip install keplergl(which resolves to the incompatible 0.3.x stable that fails to build on Python 3.14).Verification
FlowLayerconfirmed present in thekepler.gl@3.3.0-alpha.8UMD bundle, added in feat: basic flow layer implementation #3386, tagged sincev3.3.0-alpha.1.save_to_html()and rendered headless Chrome: side panel shows a Flow layer with animated direction lines and location-total circles.source_lat,origin_h3, …) was deliberately NOT ported — it lives in that repo'sspatial-agenthandler, not in kepler.gl core; kepler.gl reads the columns assigned in the config.🤖 Generated with Claude Code