ornament-style-color

Design polychromatic ornamental patterns grounded in Alexander Speltz's classical ornament taxonomy. Builds on monochrome structural analysis by adding period-authentic color palettes, color-to-motif mapping, and rendering styles suited to painted, illuminated, and glazed ornament. Use when creating decorative designs where color is integral to the tradition (Islamic tilework, illuminated manuscripts, Art Nouveau), exploring how historical periods used color in ornament, or producing colored reference imagery for design, illustration, or educational materials.

9 stars

Best use case

ornament-style-color is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Design polychromatic ornamental patterns grounded in Alexander Speltz's classical ornament taxonomy. Builds on monochrome structural analysis by adding period-authentic color palettes, color-to-motif mapping, and rendering styles suited to painted, illuminated, and glazed ornament. Use when creating decorative designs where color is integral to the tradition (Islamic tilework, illuminated manuscripts, Art Nouveau), exploring how historical periods used color in ornament, or producing colored reference imagery for design, illustration, or educational materials.

Teams using ornament-style-color should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/ornament-style-color/SKILL.md --create-dirs "https://raw.githubusercontent.com/pjt222/agent-almanac/main/i18n/caveman-lite/skills/ornament-style-color/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/ornament-style-color/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How ornament-style-color Compares

Feature / Agentornament-style-colorStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Design polychromatic ornamental patterns grounded in Alexander Speltz's classical ornament taxonomy. Builds on monochrome structural analysis by adding period-authentic color palettes, color-to-motif mapping, and rendering styles suited to painted, illuminated, and glazed ornament. Use when creating decorative designs where color is integral to the tradition (Islamic tilework, illuminated manuscripts, Art Nouveau), exploring how historical periods used color in ornament, or producing colored reference imagery for design, illustration, or educational materials.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Ornament Style — Color

Design polychromatic ornamental patterns by combining art historical color knowledge with AI-assisted image generation. Builds on the structural foundation of `ornament-style-mono` by adding period-authentic color palettes, color harmony principles, and rendering styles suited to painted, illuminated, and glazed ornament.

## When to Use

- Creating decorative designs where color is integral to the ornamental tradition (e.g., Islamic tilework, illuminated manuscripts, Art Nouveau posters)
- Exploring how historical periods used color in ornament — palette, distribution, and symbolic meaning
- Producing colored reference imagery for design, illustration, or educational materials
- Generating painted, illuminated, glazed, or stained glass renderings of classical motifs
- Studying the relationship between color and form in ornamental traditions

## Inputs

- **Required**: Desired historical period or style (or "surprise me" for random selection)
- **Required**: Application context (border, medallion, frieze, panel, tile, standalone motif)
- **Optional**: Color palette preference (period-authentic, custom, or specific colors)
- **Optional**: Specific motif preference (acanthus, arabesque, rosette, etc.)
- **Optional**: Rendering style preference (painted, illuminated, glazed tile, stained glass, watercolor)
- **Optional**: Color mood (muted/antique, balanced/natural, vivid/saturated)
- **Optional**: Target resolution and aspect ratio
- **Optional**: Seed value for reproducible generation

## Procedure

### Step 1: Select Historical Period and Color Palette

Choose a period and identify its characteristic color language. Color in ornament is never arbitrary — each period has a palette rooted in available pigments, cultural symbolism, and material context.

```
Historical Ornament Periods with Characteristic Palettes:
┌───────────────────┬─────────────────┬────────────────────────────────────────────────────────┐
│ Period            │ Date Range      │ Characteristic Palette                                  │
├───────────────────┼─────────────────┼────────────────────────────────────────────────────────┤
│ Egyptian          │ 3100–332 BCE    │ Lapis blue, gold/ochre, terracotta red, black, white   │
│                   │                 │ Mineral pigments: flat, unmodulated, high contrast      │
├───────────────────┼─────────────────┼────────────────────────────────────────────────────────┤
│ Greek             │ 800–31 BCE      │ Terracotta red, black, ochre, white, blue (rare)       │
│                   │                 │ Pottery palette; architectural color largely lost        │
├───────────────────┼─────────────────┼────────────────────────────────────────────────────────┤
│ Roman             │ 509 BCE–476 CE  │ Pompeii red, ochre yellow, black, white, verdigris     │
│                   │                 │ Fresco palette: warm earth tones, strong red dominant    │
├───────────────────┼─────────────────┼────────────────────────────────────────────────────────┤
│ Byzantine         │ 330–1453 CE     │ Gold (dominant), deep blue, crimson, purple, white      │
│                   │                 │ Mosaic tesserae: jewel tones, gold ground, luminous      │
├───────────────────┼─────────────────┼────────────────────────────────────────────────────────┤
│ Islamic           │ 7th–17th c.     │ Turquoise/cobalt blue, white, gold, emerald green       │
│                   │                 │ Tile glazes: luminous, saturated, geometric precision    │
├───────────────────┼─────────────────┼────────────────────────────────────────────────────────┤
│ Romanesque        │ 1000–1200 CE    │ Ochre, rust red, deep green, dark blue, cream           │
│                   │                 │ Manuscript and stone: earthy, muted, mineral-derived     │
├───────────────────┼─────────────────┼────────────────────────────────────────────────────────┤
│ Gothic            │ 1150–1500 CE    │ Ultramarine blue, ruby red, emerald green, gold, white  │
│                   │                 │ Stained glass + illumination: saturated, luminous        │
├───────────────────┼─────────────────┼────────────────────────────────────────────────────────┤
│ Renaissance       │ 1400–1600 CE    │ Rich earth tones, azure blue, gold leaf, warm greens    │
│                   │                 │ Oil and fresco: naturalistic, modulated, subtle          │
├───────────────────┼─────────────────┼────────────────────────────────────────────────────────┤
│ Baroque/Rococo    │ 1600–1780 CE    │ Pastel pink, powder blue, cream, gold, soft green       │
│                   │                 │ (Rococo) vs deep burgundy, gold, forest green (Baroque) │
├───────────────────┼─────────────────┼────────────────────────────────────────────────────────┤
│ Art Nouveau       │ 1890–1910 CE    │ Sage green, dusty rose, amber/gold, muted purple,      │
│                   │                 │ teal. Organic, muted, nature-derived palette             │
└───────────────────┴─────────────────┴────────────────────────────────────────────────────────┘
```

1. If the user specified a period, confirm and note its characteristic palette
2. If "surprise me," select randomly — weight toward periods with rich color traditions (Islamic, Byzantine, Gothic, Art Nouveau)
3. Note the material context (fresco, mosaic, tile, stained glass, print) as this affects how color renders

**Got:** A clearly identified period with its characteristic palette and material context understood.

**If fail:** If the user requests a period not in the table, research its color language using WebSearch for "[period] ornament color palette pigments" and construct an equivalent entry. Historical pigment availability is a reliable guide to period-authentic color.

### Step 2: Define Color Palette

Translate the historical palette into a specific 3-5 color set with defined roles.

**Color Role Framework:**
```
Color Distribution (60/30/10 Rule):
┌──────────────┬────────────┬──────────────────────────────────────────┐
│ Role         │ Proportion │ Function                                  │
├──────────────┼────────────┼──────────────────────────────────────────┤
│ Dominant     │ ~60%       │ Ground color or primary structural color  │
│ Secondary    │ ~30%       │ Motif fill or supporting structural color │
│ Accent       │ ~10%       │ Highlights, details, focal points         │
│ (Optional)   │ —          │ Additional accent or metallic (gold)      │
│ (Optional)   │ —          │ Background / ground if different from     │
│              │            │ dominant                                   │
└──────────────┴────────────┴──────────────────────────────────────────┘
```

**Color Harmony Approaches:**
- **Period-Authentic**: Use only colors available to the historical period's pigments and materials
- **Complementary**: Opposing colors on the color wheel (e.g., blue and gold/orange) — high contrast
- **Analogous**: Adjacent colors (e.g., sage green, teal, muted blue) — harmonious, subtle
- **Triadic**: Three equally spaced colors (e.g., red, blue, gold) — vibrant, balanced

1. Select 3-5 colors with named roles (dominant, secondary, accent, optional)
2. Choose the harmony approach
3. Assign approximate hex values or descriptive color names
4. Note the color mood: muted/antique, balanced/natural, or vivid/saturated

**Example Palette Definitions:**
- **Islamic Tilework**: turquoise (dominant), white (secondary), cobalt blue (accent), gold (detail) — analogous + metallic — vivid
- **Art Nouveau Poster**: sage green (dominant), dusty rose (secondary), amber gold (accent) — analogous — muted
- **Byzantine Mosaic**: gold (dominant), deep blue (secondary), crimson (accent), white (detail) — complementary — vivid

**Got:** A palette of 3-5 named colors with roles, proportions, harmony approach, and mood defined.

**If fail:** If color selection feels arbitrary, anchor to the period's material context. Ask: "What pigments were physically available?" and "What was the ground material?" (gold leaf on vellum, glaze on ceramic, paint on plaster). The material constrains and authenticates the palette.

### Step 3: Analyze Motif Structure

Understand the structural grammar of the chosen motif, extending the monochrome analysis with color-to-structure mapping.

1. Perform the same structural analysis as `ornament-style-mono` Step 2:
   - Symmetry type (bilateral, radial, translational, point)
   - Geometric scaffold (circle, rectangle, triangle, band)
   - Fill pattern (solid, line-filled, open, mixed)
   - Edge treatment (clean, organic, interlocking)

2. Add **color-to-structure mapping**:
   - Which structural elements receive which colors?
   - Does color follow form (each shape gets one color) or flow (color gradients cross structural boundaries)?
   - Where does the accent color appear? (Typically at focal points, intersections, or small detail elements)
   - What color is the ground/background?

**Example Mapping:**
```
Islamic Star Pattern:
- Star forms: turquoise (dominant)
- Interlocking geometric ground: white (secondary)
- Star center details: cobalt blue (accent)
- Outline/border: gold (detail)
→ Color follows form strictly — each geometric shape is one flat color
```

**Got:** A structural description with explicit color assignments for each structural element.

**If fail:** If the color-to-structure mapping is unclear, study historical examples using WebSearch for "[period] [motif] ornament color" and observe how color was actually used. Historical ornament almost always uses color to clarify structure, not obscure it.

### Step 4: Construct Color Prompt

Build the text prompt for Z-Image generation, incorporating color palette and rendering style.

**Prompt Template:**
```
[Rendering style] of [motif name] ornament in the [period] style,
[composition type], [color palette description],
[color mood], [structural details from Step 3],
[application context], [additional qualifiers]
```

**Color-Appropriate Rendering Styles:**
- `painted ornament` — brushwork visible, opaque colors, fresco or oil quality
- `illuminated manuscript` — gold leaf, rich jewel tones, vellum ground
- `glazed ceramic tile` — glossy surface, flat color, precise edges
- `stained glass` — translucent color, dark leading lines between shapes
- `watercolor illustration` — transparent washes, soft edges, paper visible
- `enamel on metal` — hard glossy color, metallic ground
- `mosaic` — small tesserae, visible gaps between pieces, luminous
- `printed poster` — flat color areas, Art Nouveau or Arts & Crafts quality

**Color Description in Prompts:**
- Name specific colors: "turquoise blue and gold on white ground"
- Describe the mood: "muted antique tones" or "vivid saturated jewel colors"
- Specify distribution: "blue dominant with gold accents" or "warm earth tones with red details"

**Example Prompts:**
- `glazed ceramic tile ornament in the Islamic style, geometric star pattern, turquoise blue and white with cobalt blue accents and gold outlines, vivid saturated colors, repeating tessellation, Iznik tilework quality`
- `illuminated manuscript border in the Gothic style, vine and trefoil ornament, ultramarine blue and ruby red with gold leaf details on cream vellum, rich jewel tones, vertical panel, medieval book of hours quality`
- `watercolor illustration of Art Nouveau floral ornament, whiplash curves with lily motif, sage green and dusty rose with amber gold accents, muted organic tones, vertical panel, Alphonse Mucha influence`

**Got:** A prompt of 25-50 words that specifies rendering style, motif, period, composition, and explicit color information.

**If fail:** If the prompt produces color that does not match the palette, front-load the color description in the prompt (put it before the motif description). Z-Image weights earlier prompt tokens more heavily. Also try naming specific hex colors or well-known pigment names (ultramarine, vermillion, ochre).

### Step 5: Configure Generation Parameters

Select resolution and generation parameters. Color ornament often benefits from slightly more inference steps than monochrome.

```
Resolution by Application (same as ornament-style-mono):
┌────────────────────┬─────────────────────┬────────────────────────────────┐
│ Application        │ Recommended         │ Rationale                      │
├────────────────────┼─────────────────────┼────────────────────────────────┤
│ Medallion / Roundel│ 1024x1024 (1:1)     │ Radial symmetry needs square   │
│ Tile / Repeat Unit │ 1024x1024 (1:1)     │ Square for seamless tiling     │
│ Horizontal Frieze  │ 1280x720 (16:9)     │ Wide format for running border │
│ Vertical Panel     │ 720x1280 (9:16)     │ Portrait format for columns    │
│ Wide Border        │ 1344x576 (21:9)     │ Ultrawide for architectural    │
│ General / Flexible │ 1152x896 (9:7)      │ Balanced landscape format      │
│ Large Detail       │ 1536x1536 (1:1)     │ Higher res for fine color work │
└────────────────────┴─────────────────────┴────────────────────────────────┘
```

1. Select resolution based on application context
2. Set `steps` to 10-12 for color work (color detail and palette accuracy benefit from more steps)
3. Set `shift` to 3 (default)
4. Choose `random_seed: true` for exploration or `random_seed: false` with a specific seed for reproducibility
5. Record all parameters for documentation

**Got:** A complete parameter set. Note that color ornament generally needs 10+ steps for good palette fidelity.

**If fail:** If unsure, use 1024x1024 at 10 steps. This is a reliable default for most color ornament contexts.

### Step 6: Generate Image

Invoke the Z-Image MCP tool to produce the ornament.

1. Call `mcp__hf-mcp-server__gr1_z_image_turbo_generate` with:
   - `prompt`: the constructed prompt from Step 4
   - `resolution`: from Step 5
   - `steps`: from Step 5 (recommend 10-12)
   - `shift`: from Step 5
   - `random_seed`: from Step 5
   - `seed`: specific seed if `random_seed` is false
2. Record the returned seed value for reproducibility
3. Note the generation time

**Got:** A generated image with recognizable ornamental forms and visible color. The color may not perfectly match the specified palette — this is addressed in evaluation.

**If fail:** If the MCP tool is unavailable, verify that hf-mcp-server is configured (see `configure-mcp-server` or `troubleshoot-mcp-connection`). If the generated image is entirely abstract, the prompt needs more specific structural language — return to Step 4. If colors are completely wrong, front-load the color names in the prompt.

### Step 7: Evaluate Color Fidelity

Assess the generated image against five criteria, extending the monochrome rubric with color-specific evaluation.

```
Polychromatic Ornament Evaluation Rubric:
┌─────────────────────┬───────────────────────────────────────────────────────┐
│ Criterion           │ Evaluation Questions                                  │
├─────────────────────┼───────────────────────────────────────────────────────┤
│ 1. Palette Match    │ Do the colors in the image approximate the specified  │
│                     │ palette? Are the named colors present? Are there      │
│                     │ unwanted colors that break the palette?               │
├─────────────────────┼───────────────────────────────────────────────────────┤
│ 2. Color            │ Does the color distribution roughly follow the        │
│    Distribution     │ 60/30/10 allocation? Is the dominant color actually   │
│                     │ dominant? Does the accent appear sparingly?           │
├─────────────────────┼───────────────────────────────────────────────────────┤
│ 3. Rendering Style  │ Does the image look like the specified rendering      │
│                     │ style? Does a "glazed tile" look glossy and flat?     │
│                     │ Does "illuminated manuscript" show gold and vellum?   │
├─────────────────────┼───────────────────────────────────────────────────────┤
│ 4. Period Accuracy  │ Would this design be recognizable as belonging to     │
│                     │ the specified period? Are motifs period-appropriate?   │
│                     │ Does the color usage match period conventions?        │
├─────────────────────┼───────────────────────────────────────────────────────┤
│ 5. Form-Color       │ Does color clarify the ornamental structure or        │
│    Balance          │ obscure it? Can you "read" the motifs through the     │
│                     │ color? Does color follow form as intended?            │
└─────────────────────┴───────────────────────────────────────────────────────┘
```

1. Score each criterion: **Strong** (clearly meets), **Adequate** (partially meets), **Weak** (does not meet)
2. Note specific observations for each criterion
3. If 4+ criteria score Strong, the design is successful
4. If 2+ criteria score Weak, return to Step 4 for prompt refinement

**Got:** A scored evaluation with specific observations. Color ornament is harder to control than monochrome — expect Adequate scores on first generation for palette match and distribution.

**If fail:** If most criteria score Weak, the prompt may need fundamental restructuring. Common fixes: move color names to the very beginning of the prompt, use fewer colors, specify the ground color explicitly, increase steps to 12.

### Step 8: Iterate or Finalize

Refine the design through targeted iteration or accept the result.

**Color-Specific Iteration Strategies:**
1. **Palette correction**: If colors are wrong, put specific color names at the start of the prompt: "turquoise blue and gold: [rest of prompt]"
2. **Distribution correction**: Explicitly state proportions: "mostly turquoise blue with small gold accents"
3. **Rendering correction**: Strengthen the rendering style description: "in the style of Iznik ceramic tiles, glossy glaze surface"
4. **Seed-locked color tuning**: Keep the seed, change only the color description to adjust palette while maintaining composition
5. **Mood shift**: Change "vivid saturated" to "muted antique" or vice versa to adjust overall color intensity

**Iteration Budget:** Limit to 3 iterations per design concept. Color iteration often requires more prompt adjustment than monochrome.

1. If the evaluation in Step 7 indicates specific weaknesses, apply the corresponding correction strategy
2. Regenerate using Step 6
3. Re-evaluate using Step 7
4. Accept when 4+ criteria score Strong or iteration budget is exhausted

**Got:** Improved color fidelity after 1-2 iterations. Perfect palette match is unlikely — aim for "recognizably in the right color family."

**If fail:** If iteration is not converging, the color palette may be too specific for the model to reproduce reliably. Simplify to fewer colors (3 instead of 5), use broader color descriptions ("warm earth tones" instead of specific hex values), or accept the closest approximation.

### Step 9: Document the Design

Create a complete record of the final design for reproducibility and reference.

1. Record the following:
   - **Period**: Historical period name and date range
   - **Motif**: Primary motif(s) used
   - **Rendering Style**: Painted, illuminated, glazed tile, etc.
   - **Color Palette**: Each color with its role and approximate hex value
     - Dominant: [color name] (~hex) — 60%
     - Secondary: [color name] (~hex) — 30%
     - Accent: [color name] (~hex) — 10%
     - Additional: [color name] (~hex) — detail/metallic
   - **Color Harmony**: Approach used (period-authentic, complementary, analogous, triadic)
   - **Color Mood**: Muted, balanced, or vivid
   - **Final Prompt**: The exact prompt that produced the accepted image
   - **Seed**: The seed value for reproduction
   - **Resolution**: The resolution used
   - **Steps/Shift**: Generation parameters
   - **Evaluation**: Brief notes on the five criteria scores
   - **Iterations**: Number of iterations and key changes made
2. Note how the generated palette compares to the historical reference palette
3. Note any color-specific observations (colors the model handled well or poorly)
4. Suggest potential applications and color adaptation notes (e.g., "palette would adapt well to screen display" or "would need adjustment for CMYK print")

**Got:** A reproducible record with full color documentation including hex approximations and palette analysis.

**If fail:** If full documentation feels excessive, at minimum record the final prompt, seed, and a list of intended vs. actual colors. These allow reproduction and palette adjustment in future iterations.

## Validation

- [ ] A specific historical period was selected with its characteristic color palette identified
- [ ] A 3-5 color palette was defined with roles (dominant/secondary/accent) and proportions
- [ ] Color harmony approach was consciously chosen (period-authentic, complementary, analogous, triadic)
- [ ] Motif structure was analyzed with color-to-structure mapping
- [ ] Prompt includes explicit color names and color mood description
- [ ] Prompt specifies a color-appropriate rendering style (painted, glazed, illuminated, etc.)
- [ ] Resolution matches the application context
- [ ] Steps set to 10+ for color fidelity
- [ ] Generated image was evaluated against the 5-point rubric
- [ ] Seed value was recorded for reproducibility
- [ ] Final design is documented with prompt, seed, palette (with hex approximations), and parameters

## Pitfalls

- **Relying on color names alone**: "Blue" is ambiguous — specify "turquoise blue," "cobalt blue," or "ultramarine blue." Different blues evoke entirely different periods and moods
- **Too many colors**: More than 5 colors in a prompt confuses the model and produces muddy results. Historical ornament typically uses 3-4 colors plus a ground. Restraint is authentic
- **Ignoring the ground color**: The background/ground color is as important as the motif colors. Cream vellum, white ceramic, gold leaf, or dark stone ground fundamentally changes how all other colors read. Specify it explicitly
- **Color without structural basis**: Adding color to poorly structured ornament does not improve it. If the monochrome version does not work, adding color will not help — fix the structure first using `ornament-style-mono`
- **Anachronistic palettes**: Bright magenta, neon colors, or candy pastels do not belong in historical ornament. Pigment availability constrains period palettes — respect the constraint for authentic results
- **Insufficient steps**: Color detail needs more inference steps than monochrome. Using 8 steps for color work often produces washed-out or imprecise palette rendering. Use 10-12

## Related Skills

- `ornament-style-mono` — the monochrome foundation skill; available as a fallback when color is not cooperating, and recommended as a first step for understanding motif structure before adding color
- `review-web-design` — color theory principles (contrast, harmony, rhythm) apply directly to ornamental color composition
- `meditate` — focused attention and color visualization practices can inform palette development

Related Skills

ornament-style-mono

9
from pjt222/agent-almanac

Design monochrome ornamental patterns grounded in Alexander Speltz's classical ornament taxonomy. Covers historical period selection, motif structural analysis, prompt construction for line art and silhouette rendering, and AI-assisted image generation via Z-Image. Use when creating decorative borders, medallions, or friezes in a single color, exploring historical ornament styles through generative AI, producing line art or pen-and-ink renderings of classical motifs, or generating reference imagery for design or educational materials.

ornament-style-modern

9
from pjt222/agent-almanac

Design ornamental patterns using modern and speculative aesthetics with colorblind-accessible color scales. Breaks free from historical period constraints to explore cyberpunk, solarpunk, biopunk, brutalist, vaporwave, and other contemporary genres. Includes CVD (Color Vision Deficiency) awareness and perceptually uniform scales (viridis, cividis, inferno). Use when creating ornamental designs in modern or genre-specific aesthetics, designing patterns that must be colorblind-accessible, or exploring hybrid motifs combining historical ornament with contemporary visual language.

skill-name-here

9
from pjt222/agent-almanac

One to three sentences describing what this skill accomplishes, followed by key activation triggers. This field is the primary mechanism agents use to decide whether to activate the skill — it is read during discovery before the full body is loaded. Start with a verb. Include the most important "when to use" conditions inline. Max 1024 characters.

write-vignette

9
from pjt222/agent-almanac

Create R package vignettes using R Markdown or Quarto. Covers vignette setup, YAML configuration, code chunk options, building and testing, and CRAN requirements for vignettes. Use when adding a Getting Started tutorial, documenting complex workflows spanning multiple functions, creating domain-specific guides, or when CRAN submission requires user-facing documentation beyond function help pages.

write-validation-documentation

9
from pjt222/agent-almanac

Write IQ/OQ/PQ validation documentation for computerized systems in regulated environments. Covers protocols, reports, test scripts, deviation handling, and approval workflows. Use when validating R or other software for regulated use, preparing for a regulatory audit, documenting qualification of computing environments, or creating and updating validation protocols and reports for new or re-qualified systems.

write-testthat-tests

9
from pjt222/agent-almanac

Write comprehensive testthat (edition 3) tests for R package functions. Covers test organization, expectations, fixtures, mocking, snapshot tests, parameterized tests, and achieving high coverage. Use when adding tests for new package functions, increasing test coverage for existing code, writing regression tests for bug fixes, or setting up test infrastructure for a package that lacks it.

write-standard-operating-procedure

9
from pjt222/agent-almanac

Write a GxP-compliant Standard Operating Procedure (SOP). Covers regulatory SOP template structure (purpose, scope, definitions, responsibilities, procedure, references, revision history), approval workflow design, periodic review scheduling, and operational procedures for system use. Use when a new validated system requires operational procedures, when existing informal procedures need formalisation, when an audit finding cites missing procedures, when a change control triggers SOP updates, or when periodic review identifies outdated procedural content.

write-roxygen-docs

9
from pjt222/agent-almanac

Write roxygen2 documentation for R package functions, datasets, and classes. Covers all standard tags, cross-references, examples, and generating NAMESPACE entries. Follows tidyverse documentation style. Use when adding documentation to new exported functions, documenting internal helpers or datasets, documenting S3/S4/R6 classes and methods, or fixing documentation-related R CMD check notes.

write-incident-runbook

9
from pjt222/agent-almanac

Create structured incident runbooks with diagnostic steps, resolution procedures, escalation paths, and communication templates for effective incident response. Use when documenting response procedures for recurring alerts, standardizing incident response across an on-call rotation, reducing MTTR with clear diagnostic steps, creating training materials for new team members, or linking alert annotations directly to resolution procedures.

write-helm-chart

9
from pjt222/agent-almanac

Create production-ready Helm charts for Kubernetes application deployment with templating, values management, chart dependencies, hooks, and testing. Covers chart structure, Go template syntax, values.yaml design, chart repositories, versioning, and best practices for maintainable and reusable charts. Use when packaging a Kubernetes application for repeatable deployments, parameterizing manifests for multiple environments, managing complex multi-component applications with dependencies, or standardizing deployment practices with versioned rollback capability across teams.

write-continue-here

9
from pjt222/agent-almanac

Write a CONTINUE_HERE.md file capturing current session state so a fresh Claude Code session can pick up where this one left off. Covers assessing recent work, structuring the continuation file with objective, completed, in-progress, next-steps, and context sections, and verifying the file is actionable. Use when ending a session with unfinished work, handing off context between sessions, or preserving task state that git alone cannot capture.

write-claude-md

9
from pjt222/agent-almanac

Create an effective CLAUDE.md file that provides project-specific instructions to AI coding assistants. Covers structure, common sections, do/don't patterns, and integration with MCP servers and agent definitions. Use when starting a new project where AI assistants will be used, improving AI behavior on an existing project, documenting project conventions and constraints, or integrating MCP servers or agent definitions into a project workflow.