TryGhost/Ghost

add-admin-api-endpoint

Add a new endpoint or endpoints to Ghost's Admin API at `ghost/api/admin/**`.

لغة النص الأصلي: الإنجليزية

add-private-feature-flag

Use when adding a new private (developer experiments) feature flag to Ghost, including the backend registration and settings UI toggle.

لغة النص الأصلي: الإنجليزية

commit

Commit message formatting and guidelines

لغة النص الأصلي: الإنجليزية

create-database-migration

Create a database migration to add a table, add columns to an existing table, add a setting, or otherwise change the schema of Ghost's MySQL database. Use this skill whenever the task involves modifying Ghost's database schema — including adding, removing, or…

لغة النص الأصلي: الإنجليزية

format-numbers

Format numbers using the formatNumber function from Shade whenever someone edits a TSX file.

لغة النص الأصلي: الإنجليزية

shade-component-decision

Decide which Shade layer (Token, Primitive, Component, Recipe, Pattern) a new piece of UI belongs in — and whether it should be added to Shade at all. Trigger when creating new files in apps/shade/src/components, or proposing to add a new Shade component.

لغة النص الأصلي: الإنجليزية

shade-dropdown-surface-contract

DropdownMenu, Select, and Popover share one visual recipe (bg-surface-elevated-2 + border-border/60 dark:border-border/30 + shadow-md). Change them together. Trigger when editing any of those three Shade files.

لغة النص الأصلي: الإنجليزية

shade-inputsurface-recipe

Use the inputSurface() recipe for form-control chrome (border, background, radius, focus ring, invalid state) — don't roll your own. Trigger when editing form-control-shaped files in Shade.

لغة النص الأصلي: الإنجليزية

shade-new-component

Acceptance checklist for adding or editing a Shade component or pattern file — naming, sibling story, className forwarding, cva variants, required states, recipe usage. Trigger when editing files in apps/shade/src/components.

لغة النص الأصلي: الإنجليزية

shade-shadcn-install

Guardrails for running `pnpm dlx shadcn@latest add` in Shade — never overwrite existing components, fresh branch first, swap raw colours for semantic tokens after integrating. Trigger when the user proposes a shadcn add, or when a fresh ShadCN-shaped file…

لغة النص الأصلي: الإنجليزية

shade-tokens-not-hex

Use Shade semantic tokens (bg-background, text-foreground, border-border-default, bg-surface-elevated) — never hex, hsl(), or bg-gray-200-style raw palette utilities for UI chrome. Trigger when editing TSX/CSS in Shade-consuming apps.

لغة النص الأصلي: الإنجليزية

shade-use-primitives

Replace bare divs that only carry flex/grid/gap utilities with Shade primitives (Stack, Inline, Box, Grid, Container, Text). Use semantic gap="md" instead of gap-4. Trigger when editing TSX in Shade-consuming apps.

لغة النص الأصلي: الإنجليزية

shade-page-templates

Pick the right Shade page template (ListPage, PageHeader) for a new admin page instead of inventing chrome. Trigger when creating new admin pages or routes in apps/admin or apps/activitypub.

لغة النص الأصلي: الإنجليزية

migrate-internal-package

Move a package from another TryGhost repository into Ghost as an internal-only workspace package while preserving its Git history. Use for package migrations from repositories such as TryGhost/SDK or TryGhost/framework, including the history import PR,…

لغة النص الأصلي: الإنجليزية

convert-internal-package-to-typescript

Convert a legacy internal Ghost workspace package from JavaScript or CommonJS to the repository's TypeScript and ESM golden path while preserving file history and runtime compatibility. Use when modernizing an existing or newly migrated private package,…

لغة النص الأصلي: الإنجليزية

shade-imports

Import Shade from layer-specific subpaths (primitives, components, patterns, page-templates, utils), never the root barrel. Trigger when editing TSX/TS in Shade-consuming apps.

لغة النص الأصلي: الإنجليزية

shade-no-dark-variants

Don't write dark: Tailwind variants for colour in Shade or admin apps — semantic tokens flip in dark mode automatically. Trigger when editing TSX in Shade-consuming apps.

لغة النص الأصلي: الإنجليزية