Advanced Writing Assets

Once you’ve mastered the basics of Writing Assets, you can create sophisticated configurations that give the AI precise control over tone, vocabulary, and style for different product categories. This guide shows you how to build advanced JSON assets for professional-grade content generation.

How Advanced Assets Work

All your Writing Assets are automatically included in every AI request. When you create an advanced JSON asset and save it in Settings → Writing Knowledge, it’s immediately available to the AI the next time you process products.

The system prompt includes {{ASSETS}} by default, which injects all your assets. This means:

Create an asset → It’s automatically used
No prompt changes required
The AI receives your asset’s purpose and full content

Need custom prompt behavior? If you want the system prompt to reference your advanced assets in a specific way (e.g., matching category tone profiles to product categories), contact your merchi.ai customer success team.

When to Use Advanced Assets

Advanced JSON assets are ideal when you need:

Category-specific tone - Different voice for dresses vs. activewear
Brand lexicon control - Enforce preferred terminology across all content
Golden examples - Show the AI exactly what good output looks like
Multi-tier quality descriptors - Different vocabulary for different product tiers

Asset 1: Category Tone Profiles

This JSON asset tells the AI exactly how to adjust its writing style based on product category.

Why It Matters

A description for a luxury evening gown should sound different from athletic leggings. Category tone profiles let you define:

Formality level (1-10 scale)
Technical vs. emotional emphasis
Vocabulary tier (casual, elevated, luxury-technical)
Sentence structure preferences
Key focuses for each category
Words to embrace and avoid

Example Structure

Asset Name: Category Tone Profiles
Asset Type: JSON

{
  "tone_profiles": {
    "ready_to_wear": {
      "dresses": {
        "formality_level": 8,
        "technical_detail_emphasis": 6,
        "emotional_appeal_emphasis": 9,
        "sentence_structure": "flowing, medium-long",
        "vocabulary_tier": "elevated",
        "key_focuses": ["silhouette", "drape", "occasion", "craftsmanship", "movement"],
        "typical_opener_patterns": [
          "Crafted from [fabric], this [item]...",
          "Cut to [silhouette description], this [item]...",
          "[Fabric/detail] defines this [item]...",
          "Fluid [fabric] creates [effect] in this...",
          "This [item] features [distinctive element]..."
        ],
        "avoid_in_this_category": ["sporty", "practical", "everyday", "basic", "casual"],
        "embrace_in_this_category": ["elegant", "refined", "sophisticated", "timeless", "graceful"]
      },
      "tops": {
        "formality_level": 6,
        "technical_detail_emphasis": 5,
        "emotional_appeal_emphasis": 7,
        "sentence_structure": "balanced, medium",
        "vocabulary_tier": "accessible-elevated",
        "key_focuses": ["versatility", "fit", "fabric", "styling potential"],
        "typical_opener_patterns": [
          "This [item] pairs [feature] with [feature]...",
          "Crafted in [fabric], this [item]...",
          "[Detail] meets [detail] in this...",
          "Refined [fabric] shapes this..."
        ],
        "avoid_in_this_category": ["overly formal", "restrictive", "stiff"],
        "embrace_in_this_category": ["versatile", "polished", "refined", "effortless", "essential"]
      },
      "knitwear": {
        "formality_level": 6,
        "technical_detail_emphasis": 7,
        "emotional_appeal_emphasis": 8,
        "sentence_structure": "warm, medium",
        "vocabulary_tier": "crafted-tactile",
        "key_focuses": ["texture", "fiber quality", "knit technique", "comfort", "tactile appeal"],
        "typical_opener_patterns": [
          "Knitted from [fiber], this [item]...",
          "Soft [fiber] creates [texture] in this...",
          "This [item] features [knit detail]...",
          "Luxurious [fiber] shapes this..."
        ],
        "avoid_in_this_category": ["stiff", "formal", "rigid", "structured"],
        "embrace_in_this_category": ["supple", "luxurious", "sumptuous", "tactile", "soft"]
      }
    },
    "accessories": {
      "handbags": {
        "formality_level": 9,
        "technical_detail_emphasis": 8,
        "emotional_appeal_emphasis": 7,
        "sentence_structure": "precise, medium-short",
        "vocabulary_tier": "luxury-technical",
        "key_focuses": ["craftsmanship", "hardware", "capacity", "heritage", "materials"],
        "typical_opener_patterns": [
          "Crafted from [leather type], this [item]...",
          "This [item] features [signature detail]...",
          "[Number] hours of craftsmanship define this...",
          "Meticulously constructed from [material], this..."
        ],
        "avoid_in_this_category": ["trendy", "fun", "playful", "casual"],
        "embrace_in_this_category": ["timeless", "heirloom", "meticulous", "iconic", "artisanal"]
      }
    },
    "activewear": {
      "performance_wear": {
        "formality_level": 4,
        "technical_detail_emphasis": 9,
        "emotional_appeal_emphasis": 6,
        "sentence_structure": "dynamic, short-medium",
        "vocabulary_tier": "performance-focused",
        "key_focuses": ["functionality", "innovation", "movement", "technology", "performance"],
        "typical_opener_patterns": [
          "Engineered for [activity], this [item]...",
          "Technical [fabric] delivers [benefit] in this...",
          "This [item] features [technology]...",
          "Performance-focused [item] combines..."
        ],
        "avoid_in_this_category": ["delicate", "precious", "formal", "restrictive"],
        "embrace_in_this_category": ["dynamic", "responsive", "innovative", "performance-driven"]
      }
    }
  }
}

How the AI Uses This Asset

Once you save this asset, the AI receives it as part of {{ASSETS}} and can reference the tone profile that matches your product’s category. The AI will:

Match formality level to the category
Use appropriate vocabulary tier
Follow opener patterns for variety
Avoid words marked for that category
Embrace the recommended terminology

Want category-specific logic? Contact your merchi.ai customer success team to have the system prompt explicitly match products to their tone profiles using your CSV category columns.

Asset 2: Brand Lexicon

A brand lexicon ensures consistent terminology across all generated content.

Why It Matters

Enforces brand-specific language choices
Prevents off-brand vocabulary
Maintains consistency across thousands of products
Defines category-specific terminology

Example Structure

Asset Name: Brand Lexicon
Asset Type: JSON

{
  "brand_lexicon": {
    "global_preferences": {
      "preferred_terms": {
        "trousers": "not 'pants'",
        "knitwear": "not 'sweater' or 'jumper'",
        "crafted": "preferred over 'made'",
        "features": "not 'has'",
        "showcases": "not 'shows'",
        "full-grain leather": "not 'genuine leather'",
        "hand-finished": "not 'handmade'",
        "tailored": "not 'fitted'"
      },
      "signature_phrases": [
        "handcrafted in [location]",
        "heritage craftsmanship",
        "timeless design",
        "meticulous attention to detail",
        "refined sophistication"
      ],
      "forbidden_words": [
        "cheap",
        "affordable",
        "budget",
        "trendy",
        "fast fashion",
        "bargain",
        "discount",
        "sale"
      ]
    },
    "category_specific": {
      "leather_goods": {
        "preferred": ["full-grain leather", "hand-stitched", "artisanal", "patina", "vegetable-tanned"],
        "avoid": ["vinyl", "pleather", "synthetic", "faux leather"]
      },
      "silk_garments": {
        "preferred": ["silk twill", "silk charmeuse", "mulberry silk", "pure silk", "lustrous silk"],
        "avoid": ["shiny", "slippery", "silky", "satin-like"]
      },
      "knitwear": {
        "preferred": ["superfine", "pure cashmere", "merino wool", "tactile", "sumptuous"],
        "avoid": ["woolly", "fuzzy", "cozy", "chunky knit"]
      }
    },
    "quality_descriptors": {
      "tier_1_luxury": ["exceptional", "extraordinary", "unparalleled", "incomparable"],
      "tier_2_luxury": ["exquisite", "refined", "superior", "distinguished"],
      "tier_3_luxury": ["quality", "fine", "premium", "elevated"]
    },
    "fabric_descriptions": {
      "cotton": ["finest Egyptian cotton", "premium cotton", "long-staple cotton"],
      "cashmere": ["pure cashmere", "superfine cashmere", "grade-A cashmere"],
      "leather": ["full-grain leather", "Italian leather", "vegetable-tanned leather"],
      "silk": ["pure silk", "Italian silk", "silk twill", "mulberry silk"]
    }
  }
}

How the AI Uses This Asset

The AI receives your brand lexicon and applies it across all content generation:

Uses preferred terms instead of alternatives
Incorporates signature phrases naturally
Avoids forbidden words completely
Matches quality descriptors to product positioning

Asset 3: Golden Examples

Golden examples show the AI exactly what excellent output looks like, with explanations of why each example works.

Why It Matters

Provides concrete reference points
Shows the balance between technical and emotional content
Demonstrates your brand voice in action
Helps the AI understand nuanced quality expectations

Example Structure

Asset Name: Golden Examples
Asset Type: JSON

{
  "approved_examples": {
    "ready_to_wear": {
      "dresses": [
        {
          "product_id": "EXAMPLE_DRESS_001",
          "category": "Evening Dress",
          "title": "Silk Twill Midi Dress in Midnight Navy",
          "description": "Cut from pure silk twill, this midi dress embodies refined elegance. The fluid silhouette drapes beautifully, while the self-tie belt defines the waist with subtle sophistication.\n\nHand-finished seams and a concealed back zipper showcase the house's commitment to meticulous craftsmanship. The rich midnight navy hue transitions seamlessly from day to evening.",
          "why_this_works": "Fabric-first opening, formality level 8/10, balance of technical (hand-finished seams) and emotional (refined elegance), focus on silhouette and craftsmanship"
        },
        {
          "product_id": "EXAMPLE_DRESS_002",
          "category": "Day Dress",
          "title": "Cotton Poplin Shirt Dress in White",
          "description": "Crisp cotton poplin defines this shirt dress, featuring a tailored silhouette with a gently cinched waist. Mother-of-pearl buttons and French seams showcase refined detailing.\n\nThe classic white finish offers timeless versatility, while the structured collar and three-quarter sleeves add sophisticated polish to this wardrobe essential.",
          "why_this_works": "Even 'casual' categories maintain elevated tone, specific materials named (mother-of-pearl, cotton poplin), 'wardrobe essential' positions as investment"
        }
      ],
      "knitwear": [
        {
          "product_id": "EXAMPLE_KNIT_001",
          "category": "Sweater",
          "title": "Cashmere Crewneck in Navy",
          "description": "Knitted from superfine Italian cashmere, this crewneck offers sumptuous softness and enduring quality. The classic silhouette features ribbed trims and a regular fit that layers effortlessly.\n\nEach piece undergoes meticulous finishing, ensuring the tactile luxury cashmere is renowned for. The rich navy hue complements any wardrobe.",
          "why_this_works": "Tactile language (sumptuous, softness), fiber quality emphasized, craft process mentioned (meticulous finishing), emotional emphasis 8/10"
        }
      ]
    },
    "accessories": {
      "handbags": [
        {
          "product_id": "EXAMPLE_BAG_001",
          "category": "Tote",
          "title": "Structured Leather Tote in Black",
          "description": "Crafted from full-grain Italian leather, this tote embodies timeless sophistication. The structured silhouette features signature hardware and a meticulously organized interior with multiple compartments.\n\nEach piece requires over 12 hours of artisanal craftsmanship, from hand-cutting the leather to the final hand-stitched details. The rich black finish develops a beautiful patina over time.",
          "why_this_works": "Formality 9/10 for accessories, craftsmanship quantified (12 hours), heirloom positioning (patina over time), technical precision (full-grain, hand-cutting)"
        }
      ]
    },
    "activewear": {
      "performance_wear": [
        {
          "product_id": "EXAMPLE_ACTIVE_001",
          "category": "Leggings",
          "title": "Technical Stretch Leggings in Black",
          "description": "Engineered for dynamic movement, these leggings feature four-way stretch fabric with moisture-wicking technology. The high-rise waistband provides secure support, while flatlock seams eliminate chafing during intensive workouts.\n\nConcealed pockets and reflective details add functional versatility to this performance-focused essential.",
          "why_this_works": "Technical language (engineered, four-way stretch, moisture-wicking), formality lower at 4/10, benefits concrete and specific, still maintains quality positioning"
        }
      ]
    }
  }
}

How the AI Uses This Asset

The AI studies your golden examples to understand:

The right tone and structure for each category
How to balance technical and emotional content
Your specific formatting preferences
What “excellent” looks like for your brand

The why_this_works explanations help the AI understand principles, not just mimic patterns.

Combining Multiple Advanced Assets

You can create all three assets, and they’ll all be included automatically via {{ASSETS}}. The AI receives them together and applies the guidance holistically:

Brand Lexicon - Sets the vocabulary rules
Category Tone Profiles - Adjusts style per category
Golden Examples - Shows what great output looks like

This combination provides comprehensive guidance without requiring any system prompt changes.

Best Practices for Advanced Assets

Keep Structures Consistent

Use the same JSON structure across all products you process. The AI learns patterns better with consistent formatting.

Include Reasoning

In golden examples, always explain WHY something works. This helps the AI understand principles, not just copy patterns.

Be Specific About Numbers

Formality levels, emphasis scales, and quantified details (like “12 hours of craftsmanship”) give the AI concrete guidance.

Update Regularly

As your brand evolves, update your advanced assets. What worked last season may need refinement.

Test Incrementally

Add one advanced asset at a time and review output before adding more. This helps you understand the impact of each asset.

Working with Customer Success

While your assets are automatically included, the merchi.ai customer success team can help with advanced configurations:

Category matching logic - Have the system prompt match products to specific tone profiles based on your CSV columns
Conditional asset usage - Apply different assets based on product attributes
Custom variable references - Reference specific assets in particular prompt sections

Contact your Customer Success representative to discuss advanced prompt customizations.

Troubleshooting

Output Not Matching Tone Profile

Verify your category names in the JSON match how products are categorized
Check that formality_level and emphasis scores are calibrated correctly
Add more specific opener patterns for the AI to follow
Ensure the asset is saved and appears in Writing Knowledge

Forbidden Words Still Appearing

Ensure the forbidden_words list is comprehensive
Add variations and related terms
Consider adding these to a separate “Stop Words” list asset as well

Golden Examples Not Being Followed

Add more examples per category (3-5 is ideal)
Make sure the “why_this_works” explanations are detailed
Check that the example category matches your product category

Quick Reference

Asset	Purpose	Key Elements
Category Tone Profiles	Adjust voice per category	Formality, vocabulary tier, opener patterns
Brand Lexicon	Enforce terminology	Preferred terms, forbidden words, quality descriptors
Golden Examples	Show ideal output	Complete examples with explanations

These advanced assets work together to give the AI a complete picture of your brand voice and quality expectations, resulting in consistently excellent content across all product categories.

Writing Knowledge - Learn the basics of creating Writing Assets
Template Variables (MSL) - Understand how assets are referenced in the system prompt

How Advanced Assets Work

When to Use Advanced Assets

Asset 1: Category Tone Profiles

Why It Matters

Example Structure

How the AI Uses This Asset

Asset 2: Brand Lexicon

Why It Matters

Example Structure

How the AI Uses This Asset

Asset 3: Golden Examples

Why It Matters

Example Structure

How the AI Uses This Asset

Combining Multiple Advanced Assets

Best Practices for Advanced Assets

Keep Structures Consistent

Include Reasoning

Be Specific About Numbers

Update Regularly

Test Incrementally

Working with Customer Success

Troubleshooting

Output Not Matching Tone Profile

Forbidden Words Still Appearing

Golden Examples Not Being Followed

Quick Reference

Related Topics

Related articles