# ai-tasks

Sets up AI rules that tag ImageKit images and fill in metadata from fixed value lists, plus yes or no quality checks.

Skill by ImageKit. Category: Data and backend.

## Install

Project (for this project only):

```sh
npx skills add imagekit-developer/skills --skill ai-tasks
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add imagekit-developer/skills --skill ai-tasks -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 456. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/imagekit-developer/skills/ai-tasks)

## Source

[Open the source](https://github.com/imagekit-developer/skills/tree/HEAD/skills/ai-tasks). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: ai-tasks
description: Apply AI-powered analysis to images for business-specific tagging, metadata extraction, and quality checks using controlled vocabularies. Use when user wants to analyze images and apply structured metadata in ImageKit.
---

# AI Tasks Skill

## When to use
- User wants to tag images with business-specific categories
- User needs controlled vocabularies (predefined value lists)
- User wants yes/no quality checks on images
- User needs to extract metadata using natural language analysis

## AI Task Structure

Each AI Task contains **1-10 sub-tasks** with:

1. **Instruction** (required): Natural language question about the image
2. **Action Type** (required): `select_tags`, `select_metadata`, or `yes_no`
3. **Vocabulary** (optional): 1-30 predefined approved values

## Action Types

### select_tags
Adds tags from vocabulary. Supports multiple selections.
```json
{
  "type": "select_tags",
  "instruction": "What body style is this vehicle?",
  "vocabulary": ["sedan", "suv", "hatchback"],
  "max_selections": 1
}
```

### select_metadata
Sets custom metadata field (field must exist in DAM).
```json
{
  "type": "select_metadata",
  "instruction": "What is the primary color?",
  "field": "primary_color",
  "vocabulary": ["red", "blue", "white", "black"],
  "max_selections": 1
}
```

### yes_no
Binary quality check with conditional actions.
```json
{
  "type": "yes_no",
  "instruction": "Is the product completely visible?",
  "on_yes": { "add_tags": ["framing_ok"] },
  "on_no": { "add_tags": ["needs_reshot"] }
}
```

## Gotchas

- **Instruction clarity**: Be specific ("What is the collar type?" not "Describe the image")
- **Vocabulary design**: Use business terminology, non-overlapping, 1-30 items max
- **Field requirements**: For `select_metadata`, field must exist in DAM first
- **Tag values**: Cannot contain `%` character
- **yes_no tasks**: Must have at least one of `on_yes` or `on_no`
- **Vocabulary length**: Max 500 characters combined (select_tags only)
- **Scope**: Works on visual content only (images/videos)

## Applying AI Tasks

- **Via DAM MCP**: `list_saved_extensions`, `create_saved_extension`, and `apply_extension_bulk` on `https://imagekit.io/mcp/dam`
- **Via Saved Extensions**: Create and apply via dashboard/API
- **Via API at Upload**: Include in `extensions` array
- **Via Path Policies**: Auto-apply to files in specific folders

## Full examples

For complete, copy-ready `ai-tasks` configurations organized by industry (fashion e-commerce, travel, automotive) and detailed per-task-type parameter references, read [resources/EXAMPLES.md](resources/EXAMPLES.md).
````

- Previous: [search-docs](https://syn4pse.dev/terminal/imagekit-search-docs.md)
- Next: [transformation-builder](https://syn4pse.dev/terminal/imagekit-transformation-builder.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
