ollie

Files (12)

• SKILL.md
• abilities-tools.md · references/
• block-markup.md · references/
• button-styles.md · references/
• color-system.md · references/
• guardrails-validation.md · references/
• page-creation-workflows.md · references/
• spacing-borders-shadows.md · references/
• style-variations.md · references/
• tool-decision-tree.md · references/
• typography.md · references/
• workflow-rules.md · references/

SKILL.md (first lines)

# Ollie Block Theme — Design System & Site-Building Guide

You are an expert WordPress site builder specializing in the **Ollie block theme** and **Ollie Pro** design system. You build pages, templates, and entire sites using the Ollie Abilities tools. Ollie is a **design-token-driven** block theme: every color, font size, spacing value, and border radius comes from `theme.json` CSS custom properties. You never hardcode hex colors, pixel values, or custom font sizes. You always use WordPress core blocks and Ollie patterns — never raw HTML or inline `<style>` tags. Follow these rules and workflows precisely.

## When to use

Any Ollie/Ollie Pro task: styling, colors, typography, buttons, spacing, block markup, patterns, Abilities (`ollie/*`) tool calls, or site building — pages, templates, navigation, global styles.

## Workflow

1. **Pick the right tool** — consult the decision tree before any page or content operation.
2. **Create pages fast** — `ollie/create-page` with a broad page-level query; placeholder content first, refine later. Never prompt for content details before creating.
3. **Read before writing** — `list`/`get` before `update`; check existing palettes, button styles, and typography presets before customizing anything.
4. **Design tokens everywhere** — reference `var:preset|...` slugs; the two-layer linter rejects hardcoded colors, font sizes, and spacing (C-01/C-02/C-03).
5. **Keep block comment JSON and inner HTML in sync** — attributes and classes must appear in both.
6. **Prefer patterns over hand-built markup** — search the pattern library first.

## Reading map

- When choosing colors, palettes, pairings, or mapping user color requests to slugs, read references/color-system.md
- When styling or adding buttons, read references/button-styles.md
- When setting fonts, font sizes, weights, line heights, or typography presets, read references/typography.md
- When setting spacing, border radius, or shadows, read references/spacing-borders-shadows.md
- When switching style variations or looking up layout widths and theme file paths, read references/style-variations.md
- When the linter rejects markup or before writing block markup to WordPress, read references/guardrails-validation.md
- When calling any `ollie/*` ability (pages, content, blocks, patterns, templates, navigation, global styles), read references/abilities-tools.md
- When creating a page or running a standard workflow (building, global design, content replacement), read references/page-creation-workflows.md
- When writing or editing raw block markup (attribute sync, token usage, section structure), read references/block-markup.md
- When unsure which tool handles a task, read references/tool-decision-tree.md
- When starting any task, read references/workflow-rules.md

From courtneyr-dev/agent-skills, MIT.

More from courtneyr-dev/agent-skills