Community编程与开发github.com

cbrock84/interface-craft

提升界面的视觉和交互质量——布局、层级、排版、间距、密度,以及那些将深思熟虑的产品与普通产品区分开来的细节。当界面功能正常但看起来未完成或默认化,当布局显得拥挤或随意,当页面没有清晰的视觉焦点,或者当界面需要让人感到值得信赖而不仅仅是功能可用时,使用这个技能。

interface-craft 是什么?

这个技能专注于提升用户界面的视觉和交互质量,解决那些让界面看起来“差不多”但未达到专业水平的细微缺陷。它强调在重新设计样式之前先进行诊断:明确屏幕的主要目的,并确定唯一的首要交互,这是解决布局问题的前提,因为如果无法定义首要操作,那么再多的样式调整也无法解决根本的产品问题。技能详细介绍了真正构成视觉质量的要素——层级、间距韵律、排版、表面克制和对齐——并指出每个要素的具体实践方法。它还涵盖了密度决策、状态处理(加载、空状态、错误、溢出)以及深色模式的正确实现方式(作为调色板而非简单的反转)。最后,它设定了可访问性的基线标准,包括文本对比度、键盘导航、触摸目标和减少动画偏好,并明确列出了开发者绝不应该做的事情——比如用增加视觉重量来解决层次问题、居中正文、或仅推送悬停状态而缺少焦点状态。该技能适用于 Claude Code 等支持技能机制的 AI 编码代理平台。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cbrock84/headcount/tree/main/plugins/product/skills/interface-craft

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

界面工艺

大多数界面的失败不在于想法本身,而在于执行——近乎一致的间距、近乎清晰的层级、近乎正确的排版。

在重新设计样式之前先进行诊断

询问这个屏幕的目的是什么。一个首要操作,最多一个次要操作。如果你无法说出首要操作是什么,那么布局问题其实是产品问题,再多的样式调整也无法解决它。

真正体现视觉质量的要素

层级。 观看者在阅读任何内容之前就应该知道往哪里看。通过大小、粗细和间距来实现——按此顺序。颜色是层级工具中最弱且最容易被过度使用的。

间距韵律。 相关元素靠得更近,不相关元素离得更远,而且间隙来自一个统一的尺度。不一致的间距是用户能感觉到却说不出名字的缺陷。正确运用就近原则,简约的布局也会显得经过精心设计。

排版。 界面中使用一种字体家族,最多两种。设置一个真正的字号比例,并按照其步进值使用,而不是随意创造大小。正文文字应有舒适的度量——大约60–75个字符——并且行高随度量变宽而增大。

表面的克制。 边框、阴影和填充都会分隔元素。每个边界只选用一种。三者叠加使用就是为什么界面在正常密度下看起来很杂乱的原因。

对齐。 每个元素都与某个对象对齐。没有任何对齐的元素即使是有意为之,也会让人觉得是错误。

密度是一个决策

信息密集型的工具和营销页面需要截然不同的处理方式。确定当前属于哪一类并坚持下去——那种尴尬的中间地带,一个数据表格却带有落地页的内边距,对两者都没好处。

完成所有状态

加载、空状态、错误和溢出是产品感觉未完成的地方。空状态是一个设计机会;一个没有上下文的加载动画则是一种妥协。长字符串、长列表和小屏幕都必须被妥善处理,而不是心存侥幸。

深色模式是一个调色板,而不是反转

反转浅色主题会产生典型的糟糕深色模式:纯黑背景、纯白文字,以及毫无作用的阴影。

  • 使用非常深的灰色而非纯黑,使用略微暗淡的白色而非纯白。两者之间的最大对比度会产生光晕效应,并且阅读起来确实很累。
  • 层级关系反转:在浅色主题中,凸起的表面投射阴影;在深色主题中,它们变得更亮。在深色底色上,阴影本身无法传达任何信息。
  • 在白色上能正常显示的饱和颜色在深色上会产生视觉振动。为深色调色板降低饱和度和提亮强调色,而不是直接复用。
  • 从一开始就在令牌层级同时定义这两个调色板。事后添加意味着要审计每一个表面。

可访问性底线

以下不是美化选项——低于这些标准,一些人将完全无法使用界面。

  • 文本对比度达到相对于其实际背景的标准比率,包括图片上的文字和彩色按钮内的文字。
  • 永远不要仅用颜色来承载含义。表示错误的红色边框也需要文字或图标。
  • 每个交互元素都必须可通过键盘访问,顺序合理,并有可见的焦点状态。
  • 触摸目标足够大以便可靠点击,相邻目标之间留有间距。
  • 尊重减少动画偏好:无法禁用的动画会对某些用户造成真实症状。
  • 使用真实的语义元素——按钮就是按钮,标题按顺序排列。样式化的 div 对辅助技术是不可见的。

绝对不要

  • 通过增加视觉重量来解决由过多相同元素造成的层级问题。应该移除元素而不是增加重量。
  • 居中正文。
  • 在没有匹配的焦点状态的情况下发布悬停状态。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

cbrock84/org-design

Designs how an organization is structured — reporting lines, team boundaries, spans and layers, role definition, and workforce planning against the strategy. Use this to structure a new team, restructure an existing one, resolve unclear ownership between teams, plan headcount, or diagnose why a team underperforms for structural rather than individual reasons.

cbrock84/portfolio-governance

Governs the portfolio of work — intake, prioritization, stage gates, resource contention, and stopping things. Use this to set up intake and prioritization, run a stage gate, decide between competing initiatives, resolve resource contention across projects, or work out why everything is in flight and nothing is finishing.

cbrock84/product-launch

Takes something built and gets it into the market — tiering the launch to match what it actually warrants, sequencing internal readiness before external announcement, preparing sales and support to answer the questions it creates, choosing the date for a reason, and measuring adoption rather than announcement reach. Use this to plan a launch, right-size one that is consuming more than it deserves, work out why a released feature nobody uses was launched loudly, or run the weeks after launch day.

cbrock84/program-management

Plans and drives cross-functional programs to delivery — scope, sequencing, dependencies, status, risk, and the escalations that keep work moving. Use this to run a multi-team initiative, recover a program that is slipping, build a delivery plan with dependencies, structure status reporting, or diagnose why cross-team work keeps missing dates.

cbrock84/project-delivery

Plans and delivers a single project — scope, estimation, scheduling, critical path, tracking, and recovering when it slips. Use this to plan a project, build or challenge a schedule, estimate credibly, track progress meaningfully, or recover a project that is late.

cbrock84/retention

Diagnoses and reduces churn — cancellation flows, save offers, failed-payment recovery, at-risk detection, and the product and service causes underneath. Use this when churn is rising or unexplained, to design a cancellation or win-back flow, to recover involuntary churn, to identify at-risk accounts before they leave, or to decide whether a retention problem is a product problem.

cbrock84/sales-enablement

Builds what a sales team needs to sell — pitch decks, one-pagers, objection handling, competitive battlecards, demo scripts, and case studies. Use this to create or fix sales collateral, prepare for a competitive deal, build a demo flow, document objection responses, or diagnose why a pitch is not converting.

cbrock84/tax

Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new. Use this to work out what a new state or country obligates you to, prepare for a tax filing or audit, understand sales tax on your product, or check what a remote hire or new market triggers.

cbrock84/unit-economics

Establishes whether the business makes money on each customer or unit — contribution margin, acquisition cost, payback period, lifetime value, and the cohort behavior underneath. Use this to assess whether growth is profitable, evaluate a channel or segment, support a pricing decision, judge how fast the business can afford to grow, or diagnose why revenue growth is not producing profit.

cbrock84/video-content

Plans and scripts short-form and long-form video, and designs the packaging — titles, thumbnails, and openings — that determines whether it gets watched. Use this to script a video, plan a series, fix retention or click-through problems, design thumbnail and title concepts, or turn written content into video. For a YouTube channel specifically — idea selection, retention teardowns, and channel-level strategy — use `youtube-producer`.

cbrock84/visual-content

Designs and directs the visual assets that carry content — carousels, infographics, quote graphics, diagrams, and social imagery — including the generation prompts where they are AI-produced. Use this to turn a written piece into a visual format, design a carousel or infographic, create social graphics, or fix visuals that are not stopping the scroll.

相关技能