[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M69AXSRQVDB9W7S83SRE0ZSP":3,"skill-same:01M69AXSRQVDB9W7S83SRE0ZSP":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":28,"publishedAt":33,"linkOnly":34,"markdownContent":35,"markdownBody":36,"frontMatter":37,"refName":38,"commitSha":39,"skillDirectory":40,"forksCount":41,"repositoryHtmlUrl":42,"repositoryHomepageUrl":43,"ownerHtmlUrl":44,"ownerBlogUrl":45,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M69AXSRQVDB9W7S83SRE0ZSP","flint-theme-author",null,"Use when: creating, translating, refining, reviewing, or validating a custom Flint ThemeSpec from brand guidelines, websites, slide decks, publication references, design tokens, or an existing visual identity. Produce a reusable ThemeSpec JSON object for Flint Theme Lab without inventing fields or changing chart semantics.","microsoft\u002Fflint-chart","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M69AXB6SP1R3N8FK0Y1CNSDW",4576,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Fblob\u002Fmain\u002Fagent-skills\u002Fflint-theme-author\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[29,30,31,32],"flint theme author","design","brand guidelines","identity","2026-11-10 10:12:30",false,"---\nname: flint-theme-author\ndescription: \"Use when: creating, translating, refining, reviewing, or validating a custom Flint ThemeSpec from brand guidelines, websites, slide decks, publication references, design tokens, or an existing visual identity. Produce a reusable ThemeSpec JSON object for Flint Theme Lab without inventing fields or changing chart semantics.\"\n---\n\n# Flint ThemeSpec authoring\n\nCreate a reusable visual system for Flint charts. Translate the user's reference\nmaterials into one valid `ThemeSpec` that can be pasted directly into Theme Lab.\n\n## Authoritative references\n\nRead these before authoring. When prose and source disagree, the TypeScript\ncontract is authoritative.\n\n- Theme guide: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Fblob\u002Fmain\u002Fdocs\u002Ftheme-spec.md\n- Exhaustive ThemeSpec types and allowed values: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Fblob\u002Fmain\u002Fpackages\u002Fflint-js\u002Fsrc\u002Fcore\u002Ftheme\u002Ftypes.ts\n- Real preset implementations: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Ftree\u002Fmain\u002Fpackages\u002Fflint-js\u002Fsrc\u002Fcore\u002Ftheme\u002Fpresets\n- Theme Lab: https:\u002F\u002Fmicrosoft.github.io\u002Fflint-chart\u002F#\u002Ftheme-lab\n\nDo not invent keys. If a requested decision cannot be represented by\n`ThemeSpec`, omit it and briefly identify the unsupported decision outside the\nJSON only when the user asked for an explanation.\n\n## Output contract\n\nUnless the user asks for commentary, return exactly one valid JSON object:\n\n- Return the bare `ThemeSpec`, not `{ \"theme_spec\": ... }` and not a complete\n  `ChartAssemblyInput`.\n- Do not wrap JSON in a Markdown fence.\n- Do not include comments, placeholders, ellipses, or trailing commas.\n- Include a stable kebab-case `id` and a human-readable `label`.\n- Include only supported fields and only decisions justified by the references.\n- Omit unspecified optional fields rather than guessing.\n\nThe top-level output schema is:\n\n```json\n{\n  \"extends\": \"optional-preset-id\",\n  \"id\": \"theme-id\",\n  \"label\": \"Theme label\",\n  \"ink\": {},\n  \"type\": {},\n  \"structure\": {},\n  \"marks\": {},\n  \"labels\": {},\n  \"legend\": {},\n  \"dataLabels\": {},\n  \"annotation\": {},\n  \"furniture\": [],\n  \"facets\": {},\n  \"layout\": {},\n  \"chartDefaults\": {},\n  \"compileDefaults\": {},\n  \"interaction\": {},\n  \"variants\": []\n}\n```\n\nEvery block except `id` and `label` may be omitted. The skeleton shows the\nshape, not a requirement to emit empty blocks.\n\n## Theme boundary\n\nA theme controls presentation and compiler behavior across many charts. It may\ndecide color, typography, surfaces, grids, axes, mark geometry, labels,\nlegends, annotations, density, spacing, facets, and reusable chart defaults.\n\nA theme does not choose data fields, encodings, aggregation, filtering,\nsorting, chart titles, or data values. Never put those decisions in a\n`ThemeSpec`. Outside `chartDefaults`, authored policy must not name a chart\ntype, positional channel, mark type, field, or backend property.\n\n## Workflow\n\n1. Inspect the supplied references. Extract recurring decisions, not isolated\n   decoration from one screenshot.\n2. Ask only for missing decisions that materially affect the theme:\n   identity, required colors, typography, surface\u002Fbackground, density,\n   accessibility constraints, and whether an existing Flint preset is a useful\n   base.\n3. Separate evidence into system roles:\n   - surfaces and text hierarchy;\n   - categorical, sequential, diverging, and status color;\n   - typography roles;\n   - axes, grids, baselines, frames, and structural ink;\n   - mark weight, corners, points, separators, and spacing;\n   - labels, legends, annotations, facets, and layout behavior.\n4. Choose standalone authoring or inheritance.\n5. Author the smallest coherent spec that expresses the system.\n6. Check every key and enum against `types.ts`.\n7. Return the bare JSON object.\n\n## Choosing inheritance\n\nUse `extends` when a built-in preset already supplies the intended compiler\nbehavior and the new theme is a focused variation. Available preset IDs are:\n\n`nyt`, `economist`, `swiss`, `nature`, `mckinsey`, `datawrapper`, `powerbi`,\n`powerbi-light`, `pop`, `cartoon`, `apple`, `de-stijl`, `bbc`, and `material`.\n\nNested objects merge. Arrays and scalar values replace the preset value. If you\nreplace `ink.series.categorical`, also consider replacing\n`categoricalExtended`; otherwise high-cardinality charts may return to the\nbase preset's extended palette.\n\nHow series colour holds up past the palette and on the page:\n\n- Past `categorical` (and `categoricalExtended`), the largest series keep the\n  house inks and the rest take `ink.series.overflow`; with no overflow ink they\n  take a grey derived from `ink.text.muted`. A single extra series keeps its own\n  name. The renderer's default scheme is never used.\n- `ink.series.categoricalText` gives each categorical ink a text variant, used\n  where a series is written in its colour (line-end names, matched values).\n  Without it, an ink under 3:1 against the plot is darkened in its hue for text.\n- `ink.series.minContrast: { fill, stroke }` (defaults 1.25 and 1.6) sets when a\n  faint ink is made visible: fills gain a darker edge, lines darken in hue.\n- `geometry.point.ink` (`series`, `text`, or a colour) sets the ink of a line's\n  vertex dots; by default they take the line's own ink.\n- `ink.series.categoricalByCount: { 2: [...], 3: [...] }` states a set for an\n  exact series count, when the guide publishes one; `ink.series.repeat: true`\n  restarts the palette past its end when the guide says colours repeat.\n- `ink.series.byMark: { line, area, bar, arc, point }` (each `{ single,\n  categorical }`) gives one family of marks its own inks, when the guide does.\n- `ink.series.roles: { other, total, missing }` colours values that play a role\n  (Other, Total, No data) in every chart. Do not put particular values (parties,\n  products) in the theme: those belong to the chart's field annotation\n  `colors`.\n- `ink.series.selection.ordered: \"ramp\"` with `ink.series.ordinal` gives a\n  series whose order the chart declares (`sortOrder`) tints of one ramp.\n- `geometry.area.fill: \"fade\"` and `geometry.line.wash: \"tint\" | \"fade\"`\n  (with `washOpacity`) draw gradient fills; use them only for a guide that\n  shows them.\n- Mark rules stay with their marks: `geometry.area.edge` is a line on areas\n  only; `geometry.band.opacity` and `outlineInk: \"series\"` are for bars;\n  `geometry.band.minLength` keeps a near-zero bar visible;\n  `geometry.point.density` (`countable`, `all`, `sparse`) says which lines keep\n  dots; `geometry.point.shape` (`circle`, `square`, `diamond`, `triangle`,\n  `cross`) is the glyph every dot is drawn as, and `geometry.point.opacity`\n  how opaque (unset, a scatter's dots are 0.7; on a full plot shrunk dots rise\n  toward solid); `geometry.point.halo: { presence, width }` rings a scatter's\n  dots in the plot colour (declare it only where the house's dots carry a ring;\n  a halo and an opacity below 1 are not combined, so declare one or the other);\n  `geometry.arc.order` (`data`, `largestFirst`), `startAngle` and `hole` state\n  pie rules.\n- `marks.redundantChannels: [\"texture\"]` with `marks.texture` draws pattern\n  fills on bars, wedges and areas: `pattern: \"vary\" | \"hatch\"`, or the guide's\n  own order as `patterns` (`solid`, `diagonal`, `antidiagonal`, `horizontal`,\n  `vertical`, `cross`, `dots`), lines `ink: \"darker\" | \"white\"`. Pair it with\n  `redundantEncoding: \"always\"` only when the guide patterns every chart.\n\nType roles take the full weight scale (`thin`, `extralight`, `light`,\n`regular`, `medium`, `semibold`, `bold`, `extrabold`, `black`, or 100–900) and a\n`case` (`upper`, `lower`, `title`, `sentence`, `asIs`) that is applied before\ntext is measured. State the weight the guide names rather than the nearest\nold one. `display` styles a KPI's big number; `annotation` a fitted statistic's\nnote; `footnote` is not drawn by Flint.\n\nFurniture says where it sits and what it is measured against. `canvasTop` is\nthe canvas's own top edge (y = 0, outside the margin) — use it for a house that\nrules the top of the graphic (the Economist's red line, UNHCR's top bar), with\n`frame: \"canvas\"` to run edge to edge or `\"content\"` to stay inside the margin.\n`aboveTitle` is a line over the headline (a wordmark, a logo); `besideTitle`\nsits level with the headline and narrows it; `belowTitle` is a rule over the\nplot block. Logos are `kind: \"image\"` with inline `svg` or a `src`, a size, an\n`alt` and an optional `href`. The figure label itself is the chart's\n`chart_spec.label`; the theme styles it with `type.kicker`.\n\nUse a standalone theme when the reference system does not honestly inherit a\npreset's layout, typography, and presentation behavior.\n\n## Schema map\n\nUse the source contract for exhaustive nested fields and enum values. These are\nthe authored blocks and their jobs:\n\n| Block | Purpose |\n| --- | --- |\n| `ink` | Canvas, plot, panel, text, structural, series, status, and accent colors |\n| `type` | Minimum size and role-based typography for headlines, axes, values, annotations, footnotes, and displays |\n| `structure` | Semantic categorical\u002Fmeasure axes (and `axis.x`\u002F`axis.y` to style the bottom and left axes by side; `placement` takes `opposite`, `leading`\u002F`trailing`, or a screen side), grids, baseline, and frame. `axis.floating` (`omit`, `keep`, `rangeFrame`) says what the axis lines are where the values do not start at zero: a base that is not drawn there, the window's frame, or a frame spanning only the data (Tufte; Vega-Lite only); leave it unset unless the guide says. Each grid, `grid.zero`, `baseline` and `frame` is a presence or `{ presence, style, dash, weight, color }`; a grid may also take `layer: \"front\"` (over the marks). `grid.minor: { presence, divisions, on }` draws finer lines between the labelled ones |\n| `marks` | Band width, strokes, interpolation, opacity, corners, outlines, points, connectors, intervals, summaries, and separators; `group: { gap, spacing }` (also `geometry.band.group`) for grouped bars — the gap between bars in a group and between groups, each a share of a bar's width or `\"Npx\"` |\n| `labels` | Truncation, flush behavior, and the path category names that do not fit their band take. Leave `overflow` unset for the general path: a row of names `wrap` → `rotate90`; a run of times, dates, years or ranks `wrap` → `skip` (round values only) → `rotate90`. Set `overflow` only where the guide asks for something else, e.g. `[\"wrap\", \"rotate45\", \"rotate90\"]` for 45° labels (steps: `wrap`, `skip`, `rotate45`, `rotate90`). Trimming is an add-on to every step, governed by `truncation` (`\"never\"` forbids it). Flint weighs each step whole and trimmed, at every size down to `type.minSize`, and takes the cheapest within the path's order. `fit` holds the thresholds: `minChars` (4), `turnedLimit` (px or `\"40%\"` of plot height), `gap` (em), `rowLimit` (px or % of chart width, for names down y). Names that fit are always flat; a row of names is never thinned |\n| `legend` | Visibility, ordered placement choices, direction, title, swatches (`swatch`: `auto`, `square`, `circle`, `line`), redundancy suppression, and how several keys stand: `arrangement` (`row`\u002F`stack`), `titlePosition` (`above`\u002F`inline`) and `align` (`start`\u002F`center`\u002F`end`\u002F`spread`), preferences the layout keeps unless the keys would overflow |\n| `dataLabels` | Visibility, placement, and ink behavior for values on marks; `anchor` (`end`\u002F`start`\u002F`middle`) for labels inside bars, `fallback` (`perMark`\u002F`allOutside`) when some bars are too short, `minContrast` for the ink inside a bar |\n| `annotation` | Units, axis titles, number formatting, point emphasis, labels, and statistics. `numberFormat.compact` sets number compaction: `style` (k\u002FM\u002FB, K\u002FM\u002FB, k\u002Fm\u002Fb, k\u002Fm\u002Fbn), `per` (`scale`: one unit per axis, or `value`), `threshold`, `on` (`axis`, `labels`) and the semantic `types` it covers; values already in a scale (`m`, `bn`, \"(millions)\") are never compacted |\n| `source` | How a chart's source line reads, when the chart gives one: `leadIn` (and its weight, style, case), `align`, `frame`, a `rule` above it, a house `credit` (`inline`\u002F`end`\u002F`nextLine`); set in `type.footnote` |\n| `furniture` | The header around the title: rules, bands, tabs, wordmarks and logos, placed by `at` (`canvasTop`, `aboveTitle`, `besideTitle`, `belowTitle`) against a `frame` (`canvas`, `content`, `block`) |\n| `facets` | Headers, frames, axis repetition, spacing, columns, and scale sharing |\n| `layout` | Density, target width, title block, and band step |\n| `chartDefaults` | Optional defaults keyed by registered chart type or `*`; caller values still win |\n| `compileDefaults` | Preferred base size, canvas size, and supported assemble options |\n| `interaction` | Tooltip format and semantic selection-boundary paint |\n| `variants` | Conditional policy adaptations; variants may not change `ink` or `type` |\n\n### High-value nested shapes\n\n```json\n{\n  \"ink\": {\n    \"surface\": { \"source\": \"house\", \"canvas\": \"#ffffff\", \"plot\": \"#ffffff\", \"panel\": \"#f5f5f5\" },\n    \"text\": { \"primary\": \"#111111\", \"secondary\": \"#444444\", \"muted\": \"#777777\", \"inverse\": \"#ffffff\" },\n    \"structure\": { \"axis\": \"#222222\", \"grid\": \"#dddddd\", \"frame\": \"#cccccc\", \"rule\": \"#222222\", \"zero\": \"#222222\", \"connector\": \"#888888\" },\n    \"series\": {\n      \"single\": \"#0067b8\",\n      \"categorical\": [\"#0067b8\", \"#d83b01\", \"#107c10\"],\n      \"categoricalExtended\": [\"#0067b8\", \"#d83b01\", \"#107c10\", \"#5c2d91\"],\n      \"overflow\": \"#777777\",\n      \"sequential\": { \"stops\": [\"#e8f3fb\", \"#0067b8\"], \"space\": \"lab\", \"endpointsAgainstSurface\": true },\n      \"diverging\": { \"stops\": [\"#0067b8\", \"#f5f5f5\", \"#d83b01\"], \"neutral\": \"#f5f5f5\", \"space\": \"lab\", \"endpointsAgainstSurface\": true },\n      \"status\": { \"positive\": \"#107c10\", \"negative\": \"#d83b01\", \"neutral\": \"#777777\" }\n    },\n    \"accent\": \"#0067b8\"\n  }\n}\n```\n\n`interaction.selectionBoundary` accepts `color`, `width`, `opacity`, `haloColor`, `haloWidth`, and `haloOpacity`. Omitted paint is grounded from the theme: foreground from `ink.accent` then primary text, and halo from the plot or canvas surface. Use explicit values only when the house has a distinct interaction treatment.\n\nThis is a shape example, not a palette recommendation. Derive actual values\nfrom the user's references.\n\nTypography roles accept `family`, `size`, `weight`, `style`, `case`, and\n`color`. Allowed weights are `regular`, `medium`, `semibold`, and `bold`.\nUse available font families or defensible fallback stacks; do not claim a font\nis available merely because it appears in an image.\n\nPresence-driven policies use `omit`, `hairline`, `quiet`, `full`, or\n`emphasised`. Density uses `compact`, `normal`, or `airy`. Read `types.ts`\nbefore using less common enums.\n\n## Translation guidance\n\n- Map brand neutrals to surfaces, text hierarchy, and structure before mapping\n  accent colors to data series.\n- Treat categorical colors as an ordered identity set. Keep adjacent colors\n  distinguishable and ensure the palette remains legible on the plot surface.\n- Build sequential ramps with ordered lightness. Build diverging ramps around a\n  meaningful neutral. Do not use categorical arrays as numeric ramps.\n- Use status colors only for semantic positive, negative, and neutral meaning.\n- Preserve readable contrast for primary text, axes, labels, and values.\n- Translate recurring geometry into `marks`; do not encode a one-off shape from\n  a single chart as global policy.\n- Prefer semantic structure (`measure` versus `category`) over physical x\u002Fy\n  assumptions.\n- Keep the system coherent across line, bar, area, pie, matrix, distribution,\n  multiseries, and faceted charts.\n- Use `variants` only for real conditional policy and include `because` to state\n  why the adaptation exists.\n\n## Validation checklist\n\nBefore returning the JSON, verify:\n\n- It parses as strict JSON.\n- It is a bare object with `id` and `label`.\n- Every top-level and nested key exists in `types.ts`.\n- Every enum value and value type matches the source contract.\n- It contains no chart data, fields, encodings, titles, or backend JSON.\n- Text and structural ink remain readable against their surfaces.\n- Categorical colors are distinguishable; ramps have ordered lightness and\n  usable endpoints.\n- Inherited arrays are intentionally replaced.\n- The theme expresses reusable rules rather than one chart's decoration.\n- The result can be pasted directly into Flint Theme Lab.\n","# Flint ThemeSpec authoring\n\nCreate a reusable visual system for Flint charts. Translate the user's reference\nmaterials into one valid `ThemeSpec` that can be pasted directly into Theme Lab.\n\n## Authoritative references\n\nRead these before authoring. When prose and source disagree, the TypeScript\ncontract is authoritative.\n\n- Theme guide: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Fblob\u002Fmain\u002Fdocs\u002Ftheme-spec.md\n- Exhaustive ThemeSpec types and allowed values: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Fblob\u002Fmain\u002Fpackages\u002Fflint-js\u002Fsrc\u002Fcore\u002Ftheme\u002Ftypes.ts\n- Real preset implementations: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Ftree\u002Fmain\u002Fpackages\u002Fflint-js\u002Fsrc\u002Fcore\u002Ftheme\u002Fpresets\n- Theme Lab: https:\u002F\u002Fmicrosoft.github.io\u002Fflint-chart\u002F#\u002Ftheme-lab\n\nDo not invent keys. If a requested decision cannot be represented by\n`ThemeSpec`, omit it and briefly identify the unsupported decision outside the\nJSON only when the user asked for an explanation.\n\n## Output contract\n\nUnless the user asks for commentary, return exactly one valid JSON object:\n\n- Return the bare `ThemeSpec`, not `{ \"theme_spec\": ... }` and not a complete\n  `ChartAssemblyInput`.\n- Do not wrap JSON in a Markdown fence.\n- Do not include comments, placeholders, ellipses, or trailing commas.\n- Include a stable kebab-case `id` and a human-readable `label`.\n- Include only supported fields and only decisions justified by the references.\n- Omit unspecified optional fields rather than guessing.\n\nThe top-level output schema is:\n\n```json\n{\n  \"extends\": \"optional-preset-id\",\n  \"id\": \"theme-id\",\n  \"label\": \"Theme label\",\n  \"ink\": {},\n  \"type\": {},\n  \"structure\": {},\n  \"marks\": {},\n  \"labels\": {},\n  \"legend\": {},\n  \"dataLabels\": {},\n  \"annotation\": {},\n  \"furniture\": [],\n  \"facets\": {},\n  \"layout\": {},\n  \"chartDefaults\": {},\n  \"compileDefaults\": {},\n  \"interaction\": {},\n  \"variants\": []\n}\n```\n\nEvery block except `id` and `label` may be omitted. The skeleton shows the\nshape, not a requirement to emit empty blocks.\n\n## Theme boundary\n\nA theme controls presentation and compiler behavior across many charts. It may\ndecide color, typography, surfaces, grids, axes, mark geometry, labels,\nlegends, annotations, density, spacing, facets, and reusable chart defaults.\n\nA theme does not choose data fields, encodings, aggregation, filtering,\nsorting, chart titles, or data values. Never put those decisions in a\n`ThemeSpec`. Outside `chartDefaults`, authored policy must not name a chart\ntype, positional channel, mark type, field, or backend property.\n\n## Workflow\n\n1. Inspect the supplied references. Extract recurring decisions, not isolated\n   decoration from one screenshot.\n2. Ask only for missing decisions that materially affect the theme:\n   identity, required colors, typography, surface\u002Fbackground, density,\n   accessibility constraints, and whether an existing Flint preset is a useful\n   base.\n3. Separate evidence into system roles:\n   - surfaces and text hierarchy;\n   - categorical, sequential, diverging, and status color;\n   - typography roles;\n   - axes, grids, baselines, frames, and structural ink;\n   - mark weight, corners, points, separators, and spacing;\n   - labels, legends, annotations, facets, and layout behavior.\n4. Choose standalone authoring or inheritance.\n5. Author the smallest coherent spec that expresses the system.\n6. Check every key and enum against `types.ts`.\n7. Return the bare JSON object.\n\n## Choosing inheritance\n\nUse `extends` when a built-in preset already supplies the intended compiler\nbehavior and the new theme is a focused variation. Available preset IDs are:\n\n`nyt`, `economist`, `swiss`, `nature`, `mckinsey`, `datawrapper`, `powerbi`,\n`powerbi-light`, `pop`, `cartoon`, `apple`, `de-stijl`, `bbc`, and `material`.\n\nNested objects merge. Arrays and scalar values replace the preset value. If you\nreplace `ink.series.categorical`, also consider replacing\n`categoricalExtended`; otherwise high-cardinality charts may return to the\nbase preset's extended palette.\n\nHow series colour holds up past the palette and on the page:\n\n- Past `categorical` (and `categoricalExtended`), the largest series keep the\n  house inks and the rest take `ink.series.overflow`; with no overflow ink they\n  take a grey derived from `ink.text.muted`. A single extra series keeps its own\n  name. The renderer's default scheme is never used.\n- `ink.series.categoricalText` gives each categorical ink a text variant, used\n  where a series is written in its colour (line-end names, matched values).\n  Without it, an ink under 3:1 against the plot is darkened in its hue for text.\n- `ink.series.minContrast: { fill, stroke }` (defaults 1.25 and 1.6) sets when a\n  faint ink is made visible: fills gain a darker edge, lines darken in hue.\n- `geometry.point.ink` (`series`, `text`, or a colour) sets the ink of a line's\n  vertex dots; by default they take the line's own ink.\n- `ink.series.categoricalByCount: { 2: [...], 3: [...] }` states a set for an\n  exact series count, when the guide publishes one; `ink.series.repeat: true`\n  restarts the palette past its end when the guide says colours repeat.\n- `ink.series.byMark: { line, area, bar, arc, point }` (each `{ single,\n  categorical }`) gives one family of marks its own inks, when the guide does.\n- `ink.series.roles: { other, total, missing }` colours values that play a role\n  (Other, Total, No data) in every chart. Do not put particular values (parties,\n  products) in the theme: those belong to the chart's field annotation\n  `colors`.\n- `ink.series.selection.ordered: \"ramp\"` with `ink.series.ordinal` gives a\n  series whose order the chart declares (`sortOrder`) tints of one ramp.\n- `geometry.area.fill: \"fade\"` and `geometry.line.wash: \"tint\" | \"fade\"`\n  (with `washOpacity`) draw gradient fills; use them only for a guide that\n  shows them.\n- Mark rules stay with their marks: `geometry.area.edge` is a line on areas\n  only; `geometry.band.opacity` and `outlineInk: \"series\"` are for bars;\n  `geometry.band.minLength` keeps a near-zero bar visible;\n  `geometry.point.density` (`countable`, `all`, `sparse`) says which lines keep\n  dots; `geometry.point.shape` (`circle`, `square`, `diamond`, `triangle`,\n  `cross`) is the glyph every dot is drawn as, and `geometry.point.opacity`\n  how opaque (unset, a scatter's dots are 0.7; on a full plot shrunk dots rise\n  toward solid); `geometry.point.halo: { presence, width }` rings a scatter's\n  dots in the plot colour (declare it only where the house's dots carry a ring;\n  a halo and an opacity below 1 are not combined, so declare one or the other);\n  `geometry.arc.order` (`data`, `largestFirst`), `startAngle` and `hole` state\n  pie rules.\n- `marks.redundantChannels: [\"texture\"]` with `marks.texture` draws pattern\n  fills on bars, wedges and areas: `pattern: \"vary\" | \"hatch\"`, or the guide's\n  own order as `patterns` (`solid`, `diagonal`, `antidiagonal`, `horizontal`,\n  `vertical`, `cross`, `dots`), lines `ink: \"darker\" | \"white\"`. Pair it with\n  `redundantEncoding: \"always\"` only when the guide patterns every chart.\n\nType roles take the full weight scale (`thin`, `extralight`, `light`,\n`regular`, `medium`, `semibold`, `bold`, `extrabold`, `black`, or 100–900) and a\n`case` (`upper`, `lower`, `title`, `sentence`, `asIs`) that is applied before\ntext is measured. State the weight the guide names rather than the nearest\nold one. `display` styles a KPI's big number; `annotation` a fitted statistic's\nnote; `footnote` is not drawn by Flint.\n\nFurniture says where it sits and what it is measured against. `canvasTop` is\nthe canvas's own top edge (y = 0, outside the margin) — use it for a house that\nrules the top of the graphic (the Economist's red line, UNHCR's top bar), with\n`frame: \"canvas\"` to run edge to edge or `\"content\"` to stay inside the margin.\n`aboveTitle` is a line over the headline (a wordmark, a logo); `besideTitle`\nsits level with the headline and narrows it; `belowTitle` is a rule over the\nplot block. Logos are `kind: \"image\"` with inline `svg` or a `src`, a size, an\n`alt` and an optional `href`. The figure label itself is the chart's\n`chart_spec.label`; the theme styles it with `type.kicker`.\n\nUse a standalone theme when the reference system does not honestly inherit a\npreset's layout, typography, and presentation behavior.\n\n## Schema map\n\nUse the source contract for exhaustive nested fields and enum values. These are\nthe authored blocks and their jobs:\n\n| Block | Purpose |\n| --- | --- |\n| `ink` | Canvas, plot, panel, text, structural, series, status, and accent colors |\n| `type` | Minimum size and role-based typography for headlines, axes, values, annotations, footnotes, and displays |\n| `structure` | Semantic categorical\u002Fmeasure axes (and `axis.x`\u002F`axis.y` to style the bottom and left axes by side; `placement` takes `opposite`, `leading`\u002F`trailing`, or a screen side), grids, baseline, and frame. `axis.floating` (`omit`, `keep`, `rangeFrame`) says what the axis lines are where the values do not start at zero: a base that is not drawn there, the window's frame, or a frame spanning only the data (Tufte; Vega-Lite only); leave it unset unless the guide says. Each grid, `grid.zero`, `baseline` and `frame` is a presence or `{ presence, style, dash, weight, color }`; a grid may also take `layer: \"front\"` (over the marks). `grid.minor: { presence, divisions, on }` draws finer lines between the labelled ones |\n| `marks` | Band width, strokes, interpolation, opacity, corners, outlines, points, connectors, intervals, summaries, and separators; `group: { gap, spacing }` (also `geometry.band.group`) for grouped bars — the gap between bars in a group and between groups, each a share of a bar's width or `\"Npx\"` |\n| `labels` | Truncation, flush behavior, and the path category names that do not fit their band take. Leave `overflow` unset for the general path: a row of names `wrap` → `rotate90`; a run of times, dates, years or ranks `wrap` → `skip` (round values only) → `rotate90`. Set `overflow` only where the guide asks for something else, e.g. `[\"wrap\", \"rotate45\", \"rotate90\"]` for 45° labels (steps: `wrap`, `skip`, `rotate45`, `rotate90`). Trimming is an add-on to every step, governed by `truncation` (`\"never\"` forbids it). Flint weighs each step whole and trimmed, at every size down to `type.minSize`, and takes the cheapest within the path's order. `fit` holds the thresholds: `minChars` (4), `turnedLimit` (px or `\"40%\"` of plot height), `gap` (em), `rowLimit` (px or % of chart width, for names down y). Names that fit are always flat; a row of names is never thinned |\n| `legend` | Visibility, ordered placement choices, direction, title, swatches (`swatch`: `auto`, `square`, `circle`, `line`), redundancy suppression, and how several keys stand: `arrangement` (`row`\u002F`stack`), `titlePosition` (`above`\u002F`inline`) and `align` (`start`\u002F`center`\u002F`end`\u002F`spread`), preferences the layout keeps unless the keys would overflow |\n| `dataLabels` | Visibility, placement, and ink behavior for values on marks; `anchor` (`end`\u002F`start`\u002F`middle`) for labels inside bars, `fallback` (`perMark`\u002F`allOutside`) when some bars are too short, `minContrast` for the ink inside a bar |\n| `annotation` | Units, axis titles, number formatting, point emphasis, labels, and statistics. `numberFormat.compact` sets number compaction: `style` (k\u002FM\u002FB, K\u002FM\u002FB, k\u002Fm\u002Fb, k\u002Fm\u002Fbn), `per` (`scale`: one unit per axis, or `value`), `threshold`, `on` (`axis`, `labels`) and the semantic `types` it covers; values already in a scale (`m`, `bn`, \"(millions)\") are never compacted |\n| `source` | How a chart's source line reads, when the chart gives one: `leadIn` (and its weight, style, case), `align`, `frame`, a `rule` above it, a house `credit` (`inline`\u002F`end`\u002F`nextLine`); set in `type.footnote` |\n| `furniture` | The header around the title: rules, bands, tabs, wordmarks and logos, placed by `at` (`canvasTop`, `aboveTitle`, `besideTitle`, `belowTitle`) against a `frame` (`canvas`, `content`, `block`) |\n| `facets` | Headers, frames, axis repetition, spacing, columns, and scale sharing |\n| `layout` | Density, target width, title block, and band step |\n| `chartDefaults` | Optional defaults keyed by registered chart type or `*`; caller values still win |\n| `compileDefaults` | Preferred base size, canvas size, and supported assemble options |\n| `interaction` | Tooltip format and semantic selection-boundary paint |\n| `variants` | Conditional policy adaptations; variants may not change `ink` or `type` |\n\n### High-value nested shapes\n\n```json\n{\n  \"ink\": {\n    \"surface\": { \"source\": \"house\", \"canvas\": \"#ffffff\", \"plot\": \"#ffffff\", \"panel\": \"#f5f5f5\" },\n    \"text\": { \"primary\": \"#111111\", \"secondary\": \"#444444\", \"muted\": \"#777777\", \"inverse\": \"#ffffff\" },\n    \"structure\": { \"axis\": \"#222222\", \"grid\": \"#dddddd\", \"frame\": \"#cccccc\", \"rule\": \"#222222\", \"zero\": \"#222222\", \"connector\": \"#888888\" },\n    \"series\": {\n      \"single\": \"#0067b8\",\n      \"categorical\": [\"#0067b8\", \"#d83b01\", \"#107c10\"],\n      \"categoricalExtended\": [\"#0067b8\", \"#d83b01\", \"#107c10\", \"#5c2d91\"],\n      \"overflow\": \"#777777\",\n      \"sequential\": { \"stops\": [\"#e8f3fb\", \"#0067b8\"], \"space\": \"lab\", \"endpointsAgainstSurface\": true },\n      \"diverging\": { \"stops\": [\"#0067b8\", \"#f5f5f5\", \"#d83b01\"], \"neutral\": \"#f5f5f5\", \"space\": \"lab\", \"endpointsAgainstSurface\": true },\n      \"status\": { \"positive\": \"#107c10\", \"negative\": \"#d83b01\", \"neutral\": \"#777777\" }\n    },\n    \"accent\": \"#0067b8\"\n  }\n}\n```\n\n`interaction.selectionBoundary` accepts `color`, `width`, `opacity`, `haloColor`, `haloWidth`, and `haloOpacity`. Omitted paint is grounded from the theme: foreground from `ink.accent` then primary text, and halo from the plot or canvas surface. Use explicit values only when the house has a distinct interaction treatment.\n\nThis is a shape example, not a palette recommendation. Derive actual values\nfrom the user's references.\n\nTypography roles accept `family`, `size`, `weight`, `style`, `case`, and\n`color`. Allowed weights are `regular`, `medium`, `semibold`, and `bold`.\nUse available font families or defensible fallback stacks; do not claim a font\nis available merely because it appears in an image.\n\nPresence-driven policies use `omit`, `hairline`, `quiet`, `full`, or\n`emphasised`. Density uses `compact`, `normal`, or `airy`. Read `types.ts`\nbefore using less common enums.\n\n## Translation guidance\n\n- Map brand neutrals to surfaces, text hierarchy, and structure before mapping\n  accent colors to data series.\n- Treat categorical colors as an ordered identity set. Keep adjacent colors\n  distinguishable and ensure the palette remains legible on the plot surface.\n- Build sequential ramps with ordered lightness. Build diverging ramps around a\n  meaningful neutral. Do not use categorical arrays as numeric ramps.\n- Use status colors only for semantic positive, negative, and neutral meaning.\n- Preserve readable contrast for primary text, axes, labels, and values.\n- Translate recurring geometry into `marks`; do not encode a one-off shape from\n  a single chart as global policy.\n- Prefer semantic structure (`measure` versus `category`) over physical x\u002Fy\n  assumptions.\n- Keep the system coherent across line, bar, area, pie, matrix, distribution,\n  multiseries, and faceted charts.\n- Use `variants` only for real conditional policy and include `because` to state\n  why the adaptation exists.\n\n## Validation checklist\n\nBefore returning the JSON, verify:\n\n- It parses as strict JSON.\n- It is a bare object with `id` and `label`.\n- Every top-level and nested key exists in `types.ts`.\n- Every enum value and value type matches the source contract.\n- It contains no chart data, fields, encodings, titles, or backend JSON.\n- Text and structural ink remain readable against their surfaces.\n- Categorical colors are distinguishable; ramps have ordered lightness and\n  usable endpoints.\n- Inherited arrays are intentionally replaced.\n- The theme expresses reusable rules rather than one chart's decoration.\n- The result can be pasted directly into Flint Theme Lab.\n",{"name":5,"description":7},"main","a794557384adcc3293a77043f6b9aff1c33d152c","agent-skills\u002Fflint-theme-author",267,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart","https:\u002F\u002Fmicrosoft.github.io\u002Fflint-chart\u002F","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-10 13:52:42",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add microsoft\u002Fflint-chart --skill flint-theme-author",{"tool":54,"command":55},"bunx","bunx skills add microsoft\u002Fflint-chart --skill flint-theme-author",{"tool":57,"command":58},"pnpm","pnpm dlx skills add microsoft\u002Fflint-chart --skill flint-theme-author","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Fblob\u002Fmain\u002Fagent-skills\u002Fflint-theme-author\u002FSKILL.md",true,[],[63,80,99,111],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":75,"publishedAt":33},"01M69AXPYV1F85RNSJM8FC9SXN","flint-interaction-author","Use when: a Flint chart should respond to the reader (highlight, zoom, brush, legend toggle, reorder, annotate, explore, link charts); an application or an agent changes a mounted chart from outside or reads what it shows; or a gesture no preset gives must be built. Produce one valid interaction_spec, one ChartUpdate, or code against flint-chart\u002Finteractive, with no invented names.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Fblob\u002Fmain\u002Fagent-skills\u002Fflint-interaction-author\u002FSKILL.md",[69,72],{"categoryNo":70,"categoryName":71,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000013","分析与可视化",{"categoryNo":73,"categoryName":74,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[76,77,78,79],"flint interaction author","spec","valid","preset",{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":94,"publishedAt":33},"01M69AXMC64Z7NCCRZKFENZ1AE","flint-chart-author","Use when: the user asks to make or render charts with flint-chart, visualize tabular data, generate a ChartAssemblyInput, validate\u002Frender through MCP, or add Flint to a JS\u002FTS project. Author the semantic spec, transform data before Flint when needed, install\u002Fimport Flint only when executable code is needed, and reserve backend-specific style tweaks for after compiling from Flint.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Fblob\u002Fmain\u002Fagent-skills\u002Fflint-chart-author\u002FSKILL.md",[86,89,90,91],{"categoryNo":87,"categoryName":88,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":70,"categoryName":71,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":73,"categoryName":74,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":92,"categoryName":93,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000033","数据分析师",[95,96,77,97,98],"flint chart author","MCP","visualize","validate",{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":107,"publishedAt":33},"01M69AXHW6ENKKHP24X54B9KT4","flint-board-author","Use when: several Flint charts should be read together in one view: a dashboard, KPI tiles over a trend, a side-by-side comparison, an overview with its detail; or a board on screen should change (add, retitle, resize, reconnect a chart). Produce one board spec whose headline, chart choice, layout and connected fields are decided, check and refine it with validate_board, then put it on screen once with show.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Fblob\u002Fmain\u002Fagent-skills\u002Fflint-board-author\u002FSKILL.md",[105,106],{"categoryNo":70,"categoryName":71,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":92,"categoryName":93,"taxonomyType":26,"taxonomyTypeDesc":27},[108,77,109,110,98],"flint board author","dashboard","change",{"skillNo":112,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":119,"publishedAt":33},"01M69AXEZX3YWNKXJ5Y5P76B0W","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fflint-chart\u002Fblob\u002Fmain\u002F.github\u002Fextensions\u002Fflint-chart\u002Fskills\u002Fflint-chart-author\u002FSKILL.md",[115,116,117,118],{"categoryNo":87,"categoryName":88,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":70,"categoryName":71,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":73,"categoryName":74,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":92,"categoryName":93,"taxonomyType":26,"taxonomyTypeDesc":27},[95,98,96,97,77]]