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.2 KiB
13 · Index-First
The page IS a list of links. No hero image, no narrative flow. Pure navigation as design.
- Heading: one short paragraph at the top introducing the index, no display type.
- Body: vertical list of categorised links; sometimes a sidebar of filters.
- Divider: hairline rules between rows; or zero rules with paper-colour bands.
- Button: the links themselves are the buttons.
- Image: none, or tiny favicons by each entry.
- Reveal: none.
Reach for it for documentation hubs, knowledge bases, archive front pages, design system entries, link-in-bio pages with substance.
Avoid for marketing pages. Index-First is for browsing audiences; selling needs structure.
Reference: Are.na's homepage feel, archive sites, documentation indices.
Sample opening lines (imitate the specificity — Index-First openings are headers for what's below, sometimes nothing more than a label):
"Selected work · 2018 — 2026." — date range, no preamble "Things Become Other Things · Lightness above weightiness." — craigmod.com — two phrases joined by a divider "Writer + Photographer." — craigmod.com — three words, summarises the whole site