agentleFS
chengkj99chengkj99/kj-skills/.agents/skills/logo-generator/SKILL.md

logo-generator

Skill14 starsChanged 5 months agoMITView on GitHub

Generate professional SVG logos and high-end showcase images. Use when the user wants to: (1) Create a logo or icon for their product/brand, (2) Generate logo design concepts based on product information, (3) Create professional logo showcase presentations with multiple background styles, (4) Export logos in various formats (SVG, PNG), or (5) Iterate on logo designs with different visual styles. Supports geometric patterns, dot matrix designs, line systems, and mixed compositions. Generates showcase images using Nano Banana (Gemini image generation) with 12 professional background styles.

  • Reads credentials
  • Installs packages

3 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

23 rules. About 0 are common, 13 are distinctive, and 10 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈13

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 10

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask concise questions to gather this information.

    line 25
  2. Distinctive:

    Use different pattern types and combinations for diversity

    line 33
  3. Distinctive:

    Use viewBox="0 0 100 100" for easy scaling

    line 40
  4. Distinctive:

    Keep code clean and well-structured

    line 41
  5. Very specific:

    Use currentColor for flexible color control

    line 42
  6. Distinctive:

    Add subtle animations for web display (optional)

    line 43
  7. Very specific:

    Use the template from assets/showcase_template.html

    line 47
  8. Distinctive:

    Add design rationale for each variant

    line 49
  9. Very specific:

    Use scripts/svg_to_png.py to convert SVG to PNG

    line 70
  10. Distinctive:

    Default size: 1024x1024px

    line 71
  11. Very specific:

    Use scripts/generate_showcase.py with --all-styles flag

    line 81
  12. Distinctive:

    Use professional layout with micro-typography

    line 87
  13. Distinctive:

    Scalability: Ensure logos work at all sizes

    line 104
  14. Very specific:

    Keep viewBox at 0 0 100 100 for consistency

    line 112
  15. Very specific:

    Use semantic grouping with <g> tags

    line 113
  16. Very specific:

    Use <clipPath> for masking effects

    line 115
  17. Distinctive:

    Prefer geometric primitives over complex paths when possible

    line 116
  18. Distinctive:

    SVG not displaying correctly: Check viewBox and ensure all paths are closed

    line 187
  19. Very specific:

    PNG export fails: Verify cairosvg is installed (pip install cairosvg)

    line 189
  20. Very specific:

    Check .env file has valid GEMINI_API_KEY

    line 192
  21. Distinctive:

    Verify reference PNG exists and is readable

    line 193
  22. Distinctive:

    Check API quota/rate limits

    line 194
  23. Very specific:

    Third-party API not working: Ensure GEMINI_API_BASE_URL is correctly formatted (e.g., https://api.example.com/v1)

    line 196

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Logo Generator

Generate professional SVG logos and high-end showcase presentations for products and brands.

Workflow

Phase 1: Information Gathering

Collect essential information from the user:

  1. Product/Brand Name (required)
  2. Industry/Category (e.g., AI, fintech, design tools)
  3. Core Concept (e.g., connection, flow, security, simplicity)
  4. Design Preferences:
    • Style: minimal/complex, geometric/organic
    • Color preference: monochrome/specific colors
    • Mood: cold/warm, professional/friendly

Ask concise questions to gather this information. Don't overwhelm the user with too many questions at once.

Phase 2: Pattern Matching & SVG Generation

Based on the gathered information:

  1. Generate at least 6 design variants based on references/design_patterns.md
    • Match patterns to product characteristics
    • Use different pattern types and combinations for diversity
    • Include both single-pattern and mixed-pattern compositions
    • Vary complexity levels (simple geometric to layered compositions)
    • Each variant should feel distinctly different, not just parameter tweaks
    • Explain the design rationale for each variant
  2. Generate SVG code for each variant
    • Use viewBox="0 0 100 100" for easy scaling
    • Keep code clean and well-structured
    • Use currentColor for flexible color control
    • Add subtle animations for web display (optional)
  3. Create interactive showcase webpage
    • Display all 6+ logo variants in a grid layout
    • Use the template from assets/showcase_template.html
    • Include hover effects and smooth transitions
    • Add design rationale for each variant
    • Allow easy comparison between variants

Phase 3: Iteration & Refinement

Allow user to provide feedback:

  • Select favorite variants (narrow down from 6+ to 2-3)
  • Adjust specific parameters (size, spacing, rotation)
  • Combine elements from different variants
  • Change colors or add gradients
  • Modify animations or effects
  • Generate additional variants exploring specific directions

Make targeted adjustments based on feedback. Don't regenerate everything unless requested.

Phase 4: High-End Showcase Generation

Once the user selects a preferred logo direction:

  1. Export SVG to PNG
    • Use scripts/svg_to_png.py to convert SVG to PNG
    • Default size: 1024x1024px
    • Ensure transparent background
  2. Select showcase styles
    • Review references/background_styles.md
    • Recommend 4 styles based on product type and mood
    • Explain why each style fits
  3. Generate showcase images
    • Set up environment (copy .env.example to .env, add API key)
    • Use scripts/generate_showcase.py with --all-styles flag
    • Or generate specific styles individually
    • Each image uses the PNG as reference with Nano Banana API
  4. Create final presentation webpage
    • Combine SVG variants and showcase images
    • Use professional layout with micro-typography
    • Include download links for all assets

Phase 5: Delivery

Provide the user with:

  • Interactive HTML showcase page
  • SVG files (editable vector format)
  • PNG exports (various sizes if requested)
  • Showcase images (4 professional backgrounds)

Key Design Principles

  1. Provide Variety: Generate at least 6 distinct variants to give users real choices
  2. Start Simple: Begin with basic patterns, add complexity only when needed
  3. Meaningful Design: Connect visual elements to product concepts
  4. Scalability: Ensure logos work at all sizes
  5. Professional Quality: Match high-end brand identity standards
  6. Flexibility: Provide multiple variants for different use cases

Technical Notes

SVG Best Practices

  • Keep viewBox at 0 0 100 100 for consistency
  • Use semantic grouping with <g> tags
  • Leverage <defs> for reusable elements
  • Use <clipPath> for masking effects
  • Prefer geometric primitives over complex paths when possible

Showcase Image Generation

The generate_showcase.py script requires:

  • Python 3.8+
  • Dependencies: pip install -r requirements.txt
  • Environment variables in .env file
  • Reference PNG image (exported from SVG)

Supports both official Google Gemini API and third-party endpoints via GEMINI_API_BASE_URL.

Available Background Styles

From references/background_styles.md:

12 Professional Styles Available:

Dark Styles (6):

  • void (绝对虚空) - Absolute minimalism, hardcore tech
  • frosted (磨砂穹顶) - Modern breathing space, premium products
  • fluid (流体深渊) - AI-native fluidity, dynamic systems
  • spotlight (物理影棚) - Studio lighting, editorial quality
  • analog_liquid (物理流体) - Metallic shimmer on solid color base, creative brands
  • led_matrix (数字硬件) - Digital retro, cyberpunk aesthetics

Light Styles (6):

  • editorial (纸本编辑) - Specialty paper, humanistic brands
  • iridescent (幻彩透砂) - Optical materials, tech hardware
  • morning (晨雾光域) - AI softness, approachable products
  • clinical (无菌影棚) - Spatial order, algorithm-driven brands
  • ui_container (容器化界面) - Digital product native, SaaS platforms
  • swiss_flat (瑞士扁平) - Absolute flatness, timeless authority

Each style has specific visual characteristics and suitable use cases. Consult the reference document for details.

Common Patterns

Pattern: Concentric Circle Dots

<svg viewBox="0 0 100 100">
  <g>
    <!-- Inner ring: 6 dots -->
    <circle cx="50" cy="38" r="3" fill="currentColor"/>
    <!-- Add more dots in circular arrangement -->
  </g>
</svg>

Pattern: Geometric Shape with Line Accent

<svg viewBox="0 0 100 100">
  <polygon points="50,30 70,60 30,60" fill="none" stroke="currentColor" stroke-width="2"/>
  <circle cx="50" cy="30" r="4" fill="currentColor"/>
</svg>

Pattern: Node Network

<svg viewBox="0 0 100 100">
  <path d="M 30 70 Q 50 70, 50 50 T 70 30" stroke="currentColor" stroke-width="2" fill="none"/>
  <circle cx="30" cy="70" r="4" fill="currentColor"/>
  <circle cx="50" cy="50" r="5" fill="currentColor"/>
  <circle cx="70" cy="30" r="4" fill="currentColor"/>
</svg>

For more patterns and combinations, see references/design_patterns.md.

Troubleshooting

SVG not displaying correctly: Check viewBox and ensure all paths are closed

PNG export fails: Verify cairosvg is installed (pip install cairosvg)

Showcase generation fails:

  • Check .env file has valid GEMINI_API_KEY
  • Verify reference PNG exists and is readable
  • Check API quota/rate limits

Third-party API not working: Ensure GEMINI_API_BASE_URL is correctly formatted (e.g., https://api.example.com/v1)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.