happycapy-ai/happycapy-skills/apricot-ritual

Apricot Ritual Index PPTX Skill

A reusable fixed-style PowerPoint generation skill. It builds on the pptx skill's technical capabilities while locking in the Apricot Ritual Index visual identity: calm, editorial, typographic, premium, sparse — like a refined product introduction combined with a typographic brand-poster system.

Core principle — style fidelity over content volume. When the user's topic contains more information than the poster format can hold, compress and reinterpret. The deck must feel calm, premium, and intentional — not a generic report template, not a text-heavy catalog, not a business slide deck. Every slide is an editorial poster plate.

Step 1: Gather Inputs (Ask First — Max 3 Questions)

Do not start generating immediately. Use the AskUserQuestion tool to present all questions in a single call. Only ask about what the user hasn't already provided.

Question 1 — Topic (skip if already provided):

• header: "Topic"
• question: "What is the presentation topic or title?"
• options: 2–3 relevant examples plus allow Other

Question 2 — Slide count (skip if already specified):

• header: "Slides"
• question: "How many slides should the deck include? (9 recommended)"
• options: 6 slides, 9 slides (Recommended), 12 slides, 15 slides

Question 3 — Visual assets:

• header: "Images"
• question: "How should visual assets be provided?"
• options:
• Use uploaded images — Insert images I provide
• Generate with gpt-image-2 — AI creates warm apricot editorial imagery
• Combine both — Mix uploaded and AI-generated images

Infer the audience, narrative structure, section labels, and supporting details from the topic and available context. Do not ask additional questions unless essential information is missing and the presentation cannot be completed without it.

Once you have the three answers, proceed directly to generation.

Step 2: Translate the Topic into Apricot Ritual Index Language

Before writing any slide copy, translate the user's topic into the Apricot Ritual Index frame. The visual language originates in premium product introductions and ritual sequences, but it works for any subject — every topic can be reinterpreted as principles, components, stages, layers, chapters, rituals, index entries, sequences, or key objects/concepts.

Decide the poster title, the one-line premise, and the index or sequence structure before writing any slides. These anchor the cover and define the visual rhythm of the whole deck.

Preserve factual accuracy and the user's intended meaning. Do not invent product claims, brand names, statistics, people, or factual details.

Step 3: Generate Images (if requested)

Read the generate-image skill at /home/node/.claude/skills/generate-image/SKILL.md for the exact API call pattern. Use openai/gpt-image-2 with response_format: "b64_json".

How many images to generate

• 9-slide deck → 4–5 images
• 12–15 slide deck → 5–6 images
• 6 slides → 3–4 images

Cover image rule

The cover must contain one strong topic-relevant image as its primary visual. Generate or use an uploaded image for the cover first, before building the rest of the deck.

Apricot Ritual Index image prompt formula

Generated images are minimal premium editorial assets — not slide screenshots and never images with embedded text.

Base formula:

Minimal premium editorial still-life photograph. [Scene descriptor: matte ceramic container / abstract organic form / textured surface detail / sparse ingredient arrangement / clean studio object / polished artifact]. Warm apricot (#FDDEB6) surface, soft cocoa-brown (#6C4832) shadow accents, subtle beige highlights, clean studio lighting, sparse high-end composition, adequate negative space. No readable text, no logos, no brand marks, no watermarks, no people, no hands, no busy environments. Clearly visible primary silhouette. Warm tonal palette, calm and restrained.

For non-product topics, adapt the scene to abstracted forms relevant to the user's subject:

Minimal premium editorial still-life. [Abstract form relevant to topic: layered paper / architectural model fragment / scientific instrument / tool arrangement / geometric object]. Warm apricot surface, cocoa-brown accents. Same lighting and composition rules as above.

Save each image to /tmp/apricot-ritual-img-N.png.

Step 4: Build the PPTX

Read the pptx skill at /home/node/.claude/skills/pptx/SKILL.md and its pptxgenjs.md reference for the full API. Build using PptxGenJS.

Core style constants — do not deviate

const APRICOT = "FDDEB6";   // dominant background — all apricot fields
const COCOA   = "6C4832";   // primary typography, rules, dividers, labels
const BEIGE   = "F5EAD8";   // subtle highlights, depth accents only when needed
const SERIF   = "Georgia";  // elegant high-contrast titles, category words, closing poster
const SANS    = "Arial";    // narrow compact labels, indexes, steps, captions, metadata

If Georgia is unavailable, substitute Palatino Linotype or Times New Roman.

Layout — LAYOUT_16x9 always (10" × 5.625")

All slides use LAYOUT_16x9. Background is APRICOT on every slide. The cocoa-brown color applies to all text, rules, and dividers. Beige is used sparingly for depth or image integration only.

Typography sizing

Typography must remain spacious and restrained. Never shrink text aggressively to fit excess copy — reduce the copy instead.

Apricot Ritual Index Visual System Rules

The most common failure mode is a text-heavy report placed on an apricot background. These rules prevent that.

Rule 1: Style fidelity over content volume

The poster system takes priority over including every detail. Summarise. Compress. Choose the one most important idea for each slide and let everything else recede. A calm empty apricot field is a design choice, not a mistake.

Rule 2: One idea per slide. Under 30 words.

Count visible words before finalising each slide. Most slides must be under 30 words total — title, body, labels, metadata combined. Body copy should be one short statement, a compact label sequence, or a brief step name. No paragraphs, no dense bullet lists.

Wrong: "This section explores the fundamental principles underlying our approach to sustainable product design, focusing on material selection, lifecycle analysis, and end-user experience throughout the development process."

Right:

MATERIAL
HONESTY
 
Sourced with intention.
Designed to last.

Rule 3: Varied layouts within the same system

The Apricot Ritual Index style uses multiple layout types — centered poster, typographic index, image plate, split composition — but all within the same apricot/cocoa palette and serif/sans hierarchy. Vary the layout across slides so the deck feels composed, not repetitive.

Layout vocabulary:

• Centered title plate: Large SERIF title centered, thin COCOA rule above/below, sparse SANS metadata
• Typographic index: Numbered or labeled entries, SANS compact rows, thin rules between groups
• Image plate: One dominant image, single SANS caption, generous negative space
• Split composition: Left text field (SERIF headline + SANS detail), right image panel
• Category word: One oversized SERIF word centered, thin rule, 1–2 compact SANS lines
• Closing poster: Full APRICOT field, large centered SERIF statement, SANS credit/date

Rule 4: Thin rules as section dividers only

Thin horizontal COCOA rules (LINE shapes, h: 0, line.width: 1–1.5pt) may separate typographic sections. They must sit in clean whitespace — never passing through or touching any text box, image, or caption. Before adding a rule, verify there is at least 0.3" of clear space above and below it.

Rule 5: Safe layout zones — no collisions

Before placing elements, define these non-overlapping zones:

TITLE ZONE:          y: 0.7"–2.4", adequate left/right margin
SUPPORTING-TEXT ZONE: at least 0.35" below title bottom edge
IMAGE ZONE:          defined rectangle — text must never enter it
DIVIDER ZONE:        dedicated whitespace only — never within 0.3" of any text
CAPTION/METADATA ZONE: y: 4.8"–5.3" bottom strip, or compact block near image
FOOTER ZONE:         y: ~5.2"–5.5", minimal SANS credit if needed

Conflict resolution order: reduce copy → simplify structure → increase spacing → remove rule → simplify layout → move content to another slide.

Rule 6: Images as editorial plates, never backgrounds

Images sit in clean rectangular windows or cover one half of the slide. They must not float over text or have text placed across them (except for a compact caption in a separate APRICOT block). Full-bleed images should have minimal text — maximum 10 words — placed in a calm area with adequate contrast.

Suggested Slide Structure

Use this when the user provides no outline. Adapt freely when they do.

Layout Patterns

Cover (poster image + centered title)

Background: APRICOT full slide
 
Optional: image panel (right half or upper portion)
  Image: clean editorial still-life, x:5.5, y:0, w:4.5, h:5.625 (right half)
  — OR —
  Image: centered plate, x:3.5, y:0.8, w:3, h:3 (centered upper block)
 
Left/lower field:
  Small SANS category tag, 13pt, COCOA, uppercase, y: 0.5", x: 0.6"
  Hero SERIF title (stacked), 80–110pt, COCOA, y: 1.2"–2.8"
  Thin COCOA rule (LINE), w: 3", y: below title + 0.4" gap
  SANS metadata, 13pt, COCOA, near bottom

Centered title plate

Background: APRICOT full slide
Thin COCOA rule (LINE), w: 5", centered, y: 1.5"
SERIF headline, 52–68pt, COCOA, centered, y: 1.8"–2.8"
Thin COCOA rule (LINE), w: 5", centered, y: below headline + 0.4" gap
Optional supporting statement, 24pt SANS, COCOA, centered, below rule
SANS metadata, 13pt, COCOA, bottom center, y: ~5.0"