skills README

The project's README from github.com/higgsfield-ai/skills. As one markdown file: README.md.

Higgsfield AI Skills

License: MIT Version Skills Discord

AI agent skills for image/video generation and complete visual brand systems via Higgsfield AI, including Marketing Studio and Virality Predictor video scoring. Works with Claude Code, Cursor, Codex, and other AI coding agents that load Markdown-based skills.

Install

Pick one. Each method handles the Higgsfield CLI install and auth as part of skill setup.

npx skills add higgsfield-ai/skills

gh skill install

GitHub CLI v2.90+:

gh skill install higgsfield-ai/skills

Claude Code marketplace

Inside Claude Code:

/plugin marketplace add higgsfield-ai/skills
/plugin install higgsfield@higgsfield

Setup script

Universal fallback:

git clone --depth 1 https://github.com/higgsfield-ai/skills.git
cd skills
./setup

More options in INSTALL.md. Agent-driven install (paste into your agent): INSTALL_FOR_AGENTS.md.

Skills

Skill Invoke (Claude Code) Description
higgsfield-generate /higgsfield:higgsfield-generate Image, video, 3D, and audio generation across 30+ models (Nano Banana 2, Soul V2, Veo 3.1, Kling 3.0, Seedance 2.5, Seed Audio 1.0, Flux 2, GPT Image 2.5, …), plus Marketing Studio for branded ads with avatars/products/hooks/settings and Virality Predictor scoring for finished videos.
higgsfield-soul-id /higgsfield:higgsfield-soul-id Train a Soul Character — a reusable, face-faithful identity model. Returns a reference_id consumable by Soul-aware generation.
higgsfield-product-photoshoot /higgsfield:higgsfield-product-photoshoot Brand-quality product imagery with mode-specific prompt enhancement. 10 modes (studio, lifestyle, Pinterest, hero banner, ad packs, virtual try-on, …) backed by gpt_image_2.
higgsfield-brandkit /higgsfield:higgsfield-brandkit Create or extend a complete visual identity: palettes, editable SVG logo marks, typography, mockups, social graphics, packaging, signage, merchandise, decks, and canonical PPTX/PDF brandbooks.
higgsfield-marketplace-cards /higgsfield:higgsfield-marketplace-cards Marketplace product cards: compliant main image, secondary product images, and A+ style modules via backend prompt enhancement.
higgsfield-websites /higgsfield:higgsfield-websites Build, edit, and deploy full-stack websites — React 19 + TanStack Start, server-rendered as one Cloudflare Worker with D1 / R2 / KV / Durable Objects / Containers. Create → get git repo access → edit locally → push → deploy preview/production, all via higgsfield website ….
higgsfield-video-explainer /higgsfield:higgsfield-video-explainer Create a narrated non-photoreal explainer as matched Seed Audio + Gemini Omni blocks, then assemble the final MP4 with explainer_video.
higgsfield-youtube-thumbnail /higgsfield:higgsfield-youtube-thumbnail Create truthful, high-impact YouTube thumbnails and vertical video covers with identity-preserving references, controlled variants, focused edits, and optional text-overlay guidance.

The skills chain: train Soul → use the reference id in generate (including Marketing Studio jobs). brandkit chains Recraft, Seedream, GPT Image, and deterministic local tooling into one approval-aware identity system. product-photoshoot and marketplace-cards are self-contained — backend enhances prompts before submitting image jobs. youtube-thumbnail can follow any video workflow once its truthful topic and visual direction are known. websites chains with generate to embed bespoke hero images, video loops, and OG assets in the site.

Modes

higgsfield-product-photoshoot — 10 modes for brand visuals:

Mode What it's for
product_shot Product on neutral / studio / catalog background
lifestyle_scene Product in a real environment — hands, action, atmosphere
closeup_product_with_person Tight crop with hands or partial face — beauty, demonstrating
moodboard_pin Vertical 2:3 Pinterest-native pin, moodboard feel
hero_banner Wide-format website / email / campaign header
social_carousel 3–10 connected slides for IG / LinkedIn / Facebook
ad_creative_pack Coordinated pack of static ad variants for Meta / TikTok / Pinterest / Google
virtual_model_tryout Product worn or used by an AI-rendered model
conceptual_product Surreal / CGI-style / levitating / splash / sculptural product
restyle Transform an existing image's aesthetic, mood, or seasonal context

higgsfield-generate Marketing Studio — 9 modes for branded ad video:

Mode What it's for
ugc Default. Casual, organic-feel content from a presenter
ugc_how_to Tutorial / explainer
ugc_unboxing Unboxing reveal
product_showcase Clean product highlight, polished
product_review Presenter giving an opinion
tv_spot Broadcast-style commercial
wild_card Experimental, model picks the vibe
ugc_virtual_try_on Trying on clothing — UGC vibe
virtual_try_on Trying on clothing — polished, model-driven

Quick Reference

What you want Skill Note
Generate any image / video from a prompt higgsfield-generate Prefers gpt_image_2_5 / nano_banana_flash for images and SOTA seedance_2_5 for video by default
Generate audio from a prompt higgsfield-generate Prefers seed_audio by default
Image with my own face higgsfield-soul-id then higgsfield-generate One-time training, then --soul-id
Branded product photo (studio / lifestyle / Pinterest / hero / ad pack) higgsfield-product-photoshoot Mode-specific prompt enhancer + gpt_image_2
Create or extend a logo, visual identity, brand asset system, or Brandbook higgsfield-brandkit Recraft SVG marks + approved palette/type + local editable exports and dependency-aware revisions
Marketplace product cards / A+ style content higgsfield-marketplace-cards Main image, secondary images, and A+ style modules with hidden marketplace prompt templates
Branded ad video / UGC / unboxing / TV spot higgsfield-generate Marketing Studio mode with avatars + products + optional hooks/settings
Analyze a video's hook / attention / virality potential higgsfield-generate Uses Virality Predictor (brain_activity) with --video; returns score metrics plus an Open report link
Train a custom face identity higgsfield-soul-id 5–20 photos, returns reference_id
Image-to-video animation higgsfield-generate Prefer seedance_2_5 with --mode omni_reference --start-image; kling3_0_turbo when the user asks for cheaper
Build / edit / deploy a website, web app, landing page, or dashboard higgsfield-websites Full-stack React 19 + TanStack Start on Cloudflare; higgsfield website create/repo-access/deploy
Create a narrated explainer from a topic or document higgsfield-video-explainer Resolves a live style, generates audio then video per block, and assembles with explainer_video
Create a YouTube thumbnail or Shorts/Instagram video cover higgsfield-youtube-thumbnail Nano Banana Pro 4K main render, optional face/logo references, controlled variants, and Seedream tweaks
Build and deploy a playable browser game higgsfield-websites --type game: game design, assets, implementation, QA, deploy, and optional publish

License

MIT — see LICENSE.

skills (higgsfield-ai/skills)

Searching Database…

1.7K ·GitHub
What is this?Higgsfield AI Skills is a collection of Markdown-based AI agent skills for generating images, video, 3D, and audio, plus building full visual brand systems (logos, brandbooks, ad videos, websites) through the Higgsfield AI platform.
Is this a standalone app, or skill files my coding agent loads?It is not a standalone app — it is a set of Markdown skill files that agents like Claude Code, Cursor, and Codex load and invoke; each skill wraps calls to the Higgsfield CLI.
How do I install these skills?Pick one install path: 'npx skills' (recommended, cross-agent), 'gh skill install' via GitHub CLI v2.90+, the Claude Code marketplace, or a universal setup script; more detail is in INSTALL.md and an agent-driven install guide is in INSTALLFORAGENTS.md.
Do I need a Higgsfield account to use these skills?Yes — every install method sets up the Higgsfield CLI and its authentication for you, since the actual generation jobs run on Higgsfield's backend models.
Do the skills work independently, or do they depend on each other?Some chain together — Soul ID training feeds a reference id into generate, and brandkit chains multiple models into one approval-aware system — while product-photoshoot and marketplace-cards are self-contained, since the backend enhances prompts before submitting jobs.
Which coding agents can run these skills?They are built for Claude Code, Cursor, Codex, and any other AI coding agent that can load Markdown-based skills, with slash-command invocation shown for Claude Code.
What is Marketing Studio?It is a mode set inside higgsfield-generate for branded ad video, offering 9 modes like ugc, productshowcase, productreview, and tvspot, built with avatars, products, and optional hooks/settings.
What is the Virality Predictor?A scoring feature (brainactivity) inside higgsfield-generate that analyzes a finished video's hook, attention, and virality potential, returning score metrics plus an open report link.
What does higgsfield-soul-id do?It trains a reusable, face-faithful identity model from 5-20 photos and returns a referenceid that later generation jobs can use to keep a consistent face across outputs.
Can these skills build and deploy a website?Yes — higgsfield-websites creates, edits, and deploys a full-stack React 19 + TanStack Start site (or even a playable browser game) served as one Cloudflare Worker with D1, R2, KV, and Durable Objects.
Which topics is it in?python
Size
1 MB
Stars
1.7K
Updated
CommitOct 26
Age
6mo
Commits · 90 Days