Taka

Taka creative tools CLI — generate AI images, videos, emails, and flyers for small businesses from the command line

Security Scan

The skill's instructions, env access, and example scripts are coherent with a CLI that talks to the taka.ai API, but there are small inconsistencies and the recommended npm install step means you should inspect the published package before installing.

Purpose & Capability

Name/description (CLI for generating creatives) align with the commands, examples, and required TAKA_SERVER_URL endpoint. All commands and examples point to a remote Taka API and expected creative operations (images, video, email, flyers). One minor inconsistency: registry metadata lists TAKA_SERVER_URL as a required env var while SKILL.md/HOW_TO_RUN mark it optional with a default of https://api.taka.ai/v1.

Instruction Scope

Runtime instructions are limited to installing/using the taka-cli, logging in via email OTP, creating and managing creatives, and storing tokens under ~/.config/taka/config.json. There are no instructions to read unrelated system files, harvest other credentials, or exfiltrate data to unexpected endpoints; network traffic is expected to go to the Taka API (or a custom TAKA_SERVER_URL).

Install Mechanism

The skill is instruction-only in metadata but explicitly tells users to run `npm install -g taka-cli` (and offers `npx`). Installing from npm is common for CLIs but npm packages can execute install-time scripts and contain arbitrary code. There is no install spec in the registry to lock this behavior or point to a specific, audited release; verify the npm package and its repository before installation.

Credentials

Only TAKA_SERVER_URL is declared. That is proportionate for a client that needs a custom API endpoint. However, registry metadata says it's required while the docs state it is optional with a default value — this mismatch should be clarified. No other secrets or unrelated credentials are requested.

Persistence & Privilege

The skill stores JWT tokens in ~/.config/taka/config.json (owner-only mode), which is appropriate for a CLI that maintains a session. The skill does not request always:true and does not declare any system-wide configuration changes; autonomous invocation is allowed by default (normal for skills) but not otherwise privileged here.

Assessment

This skill appears to do what it says: act as a CLI front-end to the Taka creative API. Before installing: (1) inspect the npm package (taka-cli) and its repository to confirm publisher identity and check for postinstall scripts or surprising code; (2) prefer running with npx or in a sandbox if you want to avoid a global install; (3) note that tokens are stored locally at ~/.config/taka/config.json—treat that file as sensitive; (4) confirm whether TAKA_SERVER_URL must be set for your environment (docs say optional, registry says required); and (5) review Taka's privacy/terms if you will upload proprietary assets (images/video prompts may be sent to remote servers). If you cannot verify the npm package source, exercise caution.

Install Taka CLI

npm install -g taka-cli

npm release: https://www.npmjs.com/package/taka-cli

---

Property	Value
name	taka
description	AI-powered creative tools CLI for generating images, videos, emails, and flyers
allowed-tools	Bash(taka:*)

---

Core Workflow

The fundamental pattern for using Taka CLI:

1. Authenticate - Log in with your Taka account (email + OTP)
2. Create - Start a new creative project (Instagram post, email, flyer, etc.)
3. Generate - Use AI to generate images, videos, or build content
4. Refine - Update content fields, rename, or regenerate
5. Review - List and inspect your creatives

# 1. Authenticate
taka login

# 2. Create a project
taka create-creative --name "Summer Sale" --type instagram

# 3. Generate an image
taka generate-image --prompt "vibrant summer sale banner with tropical colors"

# 4. Refine
taka update-content --creative-id <id> --fields '{"caption": "Summer sale starts now!"}'

# 5. Review
taka list-creatives
taka get-creative --id <id>

---

Authentication

Taka uses email OTP (one-time password) authentication. Tokens are saved locally and auto-refresh silently.

# Log in (interactive — prompts for email, then verification code)
taka login

# Check who you're logged in as
taka whoami

# Log out (removes saved credentials)
taka logout

Environment Variables:

Variable	Required	Default	Description
TAKA_SERVER_URL	No	https://api.taka.ai/v1	Custom API endpoint (for staging/dev)

Credentials are saved to ~/.config/taka/config.json with restricted permissions (owner-only read/write).

---

Commands

Creative Management

Create a new creative project

taka create-creative --name "My Post" --type instagram
taka create-creative --name "My Post" --type instagram --prompt "sunset over ocean"

Types: instagram, email, logo, blog, flyer

When --prompt is provided for instagram, logo, or flyer types, an image is automatically generated after creation.

List all creatives

taka list-creatives

Get a specific creative

taka get-creative --id <creative-id>

Delete a creative

taka delete-creative --id <creative-id>

Rename a creative

taka rename-creative --creative-id <id> --name "New Name"

Name is limited to 40 characters.

List generated images for a creative

taka list-images --creative-id <id>

---

Image Generation

Generate an image from a text prompt

taka generate-image --prompt "a sunset over the ocean"

Uses Google Gemini AI to generate images.

Options:

• --prompt <text> (required) - Text description of the image
• --aspect-ratio <ratio> - One of: 1:1, 3:4, 4:3, 9:16, 16:9
• --reference-attachment-ids <ids...> - Attachment IDs for reference images (image-to-image)
• --reference-mode <mode> - inspire (loose inspiration) or edit (modify in-place)
• --creative-id <id> - Associate the image with a creative project

Examples:

# Square image
taka generate-image --prompt "coffee shop logo" --aspect-ratio 1:1

# Portrait image for Instagram story
taka generate-image --prompt "motivational quote background" --aspect-ratio 9:16

# Associate with a creative
taka generate-image --prompt "product photo" --creative-id abc123

---

Video Generation

Generate a video from a text prompt

taka generate-video --prompt "waves crashing on a beach at sunset"

Uses Fal AI to generate videos.

Options:

• --prompt <text> (required) - Text description of the video
• --duration <seconds> - 5, 7, or 10 (default: 7)
• --aspect-ratio <ratio> - 16:9, 9:16, or 1:1
• --source-image-attachment-id <id> - Animate an existing image (image-to-video)
• --creative-id <id> - Associate with a creative project

Examples:

# Short video for Instagram Reels
taka generate-video --prompt "coffee being poured" --duration 5 --aspect-ratio 9:16

# Longer landscape video
taka generate-video --prompt "timelapse of city skyline" --duration 10 --aspect-ratio 16:9

---

Flyer Creation

Generate a hero image for a flyer

taka generate-flyer-image --prompt "grand opening celebration" --creative-id <id>

Always generates in 3:4 (portrait) aspect ratio.

Build a flyer structure

taka build-flyer \
  --creative-id <id> \
  --template-id promo \
  --headline "50% Off Everything" \
  --subtitle "This weekend only" \
  --tagline "Shop Now"

Template IDs: promo, event, opening, seasonal, minimal, photo-heavy

---

Email Creation

Generate an image for an email section

taka generate-email-image \
  --section-id hero \
  --prompt "holiday email banner" \
  --creative-id <id>

Options:

• --section-id <id> (required) - Section ID within the email
• --prompt <text> (required) - Image description
• --aspect-ratio <ratio> - 16:9, 4:3, or 1:1
• --cell-index <n> - Column cell index (0-based, for multi-column sections)
• --creative-id <id> - Associate with a creative

Build a complete email

taka build-email \
  --creative-id <id> \
  --subject "Welcome to Our Newsletter" \
  --preheader "Great things are coming" \
  --global-style '{"backgroundColor":"#f4f4f5","contentWidth":600,"fontFamily":"Arial","fontColor":"#333333"}' \
  --sections '[{"type":"hero","content":{"title":"Welcome!","subtitle":"We are glad you are here"}},{"type":"text","content":{"body":"Lorem ipsum..."}}]' \
  --footer '{"businessName":"My Business","showUnsubscribe":true,"showViewInBrowser":true}'

---

Brand Kit

Get brand images

taka get-brand-images
taka get-brand-images --tags signature products

Available tags: signature, products, lifestyle, people

---

Content Updates

Update any fields on a creative

taka update-content --creative-id <id> --fields '{"caption":"New caption","hashtags":["summer","sale"]}'

The --fields parameter accepts any valid JSON object with fields specific to the creative type.

---

Common Workflows

Create Instagram Post with AI Image

# Create and auto-generate in one step
taka create-creative --name "Summer Vibes" --type instagram --prompt "tropical beach sunset"

Create a Complete Email Campaign

# 1. Create the project
RESULT=$(taka create-creative --name "Welcome Email" --type email)
ID=$(echo $RESULT | jq -r '.creative.id')

# 2. Build the email structure
taka build-email \
  --creative-id $ID \
  --subject "Welcome!" \
  --preheader "We are excited to have you" \
  --global-style '{"backgroundColor":"#ffffff","contentWidth":600,"fontFamily":"Arial","fontColor":"#333"}' \
  --sections '[{"type":"hero","content":{"title":"Welcome!"}},{"type":"text","content":{"body":"Thanks for joining us."}}]' \
  --footer '{"businessName":"My Biz","showUnsubscribe":true,"showViewInBrowser":true}'

# 3. Generate a hero image
taka generate-email-image --section-id hero-0 --prompt "welcoming banner" --creative-id $ID

Create a Promotional Flyer

# 1. Create project
RESULT=$(taka create-creative --name "Grand Opening" --type flyer)
ID=$(echo $RESULT | jq -r '.creative.id')

# 2. Build structure
taka build-flyer --creative-id $ID --template-id opening --headline "Grand Opening" --subtitle "Join us this Saturday"

# 3. Generate hero image
taka generate-flyer-image --prompt "festive grand opening storefront" --creative-id $ID

---

Output Format

All commands output JSON for easy parsing:

# Parse output with jq
CREATIVE_ID=$(taka create-creative --name "Test" --type instagram | jq -r '.creative.id')
IMAGE_URL=$(taka generate-image --prompt "test" | jq -r '.imageUrl')

---

Error Handling

Error	Solution
Not authenticated. Run taka login first.	Run taka login
Session expired. Run taka login to re-authenticate.	Run taka login (refresh token also expired)
Not enough credits	Purchase more credits or upgrade plan
A video is already being generated	Wait for current video generation to complete
Creative not found	Verify creative ID with taka list-creatives

---

Quick Reference

# Auth
taka login                                          # Log in
taka whoami                                         # Check auth status
taka logout                                         # Log out

# Creatives
taka create-creative --name "X" --type instagram    # Create
taka list-creatives                                 # List all
taka get-creative --id <id>                         # Get one
taka delete-creative --id <id>                      # Delete
taka rename-creative --creative-id <id> --name "Y"  # Rename
taka list-images --creative-id <id>                 # List images

# Generate
taka generate-image --prompt "..."                  # Image (Gemini)
taka generate-video --prompt "..."                  # Video (Fal)
taka generate-flyer-image --prompt "..."            # Flyer hero image
taka generate-email-image --section-id X --prompt "..."  # Email image

# Build
taka build-email --creative-id <id> --subject "..." --preheader "..." --global-style '{}' --sections '[]' --footer '{}'
taka build-flyer --creative-id <id> --template-id promo --headline "..." --subtitle "..."

# Content
taka update-content --creative-id <id> --fields '{}'
taka get-brand-images --tags products lifestyle

# Help
taka --help