Open
Conversation
Add a comprehensive style guide and reference docs for building polished Shiny (Python) dashboards. SKILL.md contains critical rules (icon usage, layout hierarchy, value box/card conventions, number formatting), Core and Express quick-start examples, and best practices for charts and responsive grids. Six reference files (components.md, core-vs-express.md, icons-and-maps.md, layout-and-navigation.md, reactivity-and-rendering.md, styling-and-data.md) provide detailed patterns for components, imports/usage differences, icons/maps, navigation, reactivity/rendering, and styling/data-loading to ensure consistent, maintainable dashboards.
karangattu
changed the title
cpsievert
reviewed
Mar 5, 2026
cpsievert
reviewed
Mar 5, 2026
cpsievert
reviewed
Mar 5, 2026
cpsievert
requested changes
Mar 5, 2026
cpsievert
left a comment
cpsievert
left a comment
There was a problem hiding this comment.
There are some ideas in here that I like (core vs express, express examples, etc), but it also feels too targeted at the eval we've been working on in a way that's difficult to unravel.
Based on what we've seen with Opus 4.6, it seems to already have a pretty good grasp on how Shiny works. It feels like it might do a pretty good job with the skill-creator skill and relatively little direction/context? If not, maybe we point it at the website and ask it to distill some of the general concepts + best practices from there?
Major rewrite and reorganization of the Shiny for Python dashboard skill and reference pages. SKILL.md was modernized and consolidated: guidance is reframed around page/layout primitives (ui.page_sidebar/ui.page_navbar, ui.card, ui.layout_columns/wrap), critical rules were clarified, examples updated (renamed inputs/outputs, improved plotting/code patterns, explicit number formatting, import placement for matplotlib, use of DataGrid, full_screen usage), and many anti-patterns/emoji usage were removed and replaced with faicons/bootstrap-icon recommendations. Reference files were refactored: components.md focuses on cards, value boxes, headers, popovers, accordions, tooltips, and best practices; core-vs-express.md was condensed to a clear decision guide and side-by-side skeletons for choosing Core vs Express; icons-and-maps.md was trimmed to practical icon rules and map guidance (clean coordinates, full-screen cards, explicit heights). Cross-references to related docs (layout, reactivity, styling) were added or emphasized. Overall this commit standardizes examples and guidance to produce more consistent, mobile-friendly, and maintainable dashboard patterns.
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
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.
Add a comprehensive style guide and reference docs for building polished Shiny (Python) dashboards. SKILL.md contains critical rules (icon usage, layout hierarchy, value box/card conventions, number formatting), Core and Express quick-start examples, and best practices for charts and responsive grids. Six reference files (components.md, core-vs-express.md, icons-and-maps.md, layout-and-navigation.md, reactivity-and-rendering.md, styling-and-data.md) provide detailed patterns for components, imports/usage differences, icons/maps, navigation, reactivity/rendering, and styling/data-loading to ensure consistent, maintainable dashboards.