Files
Youssef 3ec0173896 Install · scope the skill to skills/hallmark/ (fixes #9)
The skills CLI copies everything under the directory containing SKILL.md.
With SKILL.md at the repo root, installs were pulling in docs/, site/,
package.json, README, ROADMAP, vercel.json, LICENSE. Moving the skill
into skills/hallmark/ scopes the install to just SKILL.md + references/.

The CLI's priority search hits skills/ first, so `npx skills add
nutlope/hallmark` is unchanged. Updated README install paths,
package.json (entry/references/files), and the internal links that
crossed the new boundary.
2026-05-26 12:07:51 +01:00
..

Hallmark verbs — worked examples

Each verb demonstrated on a tiny, realistic input. Folders contain the input, the verb's output, and a one-page note explaining what fired and why.

Verb Folder Input What the verb does
audit audit/ An AI-templated landing fragment Read it, score against the anti-pattern list, return a ranked punch list. Does not edit.
redesign redesign/ A page with the AI structural template (centered hero · 3 cards · CTA · footer) Throw out the structure, rebuild with a different fingerprint. Preserves copy + IA.
study study/ A described screenshot of a Pentagram-style portfolio Extract DNA — macrostructure, archetypes, type-pairing role, accent — return a diagnosis report, then rebuild user content with that DNA. Never copies pixels.

Each folder holds:

  • input.html (or input-description.md for study) — what the user paste / attach.
  • output.* — what the verb produces. For audit and study, this is a Markdown report. For redesign, this is a finished index.html + style.css.
  • notes.md — one page explaining what fired, what reference files loaded, and what the durable artifact is.

The three verb tests together exercise every load path in the skill that the default-flow tests don't.