- name
SKILL.md
O arquivo da skill permanece no repositório do publicador.
Cole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add arla6ka/design.how --skill sodium -a cursor -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add arla6ka/design.how --skill sodium -a claude-code -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add arla6ka/design.how --skill sodium -a codex -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add arla6ka/design.how --skill sodium -a grok -yEnvie a mensagem copiada em um chat do Grok Bot. O Bot busca este SKILL.md no GitHub e o adiciona às skills que todos os seus Bots compartilham.
Install this skill: https://github.com/arla6ka/design.how/tree/HEAD/systems/sodiumDo publicador
Sodium is compact and ruled, for infrastructure and data tools: white and warm near-black grounds, 1px rules for structure, mono capitals for every interface word, Inter Display for headlines and prose, zero radius, and one sodium yellow for the thing to act on. Build with its recipes and components before writing markup.
Once, in the root layout: put the "sodium" class on <body> or the root element of the UI, with SodiumPortalProvider inside it. Sodium's styles and tokens apply only inside that class.
Menus, dialogs, popovers and toasts render at the end of the body; SodiumPortalProvider keeps them inside the scope, and without it they lose every token. import {SodiumPortalProvider} from '@/lib/sodium/portal'
<body className="sodium"><SodiumPortalProvider>{children}</SodiumPortalProvider></body>
npx shadcn@latest add https://design.how/r/sodium/lint.json, then run npx eslint -c sodium.eslint.config.mjs .. Each message names the fix.When rules conflict, the earlier item wins.
import {Button} from '@/components/sodium/ui/button'<div className="sodium"><SodiumPortalProvider>{children}</SodiumPortalProvider></div><p className="text-text-2"><p className="text-[#55524a]"><Button variant="secondary">Keep</Button><Button>Run</Button><Button>Keep</Button><Button>Run</Button><span className="text-accent-text">Running</span><span className="text-accent-fill">Running</span><span className="type-label-sm">Queued</span><span className="uppercase">Queued</span><main><div className="frame"><div className="rule-row"><main className="dots"><div className="frame"><div className="frame"><Button>Run pipeline</Button><Button>OK</Button>Every screen sits in this frame.
<div className="sodium min-h-dvh bg-page text-text-1"> with SodiumPortalProvider inside it<section className="frame"> with a panel-head row and parts divided by rule-row or rule-coltype-micro label over a type-code value<h1 className="type-title">, one per pageToolCallStack beside or under the frame, never inside itw-full max-w-sm, sized to its content, with no device frame; its one slab sits in a row of ButtonsThe habits of generated UI that Sodium bans. Details: https://design.how/systems/sodium/foundations/anti-slop.md
<main className="dots min-h-dvh"><h1 className="text-ok-text">> pipelines_</h1><div className="bg-linear-to-br from-page to-well backdrop-blur"><div className="frame rounded-xl"><header className="bg-accent-fill"><div className="grid grid-cols-4 gap-4"><div className="frame">…</div>…</div><div className="frame"><div className="frame"><div className="border-s-4 border-accent-edge">import {useOverlayOpen, overlayModel, overlayOpenChanged, overlayMayClose, overlayRunStarted, overlayRunSettled, isThenable, closesAfter, useDefaultAction, useScrollBody, overlaySurface, overlayModal, overlayMotion, overlayHeaderClass, overlayTitleClass, overlayHeadMetaClass, overlayBodyClass, overlayDescriptionClass, overlayFooterClass, overlayMetaClass, overlayErrorClass, scrimClass, menuPopupClass, menuVarsClass, menuItemClass, menuCheckItemClass, menuLabelClass, menuSeparatorClass, menuShortcutClass, optionItemClass, optionCheckClass} from '@/lib/sodium/overlay': What every overlay shares: the edged panel surface, the way it arrives, and the list rows of selects, comboboxes and menus.import {useScrollTabStop, findAll} from '@/lib/sodium/scroll': Support file: the tab stop a scrolling data region takes while it overflows, and the case-free search matcher.import {motionDefaults, parseDuration, easeOut, useMotionToken, useTimeline} from '@/hooks/sodium/use-timeline': The frame clock under Sodium's typing, scrambles and connectors: deterministic given a clock, final at once under reduced motion.import {typedAt, firstChars, useTyping} from '@/hooks/sodium/use-typing': Types text in at about 55 characters a second behind a caret shown only while typing.import {scrambleGlyphs, scrambleTick, hash, scrambleAt, useScramble} from '@/hooks/sodium/use-scramble': Resolves a mono label through glyphs in about 0.4 seconds.import {drawAt, useDraw} from '@/hooks/sodium/use-draw': Draws connectors out one hop at a time, about 0.3 seconds a hop.import {controlHeight, reducedMotion, cn, mergeClass, mergeRefs} from '@/lib/sodium/utils': cn, which merges class names and resolves conflicts between Sodium's type roles and button surfaces; mergeClass, which keeps Sodium's classes when a caller passes a className function; mergeRefs; and controlHeight, the one height formula for one-line controls.import {Icon} from '@/components/sodium/icon': The one import point for icons: Lucide, squared off with square ends, mitred joins and a 1.25px line.import {SodiumPortalProvider, useSodiumPortal, useSodiumModal, cycleTab, coarsePointer} from '@/lib/sodium/portal': Puts overlays inside the .sodium scope so they keep its tokens, and makes the page inert behind a modal.import {SodiumDirection, useDomDirection} from '@/lib/sodium/direction': Hands the reading direction to Base UI and to popups opened from a right-to-left subtree.Import a glyph beside Icon from the path under Imports and pass it in: <Icon icon={Activity} size={16}/>. These are all the names; another needs adding to that file first.
Activity, Add, ArrowDown, ArrowLeft, ArrowRight, ArrowUp, ArrowUpRight, Branch, Calendar, Checkmark, ChevronDown, ChevronLeft, ChevronRight, ChevronSort, ChevronUp, Chip, Close, Code, Copy, Cube, DataBase, DataTable, Document, Download, Edit, ErrorOutline, Filter, Flow, Folder, Information, Launch, Lightning, Locked, Meter, Moon, OverflowMenuHorizontal, Pause, Play, Renew, Search, ServerDns, Settings, StopOutline, Subtract, Sun, Terminal, Time, TrashCan, Undo, Upload, View, ViewOff, WarningAlt, ArrowsHorizontal, CollapseAll, ExpandAll, Misuse, TextWrap
The closed list. Use a token through its class, never a raw value: colors are utilities named after the role (bg-code-surface, text-text-1, border-line-faint); sizes read the scale (type-body, rounded-4xl, h-(--control-lg), duration-(--dur-press)). The class to use follows each token in brackets. Color names take bg-, text- or border-. A token with no class is read as a value, such as h-(--name).
import {Button, buttonVariants} from '@/components/sodium/ui/button'import {ButtonGroup, ButtonGroupMenu, ButtonGroupSeparator, ButtonGroupText, buttonGroupVariants} from '@/components/sodium/ui/button-group'import {CopyButton} from '@/components/sodium/ui/copy-button'import {Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, Form, FormActions, FormStatus, Label, LabelHint, labelClasses, useFieldDisabled} from '@/components/sodium/ui/field'import {Input, InputAction, InputControl, InputLeading, InputPending, InputRoot, InputTrailing} from '@/components/sodium/ui/input'import {Textarea} from '@/components/sodium/ui/textarea'import {Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, NativeSelect, fieldTriggerClass, fieldTriggerSize} from '@/components/sodium/ui/select'import {Combobox, ComboboxChip, ComboboxChips, ComboboxChipsInput, ComboboxClear, ComboboxCollection, ComboboxContent, ComboboxCreate, ComboboxEmpty, ComboboxField, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxLabel, ComboboxList, ComboboxSeparator, ComboboxTrigger, ComboboxValue, normalizeEmail, splitEmails, validateEmail, useComboboxAnchor} from '@/components/sodium/ui/combobox'import {Checkbox, CheckboxGroup} from '@/components/sodium/ui/checkbox'import {RadioGroup, RadioGroupItem, RadioGroupOption} from '@/components/sodium/ui/radio-group'import {Switch} from '@/components/sodium/ui/switch'import {Slider} from '@/components/sodium/ui/slider'import {SegmentedControl, SegmentedControlItem, segmentedVariants} from '@/components/sodium/ui/segmented-control'import {Tag, tagVariants} from '@/components/sodium/ui/tag'import {StatusStrip, StatusStripCell, StatusStripLabel, StatusStripValue, StatusStripUnit, stripVariants} from '@/components/sodium/ui/status-strip'import {Avatar, AvatarImage, AvatarFallback, AvatarGroup, avatarVariants, initialsOf} from '@/components/sodium/ui/avatar'import {Kbd, KbdGroup, shortcut} from '@/components/sodium/ui/kbd'import {Item, ItemGroup, ItemMedia, ItemContent, ItemTitle, ItemDescription, ItemMeta, ItemLink, ItemActions, itemVariants, itemGroupVariants} from '@/components/sodium/ui/item'import {DataList, DataListItem, DataListLabel, DataListValue, DataListEmpty, dataListVariants} from '@/components/sodium/ui/data-list'import {Status, StatusMark, statusVariants, statuses, statusLabels, statusRank} from '@/components/sodium/ui/status' import {RunningMark} from '@/components/sodium/ui/running-mark'import {Meter, MeterLabel, MeterValue, MeterStack, meterStatus} from '@/components/sodium/ui/meter'import {Progress, ProgressLabel, ProgressValue} from '@/components/sodium/ui/progress'import {Alert, AlertTitle, AlertDescription, AlertAction, AlertClose, alertVariants} from '@/components/sodium/ui/alert'import {Toaster, toast, toastManager, readingTimeout} from '@/components/sodium/ui/toast'import {Empty, EmptyIcon, EmptyHeader, EmptyTitle, EmptyDescription, EmptyContent, EmptyCode, EmptyRetry, emptyVariants} from '@/components/sodium/ui/empty-state'import {Skeleton, SkeletonText, SkeletonRows, SkeletonSwap} from '@/components/sodium/ui/skeleton'import {Dialog, DialogTrigger, DialogPortal, DialogOverlay, DialogContent, DialogHeader, DialogBody, DialogFooter, DialogTitle, DialogDescription, DialogClose, DialogAction, DialogConfirmField, dialogVariants, useDialog} from '@/components/sodium/ui/dialog'import {Sheet, SheetTrigger, SheetClose, SheetPortal, SheetOverlay, SheetContent, SheetHeader, SheetBody, SheetFooter, SheetTitle, SheetDescription, SheetAction, SheetSection, SheetField, useSheet} from '@/components/sodium/ui/sheet'import {Popover, PopoverTrigger, PopoverClose, PopoverContent, PopoverHeader, PopoverTitle, PopoverDescription, PopoverInfo} from '@/components/sodium/ui/popover'import {Tooltip, TooltipTrigger, TooltipContent, TooltipChip, TooltipProvider, TooltipShortcut, tooltipPopupClass, tooltipMotionClass} from '@/components/sodium/ui/tooltip'import {DropdownMenu, DropdownMenuPortal, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuItem, DropdownMenuLinkItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent} from '@/components/sodium/ui/dropdown-menu'import {Command, CommandDialog, CommandInput, CommandList, CommandEmpty, CommandLoading, CommandGroup, CommandItem, CommandLabel, CommandShortcut, CommandSeparator, CommandFooter, CommandHint, useCommand} from '@/components/sodium/ui/command'import {Tabs, TabsList, TabsTrigger, TabsContent, TabsCount, tabsListVariants, tabBase, useActiveInView} from '@/components/sodium/ui/tabs'import {NumberedTabs, NumberedTabsList, NumberedTabsTrigger, NumberedTabsContent, NumberedTabsPanels} from '@/components/sodium/ui/numbered-tabs'import {Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, BreadcrumbEllipsis, BreadcrumbValue, BreadcrumbTrail} from '@/components/sodium/ui/breadcrumb'import {Pagination, PaginationContent, PaginationItem, PaginationLink, PaginationPrevious, PaginationNext, PaginationEllipsis, PaginationInfo, PaginationNav, paginationRange} from '@/components/sodium/ui/pagination'import {Collapsible, CollapsibleGroup, CollapsibleTrigger, CollapsibleCaret, CollapsibleContent} from '@/components/sodium/ui/collapsible'import {Frame, FrameHeader, FrameTitle, FrameStatus, FrameValue, FrameActions, FrameBody, FrameDescription, FrameFooter, FrameMeta, frameVariants} from '@/components/sodium/ui/frame'import {Table, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCell, TableCaption, TableEmpty, TableLoading, TableTitle, TableToolbar, TableSortButton, TableRowActions, TableRowAction, tableClassName, bodyClassName, rowClassName, headClassName, cellClassName} from '@/components/sodium/ui/table'import {FilterBar, FilterBarSearch, FilterToggle, FilterBarSelect, FilterBarClear, FilterBarCount, useFilteredRows} from '@/components/sodium/ui/filter-bar'import {CodeBlock, TokenLine, WrapToggle, tokenize, parseLines, commandLines, maskSecret, gutterStyle, maxLinesStyle, matchClass, currentMatchClass, languageLabels} from '@/components/sodium/ui/code-block'import {CodeWindow} from '@/components/sodium/ui/code-window'import {JsonView, pathOf} from '@/components/sodium/ui/json-view'import {LogViewer} from '@/components/sodium/ui/log-viewer'import {Chart, ChartFrame, ChartPlot, LineChart, ChartContainer, WithChart, useChart, useOptionalChart, useElementWidth, useElementDirection, useRovingPoints, useDrawn, seriesTone, ChartSwatch, ChartTooltip, ChartTooltipContent, ChartTooltipRow, ChartDataTable, ChartLegend, niceScale, tickCount, formatCompact, formatExact, unitFormat, numberAt, linearPath, stepPath, wipeStyle, drawStyle} from '@/components/sodium/ui/chart' import {toneClass, toneFill, toneArea} from '@/components/sodium/ui/chart-parts' import {EMPTY_VALUE, CHART_EMPTY} from '@/components/sodium/ui/chart-scale'import {StemChart} from '@/components/sodium/ui/stem-chart'import {Swimlanes, stepVariants} from '@/components/sodium/ui/swimlanes'import {BarBlocks, blockVariants} from '@/components/sodium/ui/bar-blocks'import {ToolCallStack, ToolCallRow, formatElapsed, stepWords} from '@/components/sodium/ai/tool-call-row'import {ToolCall, ToolCallList, toolCallsReducer, useToolCalls, registerTool, resolveTool, isTerminal, cleanOutput} from '@/components/sodium/ai/tool-call'import {Activity, pastTense} from '@/components/sodium/ai/activity'import {PromptInput} from '@/components/sodium/ai/prompt-input'import {Message, MessageGroup, MessageDivider} from '@/components/sodium/ai/message'import {Response, usePacedText, splitChunks, parseMarkdown, closeDangling, nextCut, paceStep, safeHref} from '@/components/sodium/ai/response'Whole screens built only from the components above. Each installs to the blocks folder beside them.
npx shadcn@latest add https://design.how/r/sodium/job-runs.json import {JobRuns} from '@/components/sodium/blocks/job-runs'npx shadcn@latest add https://design.how/r/sodium/failed-load.json import {FailedLoad} from '@/components/sodium/blocks/failed-load'npx shadcn@latest add https://design.how/r/sodium/on-call.json import {OnCall} from '@/components/sodium/blocks/on-call'npx shadcn@latest add https://design.how/r/sodium/run-progress.json import {RunProgress} from '@/components/sodium/blocks/run-progress'npx shadcn@latest add https://design.how/r/sodium/warehouse-capacity.json import {WarehouseCapacity} from '@/components/sodium/blocks/warehouse-capacity'npx shadcn@latest add https://design.how/r/sodium/sync-flow.json import {SyncFlow} from '@/components/sodium/blocks/sync-flow'npx shadcn@latest add https://design.how/r/sodium/pipeline-history.json import {PipelineHistory} from '@/components/sodium/blocks/pipeline-history'npx shadcn@latest add https://design.how/r/sodium/<name>.json, the name being the last part of its page link.
Sodium design system rules for this project's UI. Use when building or changing any screen, component, form or style, when porting an existing screen onto Sodium, or when checking UI against Sodium.
---name: sodiumdescription: Sodium design system rules for this project's UI. Use when building or changing any screen, component, form or…---# systems/sodium/SKILL.mdPerguntas frequentes
Baixe systems/sodium/SKILL.md do publicador ou copie o caminho e abra o repositório. O PlugMCP lista a skill e não hospeda o arquivo.
O publicador o mantém em https://github.com/arla6ka/design.how.
Claude, Cursor, Codex e Grok Build conseguem ler um SKILL.md que você adiciona a partir do repositório do publicador. O Grok Bot o instala quando você envia em um chat o link da pasta da skill no GitHub.
<div className="frame"><div className="frame rounded-lg"><span className="size-2 rounded-full bg-ok"/> Passed<p className="type-label">Overview</p><h2 className="type-heading">Runs</h2><p className="type-label">The backfill wrote 1,204 partitions.</p><Button>Deploy 🚀</Button>Blazing-fast pipelines.<span className="caret animate-[blink_1s_steps(1)_infinite]"/><motion.section whileInView={{opacity: 1}}>