How does authentication work?

The skill starts a temporary local server, then opens your browser to girlgenerator.app/skill/connect. After you sign in, the page silently posts your API token to the local server. Your token is saved to ~/.config/girlgenerator/auth.json with 0600 permissions. No passwords are stored by the skill.

Where is my token stored?

Locally in ~/.config/girlgenerator/auth.json. The file is created with mode 0600 (readable only by your user). Tokens are named "Claude Code Skill" in your API key list and can be viewed or revoked at girlgenerator.app/settings/apikeys.

Yes. Go to Settings → API Keys on girlgenerator.app and delete the key named "Claude Code Skill". The skill will prompt you to re-authenticate on next use. Running ai-girl logout also deletes your local token file.

What happens to my generated images?

By default, images are saved to your current working directory and shared publicly on girlgenerator.app/g/ so you can share the link. Use --private to skip the public share. You can also delete images from your account at any time.

Is the skill really free?

The skill itself is free and MIT licensed. Generating images uses credits — new accounts get 5 free credits. After that, top up at girlgenerator.app/pricing. The nano-banana model costs 1 credit and is always available as a preview tier.

Credits are consumed per generation. Welcome bonus credits never expire. You also earn 2 free credits every day via check-in. Purchased credit packs don't expire either. Check your balance anytime with the whoami command or at girlgenerator.app/settings/credits.

Claude Code Skill

AI Girl Generator for Claude Code

One command. Generate anime, realistic, cyberpunk character art — without leaving your terminal.

Install the skill

npx skills add NicheSeeker/ai-girl-generator-skill

View on GitHub Get 5 free credits

claude — ai-girl-generator

$npx skills add NicheSeeker/ai-girl-generator-skill

Fetching skill from GitHub...

✓ Installed to ~/.claude/skills/ai-girl-generator

$ai-girl-login

Opening browser for authentication...

✓ Logged in as you@email.com

💎 5 credits remaining

└─ 5 welcome bonus (no expiry)

How it works

1
Install
Run one command and Claude Code picks up the skill automatically from ~/.claude/skills/.
2
Sign in
Your browser opens to AI Girl Generator. Sign in or create a free account — new accounts get 5 free credits — no expiry.
3
Generate
Describe the character you want. Claude selects the best model for your style and runs the generation directly in your terminal.

Usage examples

Real terminal conversations showing the skill in action.

Brainstorm flow

Not sure what to make? Claude asks questions one at a time.

$ /ai-girl brainstorm

What style are you thinking? (anime, realistic, cyberpunk, watercolor…)

$ anime, maybe magical girl vibes

Nice! What's the character's role or setting?

$ a celestial archer in a starfield

Got it — generating with Seedream (2 credits)…

✅ Generated with Seedream (2 credits used, 3 remaining)
📁 ./girl-20260412-1043-celestial-archer.png
🔗 https://girlgenerator.app/g/abc123

One-shot with style

Concrete prompt? Claude routes to the right model and generates immediately.

$ generate a cyberpunk hacker girl, neon green hair, rain-slicked street

Cyberpunk prompt — routing to FLUX.2 Pro (2 credits). Generating…

✅ Generated with FLUX.2 Pro (2 credits used, 1 remaining)
📁 ./girl-20260412-1101-cyberpunk-hacker.png
🔗 https://girlgenerator.app/g/xyz789

Private generation

Use --private to keep your image off the public share feed.

$ generate a realistic portrait of a forest ranger --private

Generating with Nano Banana Pro (3 credits, private mode)…

✅ Generated with Nano Banana Pro (3 credits used, 5 remaining)
📁 ./girl-20260412-1115-forest-ranger.png
(private — no share link)

Check your credits

See your balance, credit sources, and nearest expiry.

$ ai-girl whoami

Account: user@example.com

Credits
  Bonus    5 cr  (no expiry)
  Pack     6 cr  (no expiry)
  ─────────────────────
  Total   11 cr

Model comparison

Claude auto-selects the best model based on your prompt. You can always override.

Model	Best for	Credits	Speed	Free tier
Nano Banana	Fast & free. Great for quick portraits.	1	Fast	Free
Z-Image	Ultra-fast. Sharp details and clean output.	1	Fast	Free
Nano Banana 2	Better quality with richer detail.	2	Medium	Paid
FLUX.2 Pro	Premium quality. Ideal for 3D, cyberpunk & scene art.	2	Medium	Paid
Seedream	Best for anime, chibi & kawaii characters.	2	Medium	Paid
Nano Banana Pro	Highest quality realistic portraits.	3	Slow	Paid

Fully open source

The skill is MIT licensed. Fork it, modify it, or contribute to it on GitHub.

View source on GitHub Star on GitHub

Frequently asked questions

How does authentication work?: The skill starts a temporary local server, then opens your browser to girlgenerator.app/skill/connect. After you sign in, the page silently posts your API token to the local server. Your token is saved to ~/.config/girlgenerator/auth.json with 0600 permissions. No passwords are stored by the skill.
Where is my token stored?: Locally in ~/.config/girlgenerator/auth.json. The file is created with mode 0600 (readable only by your user). Tokens are named "Claude Code Skill" in your API key list and can be viewed or revoked at girlgenerator.app/settings/apikeys.
Can I revoke access?: Yes. Go to Settings → API Keys on girlgenerator.app and delete the key named "Claude Code Skill". The skill will prompt you to re-authenticate on next use. Running ai-girl logout also deletes your local token file.
What happens to my generated images?: By default, images are saved to your current working directory and shared publicly on girlgenerator.app/g/<id> so you can share the link. Use --private to skip the public share. You can also delete images from your account at any time.
Is the skill really free?: The skill itself is free and MIT licensed. Generating images uses credits — new accounts get 5 free credits. After that, top up at girlgenerator.app/pricing. The nano-banana model costs 1 credit and is always available as a preview tier.
How do credits work?: Credits are consumed per generation. Welcome bonus credits never expire. You also earn 2 free credits every day via check-in. Purchased credit packs don't expire either. Check your balance anytime with the whoami command or at girlgenerator.app/settings/credits.

Start creating

5 free credits on every new account. No credit card required.

Create your free account