[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EMQQ745DA77Z55KP3SB39P":3,"skill-same:01M7EMQQ745DA77Z55KP3SB39P":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7EMQQ745DA77Z55KP3SB39P","ams-d3-visualizations",null,"TanNhatCMS\u002Fjarvis","TanNhatCMS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F113796420?v=4","01M753MV17KG5CD3152G3WQEQY","KietNT","01M7EKEDYVYQ6PWVJJMZ911VMX",0,"MIT","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-d3-visualizations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: d3-visualizations\ndescription: Design data visualizations with D3 for the web: dashboards, interactive explorers, maps, and storytelling pieces. Use for data-viz products and features.\ncategory: web-development\n---\n\n# D3 Visualizations\n\nA product-focused companion to D3 mechanics: designing visualizations for web products — dashboard charts, interactive explorers, geographic maps, scrollytelling pieces — with the design judgment and engineering patterns that make them effective.\n\n## Overview\n\nKnowing D3's API (see d3-pro) is half the skill; the other half is **visualization design**: choosing the right encoding, handling real-world data messiness, building for interaction, and integrating charts into product UI. This skill covers the product layer: chart selection, dashboard architecture, maps, and narrative visualization.\n\n## When to use\n\n- Choosing chart types for a dashboard or report feature.\n- Building interactive data explorers (filter, brush, drill-down).\n- Geographic visualizations (choropleths, bubble maps).\n- Scrollytelling \u002F narrative data pieces.\n- Making visualizations accessible and responsive in products.\n\n## Core concepts\n\n- **Chart selection.** Comparison → bars; trend → line; part-of-whole → stacked bars (pies only for 2–3 parts); distribution → histogram\u002Fbox; correlation → scatter; geography → map; flow → sankey. Match encoding to question, not to novelty.\n- **Dashboard architecture.** One `Visualization` component per chart type wrapping a D3 render function; data via props; interactions via callbacks up to a dashboard state (cross-filtering). Keep D3 inside the render function, React outside it.\n- **Scales as design decisions.** Domain choices (zero baseline for bars), tick formatting (human units: $1.2M not 1200000), color scales (sequential\u002Fdiverging with colorblind-safe palettes like viridis; never rainbow).\n- **Interaction vocabulary.** Hover tooltips (details on demand), brush (range select), zoom (inspect), click drill-down, linked highlighting across charts. Pick 1–2 per visualization — more is clutter.\n- **Maps.** TopoJSON (small) over GeoJSON; `d3.geoMercator`\u002F`geoAlbersUsa` projections; `topojson-client` to convert. Choropleth = fill by value via threshold\u002Fquantize scale; bubble map = circles sized by value.\n- **Narrative structure.** Scrollytelling: sticky chart + stepping narrative; annotate directly on the chart (labels beat legends); reveal data progressively to build the argument.\n\n## Practical workflow\n\n**1. Start from the question.** \"What decision does this chart support?\" Write it down. Every encoding choice serves it.\n\n**2. React + D3 integration pattern.**\n```tsx\nfunction BarChart({ data, onSelect }: Props) {\n  const ref = useRef\u003CSVGSVGElement>(null);\n  useEffect(() => {\n    if (!ref.current) return;\n    renderBarChart(d3.select(ref.current), data, { onSelect }); \u002F\u002F D3 lives here\n    return () => { d3.select(ref.current).selectAll('*').remove(); };\n  }, [data]);\n  return \u003Csvg ref={ref} role=\"img\" aria-label=\"...\" \u002F>;\n}\n```\nD3 owns the SVG internals; React owns mounting, data flow, and cleanup.\n\n**3. Dashboard cross-filtering.** Dashboard holds filter state; each chart receives filtered data + emits selections; selections update the shared filter. Debounce rapid brush events.\n\n**4. Maps.**\n```js\nconst projection = d3.geoMercator().fitSize([width, height], topojson.feature(topology, topology.objects.countries));\nconst path = d3.geoPath(projection);\nconst color = d3.scaleQuantize().domain(d3.extent(values)).range(d3.schemeBlues[7]);\n```\n\n**5. Accessibility.** Every chart: `role=\"img\"` + descriptive `aria-label`; accompanying data table (visually-hidden or toggleable); keyboard-operable controls for filters; don't encode critical info in color alone (add labels\u002Fpatterns).\n\n**6. Responsive.** `viewBox` scaling; re-render on significant breakpoint changes (rotate axis labels on narrow); hide decorative elements on small screens, keep the data.\n\n## Common pitfalls\n\n- **Chart junk.** 3D effects, heavy gradients, decorative icons — ink that isn't data. Maximize data-ink ratio.\n- **Wrong chart for the question.** Pie with 12 slices, line chart for categories, truncated bar axes — the classic lies. Choose by the comparison type.\n- **Rainbow color scales.** Perceptually non-uniform and colorblind-hostile. Sequential → single-hue; diverging → two-hue; categorical → distinct hues (≤8 categories, then group \"other\").\n- **Missing data honesty.** Gaps, uncertainty, and sample sizes hidden. Show missing data as gaps (not zero), indicate uncertainty where it matters.\n- **Interaction without purpose.** Zoom\u002Fbrush on a 12-point chart. Add interaction where exploration adds insight, not as decoration.\n- **D3 fighting React.** D3 mutating DOM that React manages = reconciliation bugs. Boundary rule: D3 owns inside the SVG; React owns everything else.\n- **No numbers on the chart.** Forcing users to estimate from axes. Label key values directly (latest value, max, annotated points).\n- **Performance with big data.** Rendering 100k SVG nodes kills the browser. Aggregate, sample, or switch to canvas for large datasets.\n- **Inaccessible by default.** A canvas\u002FSVG chart with no text alternative excludes screen-reader users. Budget the accessible version from the start.\n","# D3 Visualizations\n\nA product-focused companion to D3 mechanics: designing visualizations for web products — dashboard charts, interactive explorers, geographic maps, scrollytelling pieces — with the design judgment and engineering patterns that make them effective.\n\n## Overview\n\nKnowing D3's API (see d3-pro) is half the skill; the other half is **visualization design**: choosing the right encoding, handling real-world data messiness, building for interaction, and integrating charts into product UI. This skill covers the product layer: chart selection, dashboard architecture, maps, and narrative visualization.\n\n## When to use\n\n- Choosing chart types for a dashboard or report feature.\n- Building interactive data explorers (filter, brush, drill-down).\n- Geographic visualizations (choropleths, bubble maps).\n- Scrollytelling \u002F narrative data pieces.\n- Making visualizations accessible and responsive in products.\n\n## Core concepts\n\n- **Chart selection.** Comparison → bars; trend → line; part-of-whole → stacked bars (pies only for 2–3 parts); distribution → histogram\u002Fbox; correlation → scatter; geography → map; flow → sankey. Match encoding to question, not to novelty.\n- **Dashboard architecture.** One `Visualization` component per chart type wrapping a D3 render function; data via props; interactions via callbacks up to a dashboard state (cross-filtering). Keep D3 inside the render function, React outside it.\n- **Scales as design decisions.** Domain choices (zero baseline for bars), tick formatting (human units: $1.2M not 1200000), color scales (sequential\u002Fdiverging with colorblind-safe palettes like viridis; never rainbow).\n- **Interaction vocabulary.** Hover tooltips (details on demand), brush (range select), zoom (inspect), click drill-down, linked highlighting across charts. Pick 1–2 per visualization — more is clutter.\n- **Maps.** TopoJSON (small) over GeoJSON; `d3.geoMercator`\u002F`geoAlbersUsa` projections; `topojson-client` to convert. Choropleth = fill by value via threshold\u002Fquantize scale; bubble map = circles sized by value.\n- **Narrative structure.** Scrollytelling: sticky chart + stepping narrative; annotate directly on the chart (labels beat legends); reveal data progressively to build the argument.\n\n## Practical workflow\n\n**1. Start from the question.** \"What decision does this chart support?\" Write it down. Every encoding choice serves it.\n\n**2. React + D3 integration pattern.**\n```tsx\nfunction BarChart({ data, onSelect }: Props) {\n  const ref = useRef\u003CSVGSVGElement>(null);\n  useEffect(() => {\n    if (!ref.current) return;\n    renderBarChart(d3.select(ref.current), data, { onSelect }); \u002F\u002F D3 lives here\n    return () => { d3.select(ref.current).selectAll('*').remove(); };\n  }, [data]);\n  return \u003Csvg ref={ref} role=\"img\" aria-label=\"...\" \u002F>;\n}\n```\nD3 owns the SVG internals; React owns mounting, data flow, and cleanup.\n\n**3. Dashboard cross-filtering.** Dashboard holds filter state; each chart receives filtered data + emits selections; selections update the shared filter. Debounce rapid brush events.\n\n**4. Maps.**\n```js\nconst projection = d3.geoMercator().fitSize([width, height], topojson.feature(topology, topology.objects.countries));\nconst path = d3.geoPath(projection);\nconst color = d3.scaleQuantize().domain(d3.extent(values)).range(d3.schemeBlues[7]);\n```\n\n**5. Accessibility.** Every chart: `role=\"img\"` + descriptive `aria-label`; accompanying data table (visually-hidden or toggleable); keyboard-operable controls for filters; don't encode critical info in color alone (add labels\u002Fpatterns).\n\n**6. Responsive.** `viewBox` scaling; re-render on significant breakpoint changes (rotate axis labels on narrow); hide decorative elements on small screens, keep the data.\n\n## Common pitfalls\n\n- **Chart junk.** 3D effects, heavy gradients, decorative icons — ink that isn't data. Maximize data-ink ratio.\n- **Wrong chart for the question.** Pie with 12 slices, line chart for categories, truncated bar axes — the classic lies. Choose by the comparison type.\n- **Rainbow color scales.** Perceptually non-uniform and colorblind-hostile. Sequential → single-hue; diverging → two-hue; categorical → distinct hues (≤8 categories, then group \"other\").\n- **Missing data honesty.** Gaps, uncertainty, and sample sizes hidden. Show missing data as gaps (not zero), indicate uncertainty where it matters.\n- **Interaction without purpose.** Zoom\u002Fbrush on a 12-point chart. Add interaction where exploration adds insight, not as decoration.\n- **D3 fighting React.** D3 mutating DOM that React manages = reconciliation bugs. Boundary rule: D3 owns inside the SVG; React owns everything else.\n- **No numbers on the chart.** Forcing users to estimate from axes. Label key values directly (latest value, max, annotated points).\n- **Performance with big data.** Rendering 100k SVG nodes kills the browser. Aggregate, sample, or switch to canvas for large datasets.\n- **Inaccessible by default.** A canvas\u002FSVG chart with no text alternative excludes screen-reader users. Budget the accessible version from the start.\n",{},"main","af388a77c2fe5e0b4fd879cca4300a0ffa9a6579","skills\u002Fams-d3-visualizations",1,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis","https:\u002F\u002Fgithub.com\u002FTanNhatCMS","https:\u002F\u002Fmrkiet.name.vn","2026-11-07 14:23:08",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add TanNhatCMS\u002Fjarvis --skill ams-d3-visualizations",{"tool":37,"command":38},"bunx","bunx skills add TanNhatCMS\u002Fjarvis --skill ams-d3-visualizations",{"tool":40,"command":41},"pnpm","pnpm dlx skills add TanNhatCMS\u002Fjarvis --skill ams-d3-visualizations","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-d3-visualizations\u002FSKILL.md",true,[],[46,53,61,68,75,82],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M7EWYJR0J8DARY7E59Z6Y9MV","web-scrape","Turn web pages into LLM-ready markdown via the Firecrawl API (renders JS, anti-bot handling). Use when browser_open\u002Ffetch fails on JS-heavy pages, or when you need clean markdown\u002Fstructured extraction from a site. Requires FIRECRAWL_API_KEY.","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fweb-scrape\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":57,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M7EWYBN5P6F2AJG3FR24T9BP","design-taste-frontend","tasteskill v2, the anti-slop frontend skill. Art direction for websites, distilled from a study of 247 curated gallery sites (One Page Love, Awwwards Sites of the Day). Deals researched directions (idea, composition, type, palette, photographs, section blueprints) from a library, enforces a strict no-slop house style with a real-browser inspector, and runs a look-and-fix loop on screenshots. Use this whenever you build, design, redesign, restyle, polish or review a landing page, marketing site, portfolio, product page, one-pager, hero or any public-facing web page, in any stack (HTML\u002FCSS, React, Next.js, Vue, Svelte, Astro, Tailwind) — also when the user says a page looks generic, templated, \"AI-made\", sloppy, or asks to make it look designed, premium, award-level or less like every other site. Not for dashboards or app screens.","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Ftaste-design\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Ftaste-design\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EWY8FQFNQ2GB7NZZWGSSDX","test-driven-development","Use when implementing any feature or bugfix, before writing implementation code","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-tdd\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M7EWY5SHBFRH1HDHVWM9K7TV","systematic-debugging","Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-debugging\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M7EWY3NM0Z0JAKS7HDZ24K66","requesting-code-review","Use when completing tasks, implementing major features, or before merging to verify work meets requirements","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-code-review\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M7EWY0WRMWX4M9ZFY0WKC593","brainstorming","You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-brainstorming\u002FSKILL.md",[],[]]