DESIGN.md@docsA

DESIGN.md@docs from vintlin/skill-flow is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add vintlin/skill-flow/docs/DESIGN.md@beta

Pins beta in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
vintlin/skill-flow
Path
docs/DESIGN.md
Versions recorded
3
Latest version
beta, committed Aug 31, 2026
First version recorded
Jun 28, 2026
Size
35,165 bytes
Repository stars
264
License
Apache-2.0

A compact macOS operations workspace built from layered neutral surfaces, user-selectable accents, reusable group cards, and explicit selection and runtime states.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Design System: Skill Flow Desktop

## Overview

**Creative North Star: “The Skill Operations Board”**

Skill Flow Desktop 是一个用于检查、导入、分组、部署和维护 agent skills 的 macOS 工作台。视觉上应像安静、精密的运维面板:信息密度高,但状态边界清楚;交互紧凑,但不会挤成传统管理后台;强调真实对象、当前选择和下一步操作,而不是装饰性指标。

主界面使用四级中性灰建立层次,用户选择的 accent 只负责当前对象、选中状态、主操作和局部身份。卡片、列表与详情页共享同一套 8–12px 圆角、0.5px 边框和 11–13px 信息字体。阴影只用于输入控件、浮层和独立空状态,不用于制造卡片墙。

**Key Characteristics**

- macOS 原生系统字体与紧凑控件节奏。
- light / dark 双主题,结构一致,只调整明度与对比度。
- 六种用户可选 accent,但单个界面上下文只使用一种主 accent。
- Group Card 是 Home、Import 和 menu bar 的共享核心组件。
- 状态通过颜色、图标、计数和文字共同表达。
- 边框优先、阴影克制、无装饰性渐变。
- 整卡点击关闭;详情导航限定在标题、署名和统计等明确区域。

## Scope

覆盖:

- macOS desktop 主窗口。
- Home、Import、Detail、Settings 页面。
- menu bar quick config。
- Group Card、标签、选择控件、浮层、toast、空状态和 Markdown 文档呈现。

不覆盖:

- CLI / TUI 的终端排版规范。
- README、官网或发布截图的 marketing 风格。
- App Icon、第三方 agent icon 和内容图片本身的绘制规范。

## Colors

### Surface Ladder

界面使用四级无彩色 surface。层级由相邻 surface 的明度差和 0.5–1px 边界建立,不依赖大面积阴影。

| Role | Light | Dark | Use |
| --- | --- | --- | --- |
| Page | `{colors.light-page}` #f2f2f2 | `{colors.dark-page}` #222222 | 主页面底色、header、menu bar 背景、文档 block |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add vintlin/skill-flow/docs/DESIGN.md@sha256:56279f4799ca12f2

The line at the top of this page pins the label beta, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vhweeg4t5qpxskrr.svg)](https://markdownregistry.com/a/art_vhweeg4t5qpxskrr)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Jun 28, 2026 and Aug 31, 2026, about one every 32 days.

versioncommittedcommitsizeaudit
beta latest2026-08-31 ff35a24 35,165 BA view · diff
beta2026-07-20 1e5eb51 34,364 BA view · diff
git:20260628.fe53a072026-06-28 fe53a07 2,819 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (35165 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

vintlin/skill-flow · 264 stars · license Apache-2.0 · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vhweeg4t5qpxskrr
GET https://markdownregistry.com/api/v1/resolve?ref=vintlin/skill-flow/docs/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/56279f4799ca12f2f9e18a37e2c6c0da7f79da7211cf4b6c05e703cdfe4a5225

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: what DESIGN.md is and how agents use it · which agent file does what.

More from vintlin/skill-flow

skill-flow SKILL.md skill
vintlin/skill-flow · skills/skill-flow/SKILL.md · Use when the user asks Codex to inspect, import, enable, disable, deploy, update, repair, migrate, or uninstall Skill…
git:20260615.70980d9 · audit A · 264 stars

Every file in vintlin/skill-flow

Other files named DESIGN.md@docs

DESIGN.md@docs DESIGN.md file
mvschwarz/openrig · docs/DESIGN.md
git:20261005.f6358a2 · audit A · 7,989 stars
DESIGN.md@docs DESIGN.md file
geekjourneyx/md2wechat-skill · docs/DESIGN.md
git:20260319.1e4d509 · audit A · 3,712 stars
DESIGN.md@docs DESIGN.md file
keli-wen/agy-staff · docs/DESIGN.md
git:20261007.65a1ab4 · audit A · 765 stars
DESIGN.md@docs DESIGN.md file
1ay1/agentty · docs/DESIGN.md
git:20261010.227e92e · audit A · 625 stars
DESIGN.md@docs DESIGN.md file
mobileaidev/ai-app-bridge · docs/DESIGN.md
git:20261012.3200529 · audit A · 227 stars
DESIGN.md@docs DESIGN.md file
shellishack/infinite-pokemon · docs/DESIGN.md
git:20260914.2f240d9 · audit A · 187 stars
DESIGN.md@docs DESIGN.md file
ghalebdweikat/winnow · docs/DESIGN.md
git:20261006.4547a81 · audit A · 115 stars
DESIGN.md@docs DESIGN.md file
viy1204/recruiting-copilot · docs/DESIGN.md
git:20260827.5ea0afa · audit A · 92 stars

Browse by kind, by grade A, or by owner.