# Ascii Art

> Converts text, images, or video to ASCII art with multiple styles and export formats. Use when the user asks to create ASCII art, convert images/videos to text art, or mentions ascii-art, braille art, or block art.

- **Type:** Skill
- **Install:** `agentstack add skill-neethanwu-ascii-art-ascii-art`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [neethanwu](https://agentstack.voostack.com/s/neethanwu)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [neethanwu](https://github.com/neethanwu)
- **Source:** https://github.com/neethanwu/ascii-art

## Install

```sh
agentstack add skill-neethanwu-ascii-art-ascii-art
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ASCII Art Converter

## Setup

Before first use, run the environment setup (idempotent, `.
   **Do NOT proceed to options until you have a valid file path on disk.**
3. **Plain text** (no file, or file doesn't exist) → **text** (FIGlet banner)
4. **Nothing provided** → ask what they want to convert

## Options Prompt

Parse the user's message for pre-specified options. Then prompt for **unspecified options** using `AskUserQuestion`.

- "defaults" or "just do it" → skip prompting, use all defaults
- "random" or "surprise me" → skip prompting, use `--random`
- All options specified → skip prompting

Use `questions` array (max 4 per call, 3 options per question). List ALL choices with numbers in the `question` text. Top 3 as selectable options — user can type any number/name in free-text. No "Other" option. Default as option 1.

**Image/video** — ask in two rounds:
1. **Round 1** (4 questions): Style → Color → Export → Background
2. **Round 2** (only if export is `interactive` or `tsx`): Mouse Mode → Animation

**Text**: Font → Color → Export → Background (single round).

### Image/video options

| Option | Choices | Default |
|--------|---------|---------|
| Style | classic, braille, block, edge, dot-cross, halftone, particles, retro-art, terminal | classic |
| Color | grayscale, original, matrix, amber, custom (hex/named) | grayscale |
| Ratio | original, 16:9, 4:3, 1:1, 3:4, 9:16 | original |
| Background | dark, light, transparent | dark |
| Dither | none, floyd-steinberg, bayer, atkinson | none |
| Font size | 6-30 px | 14 |
| Export | png, html, svg, txt, md, clipboard, interactive, tsx | auto (image→png, video→gif) |
| Mouse mode | push, attract | push |
| Animation | none, noise-field, intervals, beam-sweep, glitch, crt | none |

Mouse mode and animation only apply to interactive/tsx exports. Only ask when export is `interactive` or `tsx`. Don't ask for `--hover-strength`, `--area-size`, or `--spread` — use defaults.

### Text options

| Option | Choices | Default |
|--------|---------|---------|
| Font | standard, doom, banner, slant, big, small, block, lean, mini, script, shadow, speed, ansi_shadow, ansi_regular | standard |
| Color | grayscale, original, matrix, amber, custom | grayscale |
| Background | dark, light, transparent | dark |
| Export | terminal (stdout), txt, md, png, html, svg, clipboard | terminal |

Interactive/tsx exports require image or video input — text is not supported.

### Disambiguation

- "block" as a **style** = Unicode block elements (█▓▒░) for images
- "block" as a **font** = block-letter FIGlet font for text
- For block-style text art, use `--font ansi_shadow` or `--font block`
- Custom colors: hex (`#ff6600`) or named (`coral`, `skyblue`). Translate creative descriptions to hex.

## Running the Conversion

```bash
{{SKILL_DIR}}/scripts/.venv/bin/python {{SKILL_DIR}}/scripts/convert.py \
  --input "" \
  --type  \
  --style  \
  --color  \
  --background  \
  --export  \
  [--dither ] \
  [--ratio ] \
  [--font-size ] \
  [--cols ] \
  [--font ] \
  [--custom-color ""] \
  [--mouse-mode ] \
  [--animation ] \
  [--invert] [--random] \
  [--fps ] \
  [--filename ]
```

## Output

All files save to an `ascii/` folder in the current working directory (created automatically).

- **Text (terminal)**: prints to stdout + auto-copies to clipboard. Show in a code block.
- **File exports (png, html, svg, txt, md, gif)**: show the file path. Use Read tool to display images inline.
- **Interactive HTML**: show the file path. Suggest: `open ` to view in browser.
- **React TSX**: show the file path. Show usage: `import { AsciiArt } from './'`
- **Never preview in terminal** for image/video/interactive exports.

## Error Handling

- **Video fails**: likely missing ffmpeg or opencv. Suggest: `pip install opencv-python-headless`
- **Image fails**: check file exists and is a valid image format
- **Interactive/tsx + text**: prints error — interactive requires image/video input

## Follow-up

After showing the result, offer to: try a different style/color, adjust settings, export in another format, or try random mode. Remember the previous input path for re-runs.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [neethanwu](https://github.com/neethanwu)
- **Source:** [neethanwu/ascii-art](https://github.com/neethanwu/ascii-art)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-neethanwu-ascii-art-ascii-art
- Seller: https://agentstack.voostack.com/s/neethanwu
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.