@justin_666/square-couplets-master-skills 1.0.16 → 1.0.17

package/dist/constants.js

@@ -46,7 +46,7 @@ Lighting: soft studio lighting, gentle glow on gold details, museum-quality artw
 Composition: 
 The diamond-shaped Doufang fills the majority of the 1:1 frame, centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping).
 The entire artwork is fully visible inside the frame, not touching any edge, not cropped, not cut off.
-The Doufang should occupy 85-95% of the image area, maximizing visual impact.
+The Doufang should occupy 95% of the image area, maximizing visual impact.
 Clean background, symmetrical, perfectly framed, suitable for printing and hanging on wall.
 
 Quality: ultra high detail, 8k, masterpiece, professional artwork, 1:1 aspect ratio.
@@ -54,7 +54,7 @@ Quality: ultra high detail, 8k, masterpiece, professional artwork, 1:1 aspect ra
 Framing requirements:
 - The entire diamond-shaped Doufang must be fully visible inside the image.
 - No part of the artwork is cut off, cropped, out of frame, or touching the image borders.
-- Minimal margins - the Doufang should fill most of the frame (85-95% of image area).
+- Minimal margins - the Doufang should fill most of the frame ( 95% of image area).
 
 Text requirements:
 - The Chinese characters must be clear, correct, readable.
@@ -144,7 +144,7 @@ Your generated "imagePrompt" must follow this logic:
 1. **Framing**:
    - The entire diamond Doufang must be fully contained within the 1:1 frame.
    - Minimal, elegant margins - just enough to prevent edge cropping (approximately 2-5% of frame width).
-   - The Doufang should fill most of the frame (85-95% of the image area).
+   - The Doufang should fill most of the frame ( 95% of the image area).
    - No cropping, no touching edges, no cut-off.
 2. **Text Quality**:
    - Calligraphy must be clear, professional, and correctly written.
@@ -157,7 +157,7 @@ Your generated "imagePrompt" must follow this logic:
 Composition: 
 The diamond-shaped Doufang fills the majority of the 1:1 frame, centered with minimal elegant margins (just enough to prevent edge cropping, approximately 2-5% of frame width).
 The entire artwork is fully visible inside the frame, not touching any edge, not cropped, not cut off.
-The Doufang should occupy 85-95% of the image area, maximizing visual impact.
+The Doufang should occupy 95% of the image area, maximizing visual impact.
 Clean background, symmetrical, perfectly framed, suitable for printing and hanging on wall.
 
 Quality: ultra high detail, 8k, masterpiece, professional artwork, 1:1 aspect ratio.
@@ -165,7 +165,7 @@ Quality: ultra high detail, 8k, masterpiece, professional artwork, 1:1 aspect ra
 Framing requirements:
 - The entire diamond-shaped Doufang must be fully visible inside the image.
 - No part of the artwork is cut off, cropped, out of frame, or touching the image borders.
-- Minimal margins - the Doufang should fill most of the frame (85-95% of image area).
+- Minimal margins - the Doufang should fill most of the frame ( 95% of image area).
 
 Text requirements:
 - The Chinese characters must be clear, correct, readable.
@@ -228,7 +228,7 @@ export const getSimpleUserInputPrompt = (userKeyword) => {
 export const getImageGenerationPromptWithReference = (basePrompt) => {
     return `${basePrompt}
 
-IMPORTANT COMPOSITION NOTE: The diamond-shaped Doufang should fill 85-95% of the frame with minimal margins (2-5% of frame width). Avoid excessive white space or wide margins. Maximize the visual impact by making the Doufang artwork occupy most of the image area.
+IMPORTANT COMPOSITION NOTE: The diamond-shaped Doufang should fill 95% of the frame with minimal margins (2-5% of frame width). Avoid excessive white space or wide margins. Maximize the visual impact by making the Doufang artwork occupy most of the image area.
 
 Note: The reference image provided above should be used as a visual style guide. Follow the style, color palette, and artistic approach described in the prompt, which was generated based on analysis of this reference image.`;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justin_666/square-couplets-master-skills",
-  "version": "1.0.16",
+  "version": "1.0.17",
   "description": "Claude Agent Skills for generating Chinese New Year Doufang (diamond-shaped couplet) artwork using Google Gemini AI",
   "type": "module",
   "main": "bin/doufang-skills.js",

package/skills/generate-doufang-image/index.js

@@ -67,6 +67,30 @@ function findServicesPath() {
   return null;
 }
 
+// Load environment variables helper
+async function loadEnvironmentVariables() {
+  try {
+    const dotenv = await import('dotenv');
+    const envLocalPath = join(projectRoot, '.env.local');
+    const envPath = join(projectRoot, '.env');
+    const cwdEnvLocalPath = join(process.cwd(), '.env.local');
+    const cwdEnvPath = join(process.cwd(), '.env');
+
+    if (existsSync(envLocalPath)) {
+      dotenv.config({ path: envLocalPath });
+    } else if (existsSync(envPath)) {
+      dotenv.config({ path: envPath });
+    } else if (existsSync(cwdEnvLocalPath)) {
+      dotenv.config({ path: cwdEnvLocalPath });
+    } else if (existsSync(cwdEnvPath)) {
+      dotenv.config({ path: cwdEnvPath });
+    } else {
+      dotenv.config();
+    }
+  } catch (e) {
+    // dotenv not available, continue without it (will use environment variables)
+  }
+}
 
 async function main() {
   try {

package/skills/generate-doufang-prompt/SKILL.md

@@ -31,7 +31,7 @@ When user provides a keyword or wish phrase, generate a professional Doufang art
    - **Decorative elements**: Symbolic elements that visually represent the keyword (e.g., horse, dragon, pine tree, crane, gold ingots, clouds, mountains, sun, plum blossoms)
    - **Style**: Traditional Chinese ink painting mixed with realistic illustration, elegant, prestigious, festive but high-class
    - **Composition**: 
-     - Doufang fills 85-95% of the frame
+     - Doufang fills 95% of the frame
      - Centered with minimal elegant margins (2-5% of frame width, just enough to prevent edge cropping)
      - Fully visible inside the frame, not touching edges
    - **Quality**: Ultra high detail, 8k, masterpiece, professional artwork, 1:1 aspect ratio
@@ -56,7 +56,7 @@ When user provides a keyword or wish phrase, generate a professional Doufang art
 ```json
 {
   "blessingPhrase": "招財進寶",
-  "imagePrompt": "A diamond-shaped Chinese New Year Doufang couplet on antique gold-flecked red Xuan paper. Central theme: bold, powerful, energetic traditional Chinese ink wash calligraphy of the characters '招財進寶'. Around the calligraphy: symbolic elements that visually represent wealth - gold ingots, coins, treasure chests, and prosperity symbols, painted in traditional Chinese ink painting style. Style: traditional Chinese ink painting mixed with realistic illustration, elegant, prestigious, festive but high-class, not cartoon. Material & texture: real Xuan paper texture, gold flecks, red rice paper, visible paper fibers, natural ink diffusion, subtle embossed gold foil details. Color theme: deep Chinese red, gold, black ink, warm highlights. Lighting: soft studio lighting, gentle glow on gold details, museum-quality artwork. Composition: The diamond-shaped Doufang fills 85-95% of the 1:1 frame, centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping). The entire artwork is fully visible inside the frame, not touching any edge, not cropped, not cut off. Clean background, symmetrical, perfectly framed, suitable for printing and hanging on wall. Quality: ultra high detail, 8k, masterpiece, professional artwork, 1:1 aspect ratio."
+  "imagePrompt": "A diamond-shaped Chinese New Year Doufang couplet on antique gold-flecked red Xuan paper. Central theme: bold, powerful, energetic traditional Chinese ink wash calligraphy of the characters '招財進寶'. Around the calligraphy: symbolic elements that visually represent wealth - gold ingots, coins, treasure chests, and prosperity symbols, painted in traditional Chinese ink painting style. Style: traditional Chinese ink painting mixed with realistic illustration, elegant, prestigious, festive but high-class, not cartoon. Material & texture: real Xuan paper texture, gold flecks, red rice paper, visible paper fibers, natural ink diffusion, subtle embossed gold foil details. Color theme: deep Chinese red, gold, black ink, warm highlights. Lighting: soft studio lighting, gentle glow on gold details, museum-quality artwork. Composition: The diamond-shaped Doufang fills 95% of the 1:1 frame, centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping). The entire artwork is fully visible inside the frame, not touching any edge, not cropped, not cut off. Clean background, symmetrical, perfectly framed, suitable for printing and hanging on wall. Quality: ultra high detail, 8k, masterpiece, professional artwork, 1:1 aspect ratio."
 }
 ```
 
@@ -68,7 +68,7 @@ When user provides a keyword or wish phrase, generate a professional Doufang art
 ```json
 {
   "blessingPhrase": "延年益壽",
-  "imagePrompt": "A diamond-shaped Chinese New Year Doufang couplet on antique gold-flecked red Xuan paper. Central theme: bold, powerful, energetic traditional Chinese ink wash calligraphy of the characters '延年益壽'. Around the calligraphy: symbolic elements that visually represent health and longevity - pine trees, cranes, peaches, and bamboo, painted in traditional Chinese ink painting style. Style: traditional Chinese ink painting mixed with realistic illustration, elegant, prestigious, festive but high-class, not cartoon. Material & texture: real Xuan paper texture, gold flecks, red rice paper, visible paper fibers, natural ink diffusion, subtle embossed gold foil details. Color theme: deep Chinese red, gold, black ink, warm highlights. Lighting: soft studio lighting, gentle glow on gold details, museum-quality artwork. Composition: The diamond-shaped Doufang fills 85-95% of the 1:1 frame, centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping). The entire artwork is fully visible inside the frame, not touching any edge, not cropped, not cut off. Clean background, symmetrical, perfectly framed, suitable for printing and hanging on wall. Quality: ultra high detail, 8k, masterpiece, professional artwork, 1:1 aspect ratio."
+  "imagePrompt": "A diamond-shaped Chinese New Year Doufang couplet on antique gold-flecked red Xuan paper. Central theme: bold, powerful, energetic traditional Chinese ink wash calligraphy of the characters '延年益壽'. Around the calligraphy: symbolic elements that visually represent health and longevity - pine trees, cranes, peaches, and bamboo, painted in traditional Chinese ink painting style. Style: traditional Chinese ink painting mixed with realistic illustration, elegant, prestigious, festive but high-class, not cartoon. Material & texture: real Xuan paper texture, gold flecks, red rice paper, visible paper fibers, natural ink diffusion, subtle embossed gold foil details. Color theme: deep Chinese red, gold, black ink, warm highlights. Lighting: soft studio lighting, gentle glow on gold details, museum-quality artwork. Composition: The diamond-shaped Doufang fills 95% of the 1:1 frame, centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping). The entire artwork is fully visible inside the frame, not touching any edge, not cropped, not cut off. Clean background, symmetrical, perfectly framed, suitable for printing and hanging on wall. Quality: ultra high detail, 8k, masterpiece, professional artwork, 1:1 aspect ratio."
 }
 ```
 
@@ -80,13 +80,13 @@ When user provides a keyword or wish phrase, generate a professional Doufang art
 ```json
 {
   "blessingPhrase": "萬馬奔騰",
-  "imagePrompt": "A diamond-shaped Chinese New Year Doufang couplet on antique gold-flecked red Xuan paper. Central theme: bold, powerful, energetic traditional Chinese ink wash calligraphy of the characters '萬馬奔騰'. Around the calligraphy: symbolic elements that visually represent energy and vitality - galloping horses, flowing clouds, dynamic movement, painted in traditional Chinese ink painting style. Style: traditional Chinese ink painting mixed with realistic illustration, elegant, prestigious, festive but high-class, not cartoon. Material & texture: real Xuan paper texture, gold flecks, red rice paper, visible paper fibers, natural ink diffusion, subtle embossed gold foil details. Color theme: deep Chinese red, gold, black ink, warm highlights. Lighting: soft studio lighting, gentle glow on gold details, museum-quality artwork. Composition: The diamond-shaped Doufang fills 85-95% of the 1:1 frame, centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping). The entire artwork is fully visible inside the frame, not touching any edge, not cropped, not cut off. Clean background, symmetrical, perfectly framed, suitable for printing and hanging on wall. Quality: ultra high detail, 8k, masterpiece, professional artwork, 1:1 aspect ratio."
+  "imagePrompt": "A diamond-shaped Chinese New Year Doufang couplet on antique gold-flecked red Xuan paper. Central theme: bold, powerful, energetic traditional Chinese ink wash calligraphy of the characters '萬馬奔騰'. Around the calligraphy: symbolic elements that visually represent energy and vitality - galloping horses, flowing clouds, dynamic movement, painted in traditional Chinese ink painting style. Style: traditional Chinese ink painting mixed with realistic illustration, elegant, prestigious, festive but high-class, not cartoon. Material & texture: real Xuan paper texture, gold flecks, red rice paper, visible paper fibers, natural ink diffusion, subtle embossed gold foil details. Color theme: deep Chinese red, gold, black ink, warm highlights. Lighting: soft studio lighting, gentle glow on gold details, museum-quality artwork. Composition: The diamond-shaped Doufang fills 95% of the 1:1 frame, centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping). The entire artwork is fully visible inside the frame, not touching any edge, not cropped, not cut off. Clean background, symmetrical, perfectly framed, suitable for printing and hanging on wall. Quality: ultra high detail, 8k, masterpiece, professional artwork, 1:1 aspect ratio."
 }
 ```
 
 ## Key Requirements
 
-- The Doufang should fill **85-95% of the frame** (not less)
+- The Doufang should fill **95% of the frame** (not less)
 - Minimal margins: **2-5% of frame width** (just enough to prevent edge cropping)
 - **No excessive white space** or wide margins
 - Traditional Chinese artistic style (ink wash, calligraphy)

package/skills/optimize-doufang-prompt/SKILL.md

@@ -26,11 +26,11 @@ When user reports that generated images have excessive white margins, poor compo
    
    **Replace with:**
    - ✅ "centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping)"
-   - ✅ "minimal margins - the Doufang should fill most of the frame (85-95% of image area)"
-   - ✅ "The Doufang should occupy 85-95% of the image area, maximizing visual impact"
+   - ✅ "minimal margins - the Doufang should fill most of the frame (95% of image area)"
+   - ✅ "The Doufang should occupy 95% of the image area, maximizing visual impact"
 
 3. **Add explicit composition instructions:**
-   - Add: "The Doufang should fill 85-95% of the frame"
+   - Add: "The Doufang should fill 95% of the frame"
    - Add: "Minimal margins (2-5% of frame width)"
    - Add: "Maximize visual impact by making the Doufang occupy most of the frame"
    - Add: "Avoid excessive white space or wide margins"
@@ -61,7 +61,7 @@ When user reports that generated images have excessive white margins, poor compo
 
 **After:**
 ```
-"...The Doufang should occupy 85-95% of the image area, maximizing visual impact..."
+"...The Doufang should occupy 95% of the image area, maximizing visual impact..."
 ```
 
 ### Rule 3: Composition Emphasis
@@ -72,7 +72,7 @@ When user reports that generated images have excessive white margins, poor compo
 
 **After:**
 ```
-"...minimal margins - the Doufang should fill most of the frame (85-95% of image area)..."
+"...minimal margins - the Doufang should fill most of the frame (95% of image area)..."
 ```
 
 ## Examples
@@ -86,7 +86,7 @@ A diamond-shaped Chinese New Year Doufang centered in a 1:1 frame with wide whit
 
 **Optimized Prompt:**
 ```
-A diamond-shaped Chinese New Year Doufang fills the majority of the 1:1 frame, centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping). The Doufang should occupy 85-95% of the image area, maximizing visual impact. The artwork is a masterpiece of traditional ink-wash fusion...
+A diamond-shaped Chinese New Year Doufang fills the majority of the 1:1 frame, centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping). The Doufang should occupy 95% of the image area, maximizing visual impact. The artwork is a masterpiece of traditional ink-wash fusion...
 ```
 
 ### Example 2: Improving Composition Instructions
@@ -98,7 +98,7 @@ Composition: The diamond-shaped Doufang is fully visible and centered, with gene
 
 **Optimized Prompt:**
 ```
-Composition: The diamond-shaped Doufang fills 85-95% of the 1:1 frame, centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping). The entire artwork is fully visible inside the frame, not touching any edge, not cropped, not cut off. The Doufang should occupy most of the image area, maximizing visual impact. Clean background, symmetrical, perfectly framed, suitable for printing and hanging on wall.
+Composition: The diamond-shaped Doufang fills 95% of the 1:1 frame, centered with minimal elegant margins (approximately 2-5% of frame width, just enough to prevent edge cropping). The entire artwork is fully visible inside the frame, not touching any edge, not cropped, not cut off. The Doufang should occupy most of the image area, maximizing visual impact. Clean background, symmetrical, perfectly framed, suitable for printing and hanging on wall.
 ```
 
 ### Example 3: Complete Prompt Optimization
@@ -115,7 +115,7 @@ Framing requirements:
 ```
 Framing requirements:
 - The entire diamond-shaped Doufang must be fully visible inside the image.
-- Minimal margins - the Doufang should fill most of the frame (85-95% of image area).
+- Minimal margins - the Doufang should fill most of the frame (95% of image area).
 - No cropping, no touching edges, no cut-off.
 - Maximize visual impact by making the Doufang occupy most of the frame.
 ```
@@ -123,7 +123,7 @@ Framing requirements:
 ## Key Optimization Principles
 
 1. **Never use "wide" or "generous" margins** - Always specify minimal margins (2-5%)
-2. **Always specify frame fill percentage** - 85-95% of image area
+2. **Always specify frame fill percentage** - 95% of image area
 3. **Emphasize visual impact** - Over safety margins
 4. **Be specific about margin size** - "2-5% of frame width"
 5. **Clarify purpose** - "just enough to prevent edge cropping"