ascii-skill

AI agent skill for world-class ASCII art. Scenes, UI, 3D, animations — zero dependencies.

Active Pure Nim score 65/100 · last commit 2026-07-03 · 1 stars · tests present · no docs generated

Summary

Latest Version Unknown
License Unknown
CI Status Failing
Stars 1
Forks 0
Open Issues 0
Last Commit 2026-07-03
Downloads 0
Last Indexed 2026-09-06 06:05

Installation

nimble install ascii-skill
choosenim install ascii-skill
git clone https://gitlab.com/arjunkshah/ascii-skill

OS Compatibility

Platform Linux macOS Windows FreeBSD OpenBSD NetBSD Android iOS WASM Embedded
ascii-skill - - - - - - -

README

╭─────────────────────────────────────────────────────────────────╮
│                                                                 │
│  █████ █████ █████ █████ █████   █████ █   █ █████ █     █      │
│  █   █ █     █       █     █     █     █  █    █   █     █      │
│  █████ ████  █       █     █     ████  ██      █   █     █      │
│  █   █     █ █       █     █         █ █  █    █   █     █      │
│  █   █ █████ █████ █████ █████   █████ █   █ █████ █████ █████  │
│                                                                 │
│        fixed-width ASCII · generate anything · zero deps        │
│                                                                 │
│              npx skills add arjunkshah/ascii-skill              │
│                                                                 │
╰─────────────────────────────────────────────────────────────────╯
**AI agent skill — teach any coding agent to generate world-class ASCII art** Characters are pixels. Every cell has visual weight.

Install

npx skills add arjunkshah/ascii-skill

For a specific agent:

npx skills add arjunkshah/ascii-skill -a codex
npx skills add arjunkshah/ascii-skill -a claude-code
npx skills add arjunkshah/ascii-skill -a cursor

What is this?

An AI agent skill that teaches any coding agent to generate world-class ASCII art — treating ASCII as grid-based visual design where every character is a pixel with intentional visual weight.

User: "draw a dragon fighting a knight in front of a castle"
Agent: ← beautiful ASCII scene rendered to the terminal

Works with zero dependencies — pure Python with math and random. Only the agent reads SKILL.md (~1620 lines) as its constitution.

Capabilities

Category Examples
ASCII Art Dragons, knights, spaceships, robots, logos, scenes, icons
ASCII UI Dashboards, menus, progress bars, tables, status panels, cards
3D ASCII Rotating cubes, spheres, toruses, starfields, tunnels, terrain
Matrix Effects Column-based rain, falling streams, animated glyphs
Terminal Animation Frame sequences, Python animation, browser-based effects
Procedural Waves, fire, smoke, particles, terrain, waves, aurora

Usage

Tell your agent to draw something after installing:

$ascii draw a dragon
$ascii rotating cube
$ascii matrix rain
$ascii system dashboard
$ascii draw a knight with sword and shield
$ascii 3D torus animation

Agents use a 5-step workflow: parse → choose → design → render → verify.

3D Capabilities

Full projection-based 3D rendering:

  • Perspective projection for depth and realism
  • Rotation matrices for X/Y/Z axes
  • Z-buffer for correct occlusion
  • Bresenham line drawing for wireframes
  • Point cloud shading for spheres and organic forms
  • Depth-based character density for surface shading

Rotating cubes, spheres, toruses, starfields, tunnels, particle systems, low-poly objects, and wireframe terrain.

Project Structure

ascii-skill/
├── SKILL.md               Agent constitution for ASCII generation
├── README.md              This file
├── LICENSE                MIT license
├── launch.html            Video launch reel
├── index.html             Landing page with interactive canvas
├── assets/
   └── ascii-skill.js     Browser canvas runtime
└── scripts/
    ├── ascii_gen.py       Python CLI toolkit
    ├── run_all_tools.sh   Test suite
    └── setup.sh           Environment setup

Live Demo

Landing page with interactive canvas runtime · Launch reel


npx skills add arjunkshah/ascii-skill
Install once, generate anything