项目简介
Hallmark 为每个需求选择独特的宏观结构,通过 57 道反模式检测生成非模板化 HTML/CSS,通过 CLI 工具与 Claude Code、Cursor 和 Codex 集成,提供四个动词命令。
README 预览
# Hallmark\n\n**A design skill for Claude Code, Cursor, and Codex that refuses to look AI-generated.**\n\n[Live demo →](https://www.usehallmark.com) · twenty themes · four verbs · press `T` to cycle.\n\nMade by Together AI.\n\n\n \n\n\nHallmark picks a macrostructure for the brief, dresses it in one of twenty themes, runs fifty-seven slop-test gates plus a pre-emit self-critique, and refuses the on-distribution defaults every LLM was trained into. Two pages by Hallmark for two different briefs feel like different sites, not colour-swaps of the same template.\n\n---\n\n## Four verbs\n\n| Verb | What it does |\n| --- | --- |\n| *(default)* | Build new UI. Picks a macrostructure, applies the rule-set, runs the slop test before handing back. |\n| `hallmark audit ` | Score existing code against the anti-patterns. Punch list, no edits. |\n| `hallmark redesign ` | Throw out the structure, keep copy + IA + brand, rebuild with a different fingerprint. |\n| `hallmark study ` | Extract the **DNA** from a design you admire: macrostructure, type-pairing, colour anchor. Refuses pixel-clones and paid templates. Optionally emits a portable `design.md` for handoff to other AI tools. |\n\n---\n\n## Different briefs, different shapes\n\nEach generated from a different brief. The skill picks the theme, structure, and craft to fit each one, not from a template.\n\n\n \n \n \n \n \n \n \n BubbleSourdough app · Hum\n DistilExtraction API · Cobalt\n Cold SnapRecord label · Carnival\n CinderAI tool · Lumen\n \n \n \n \n \n \n \n \n Ferns & FathomTea menu · Custom\n Hollowback ApiaryHoney farm · Garden\n Off-RegisterPrint fair · Riso\n Press QuaternaryType studio · Custom\n \n \n \n \n \n \n \n \n TallySaaS · modern-minimal\n WayfareTravel · atmospheric\n NAJMFashion brand\n HyperlaneDev infrastructure\n \n\n\nEach page is self-contained HTML + CSS, stamped with its ma
常见问题 (3)
故障排除如何修复运行 "npx skills add" 时出现 "No valid skills found" 的问题,即使 SKILL.md 中已包含 name 和 description?
这通常意味着 SKILL.md 中的 YAML frontmatter 解析失败。如果 description 中包含 : 序列,请用双引号将整个值括起来,这样 YAML 解析器就不会将其视为嵌套映射:
---
name: hallmark
description: "Anti-AI-slop design skill — Four verbs: ..."
version: 1.0.0
---
如果 description 本身包含双引号,请将其转义为 \"。更新 SKILL.md 后,重试:
npx -y skills@latest add nutlope/hallmark
已使用 skills@1.5.7 验证。CLI 目前隐藏了底层的 YAMLParseError: Nested mappings are not allowed in compact mappings,并报告了具有误导性的 "No valid skills found" 消息。
故障排除如何防止 `npx skills add` 安装 docs、website 和 package.json 等不相关的仓库文件?
skills CLI 会复制包含 SKILL.md 的目录中的所有文件。如果 SKILL.md 位于仓库根目录,npx skills add nutlope/hallmark 会复制整个仓库,包括 docs/、site/、package.json、README.md、ROADMAP.md 和 vercel.json。
解决方法是将该 skill 移入一个专用的子目录,例如:
skills/hallmark/
├── SKILL.md
└── # 仅包含 skill 运行时所需的文件
将 docs/、site/ 和 package.json 等仅属于仓库的文件保留在该目录之外,然后重新发布并重新安装该 skill。这样 CLI 就只会复制限定范围的 skill 目录。作为临时解决方案,可以在安装后手动删除不必要的文件。
故障排除如何修复 macOS 上的 Claude CLI 错误"No valid skills found. Skills require a SKILL.md with name and description"?
安装程序拒绝该仓库,因为 SKILL.md 中的 YAML frontmatter 格式错误或缺少必需字段。克隆该仓库,打开 SKILL.md,并确保它以包含 name 和 description 的有效 YAML frontmatter 开头,例如:
---
name: hallmark
description: Brief description of the skill
---
保存文件,然后从更正后的本地仓库安装该技能,或重试安装。避免在 YAML 中使用制表符、无效缩进或未转义的特殊字符。如果有已提交的修复 YAML 的 PR 可用,请使用该 PR,而不是手动编辑。