Claude Code Skill

What's a skill?

Skills extend Claude Code with pre-written instructions. The goodtake-generate skill tells Claude Code how to invoke gt generate image correctly — handling model selection, aspect ratios, reference images, and error recovery automatically.

This is a lightweight alternative to the MCP server: instead of making HTTP calls to mcp.goodtake.ai, Claude runs the local gt CLI you already have installed.

Prerequisites

Install the CLI:
```
npm install -g @goodtake/cli
```
Authenticate:
```
gt auth login
```

Install the skill

npx skills add goodtake-ai/skills

Restart Claude Code to pick up the new skill.

Usage

Once installed, ask Claude Code naturally:

"Generate an image of a futuristic city at night"

"Create a product shot of white sneakers on a marble surface, 1:1 aspect ratio"

"Use GoodTake to make a 16:9 hero banner with abstract gradients"

"Generate with gpt-image-2: a red fox in snow, high quality"

The skill invokes gt generate image and returns the downloaded file path or URL.

What the skill handles

Checks that gt is installed and authenticated before generating
Selects default model (gpt-image-2) if you don't specify one
Passes --param flags for model-specific options like quality, num_images, style
Uses --reference for image-to-image editing
Handles Insufficient credits and unknown model errors with actionable guidance
Returns the output path on success — no noise

Manual install (alternative)

If npx skills add is not available, clone github.com/goodtake-ai/skills and follow the instructions in INSTALL.md.