Youssef
aedca8cb03
The published install command in the README — npx skills add nutlope/hallmark — was failing for users because the skills CLI looks for SKILL.md at the repo root, not at skill/SKILL.md where Hallmark kept it. The clone succeeded but the CLI reported "No skills found." Manual cp was the only working install path. Flattened the layout: - skill/SKILL.md → SKILL.md - skill/references/ → references/ - (skill/ directory removed; was empty after moves) git mv preserved rename history for all 76+ files (SKILL.md + 28 reference files + 21 macrostructures + 46 components + 7 verb/genre subfolders). Updated every cross-reference (36 occurrences across 9 files): - README.md — 4 links (SKILL.md + references/ + the install snippet still reads the same) - ROADMAP.md — 4 links to reference files - package.json — "files" field + "skill" entry/references paths - site/js/main.js — 3 source comments - references/design-md.md — one broken link (was pointing skill/references/export-formats.md from inside references/ — now just export-formats.md as a sibling) - site/_tests/verbs/study/notes.md, diagnosis.md and verbs/audit/audit-report.md, custom/README.md — test-artifact relative paths shortened by one segment (e.g. ../../../skill/SKILL.md → ../../../SKILL.md) No skill content changes. After this lands, 'npx skills add nutlope/hallmark' should clone + install correctly without any manual cp fallback.
1.7 KiB
02 · Long Document
Reads like a memo, a letter, or a journal entry. No marketing structure. Continuous prose with inline section heads. The page is literature about the product.
- Heading: inline with body — section heads emerge from the paragraph flow as small caps or bold short phrases.
- Body: single column, generous line-height (1.65+), measure 60–65ch.
- Divider: negative space; the gap is the divider; occasionally a centered ornament for emphasis.
- Button: typographic link inside a paragraph, not a separate block.
- Image: inline, sized to text measure; never full-bleed.
- Reveal: none. The page is just there.
Reach for it for case studies, founder posts, mission pages, products whose sale is philosophical. The brief is "tell a story", not "list features".
Avoid when there's a single decisive action to take — Long Document hides CTAs, which is wrong for transactional pages.
Reference: Frank Chimero's site, destroytoday.com, long-form Substack essays in product disguise.
Sample opening lines (imitate the specificity, not the wording):
"Saturday, 6:14 a.m. The dough went in at midnight." — opens with a time-stamp; the brand introduces itself as a moment in the day "A monthly art publication featuring contributions by some of the most engaged thinkers working today." — e-flux.com/journal "We design everything for everyone." — pentagram.com — refusal of the verb, treats design as universal practice
<article class="prose">
<p class="lede">…</p>
<p>…</p>
<h2 class="inline">A small heading.</h2>
<p>…</p>
<blockquote>…</blockquote>
<p>… <a href="">read more →</a> …</p>
</article>