// Capture, validate, review, and evolve a repo-local Ghost fingerprint. Use when the user wants to capture a product fingerprint, update .ghost, brief work from accepted product-experience context, review drift, verify generated UI, compare fingerprints, or record accepted divergence.
Create, validate, recall, and evolve the repo-local Ghost fingerprint bundle. Use when the user wants to scan a product, create or update .ghost, write resources.yml/map.md/survey.json/patterns.yml/checks.yml/intent.md, validate optional decisions/proposals, derive patterns from survey evidence, brief work from the fingerprint, capture a proposal, or promote approved product-experience memory.
Use this skill to generate UI in the arcade design language (Cash Green (`#00D64F` / `#00BD46`) is reserved as accent and surface, never as the default fill of a primary button — `prominent.background = semantic.background.inverse`, so heroes are pure black/white., A "mono" appearance is a parallel reality: every brand reference has a `lightMono` / `darkMono` override that strips green to grey, generated as separate output (`colors-mono.ts`, `ArcadeColorMapping+LightMono.swift`) — accessibility/preference is a build target, not a runtime fork., Single typeface (`CashSans`, plus `CashSansMono` for micro-labels), carried by Square's CDN; every typography token also declares its `dynamic-type-style-uikit` and `dynamic-type-style-swiftui` mapping — type is bonded to platform a11y rails.). Contains the canonical fingerprint and token reference.
Use this skill to generate UI in the market design language (Monochromatic by default: `core.emphasis-fill` ships as `#101010` light / `#FFFFFF` dark even though the source aliases it to `core.blue-fill` — chromatic identity is opt-in via theme overlays, not a base-system trait., A full chromatic palette is defined and reserved: green / forest / teal / blue / sky / purple / pink / burgundy / red / orange / gold / yellow / taupe / brown each ship as a 6-step set (fill, text, 10, 20, 30, 40) but the base system only consumes them through semantic aliases (`success`, `warning`, `critical`, `emphasis`)., A 17-step grayscale ramp from `#FFFFFF` to `#000000` (with a separate `core.constant.gray-*` track) carries most of the visual weight — surfaces, dividers, fills, and text are all neutrals first.). Contains the canonical fingerprint and token reference.
Reason about a fleet of design systems — pairwise distances, cohorts, tracks-graph, world-shape narrative. Use when the user has a directory of (map.md, fingerprint.md) members and wants to understand how they relate, where they cluster, who declares whom as reference, or how the fleet's shape should be summarized for design system leadership. Triggers on phrases like "what does our design world look like", "compare these systems as a fleet", "where do our apps cluster", "who tracks whom", "summarize the fleet", "fleet view", or whenever a `fleet/` directory with member subdirectories is being explored.
| name | ghost |
| description | Capture, validate, review, and evolve a repo-local Ghost fingerprint. Use when the user wants to capture a product fingerprint, update .ghost, brief work from accepted product-experience context, review drift, verify generated UI, compare fingerprints, or record accepted divergence. |
| license | Apache-2.0 |
| metadata | {"homepage":"https://github.com/block/ghost","cli":"ghost"} |
Ghost captures product identity in a repo-local fingerprint bundle:
.ghost/
resources.yml
map.md
survey.json
patterns.yml
checks.yml # optional deterministic gates
intent.md # optional human-approved intent
decisions/ # optional accepted/rejected rationale
proposals/ # optional candidate updates
Survey grounds the bundle. Patterns make composition operational. Checks are deterministic gates. Intent and decisions preserve human-approved product experience context. The host agent reads and writes the fingerprint; the CLI provides deterministic validation, comparison, routing, and handoff packets.
| Verb | Purpose |
|---|---|
ghost init [dir] [--with-intent] | Create the root .ghost bundle skeleton. |
ghost scan [dir] [--format json] | Report fingerprint capture progress and the next BYOA step. |
ghost inventory [path] | Emit raw repo signals for map authoring. |
ghost lint [file-or-dir] | Validate a bundle or individual artifact. |
ghost verify [dir] --root <dir> | Validate resources, pattern evidence, checks, and optional decisions/proposals. |
ghost survey <op> | Survey ops: merge, fix-ids, summarize, catalog, patterns. |
ghost check --base <ref> | Run active deterministic gates against a diff. |
ghost review --base <ref> | Emit an advisory review packet grounded in bundle evidence. |
ghost compare <a> <b> [...more] | Compare root bundles or direct fingerprints. |
ghost ack / track / diverge | Record stance toward tracked drift. |
ghost emit <kind> | Emit review-command or context-bundle. |
ghost skill install | Install this unified skill bundle. |
.ghost/ as the source of truth.ghost lint and ghost verify --root <target> before declaring Fingerprint Capture complete.ghost check for deterministic gates and ghost review for advisory critique.ghost review --include-memory when product-experience rationale matters.survey.json.intent.md as authoritative unless human-authored or human-approved.