npm - better-dsh - Versions diffs - 0.2.5-c → 0.2.5-e - Mend

better-dsh 0.2.5-c → 0.2.5-e

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (967) hide show

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-ascii-art.md DELETED Viewed

@@ -1,338 +0,0 @@
----
-title: "Ascii Art — ASCII art: pyfiglet, cowsay, boxes, image-to-ascii"
-sidebar_label: "Ascii Art"
-description: "ASCII art: pyfiglet, cowsay, boxes, image-to-ascii"
----
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-# Ascii Art
-ASCII art: pyfiglet, cowsay, boxes, image-to-ascii.
-## Skill metadata
-| | |
-|---|---|
-| Source | Optional — install with `hermes skills install official/creative/ascii-art` |
-| Path | `optional-skills/creative\ascii-art` |
-| Version | `4.0.0` |
-| Author | 0xbyt4, Hermes Agent |
-| License | MIT |
-| Platforms | linux, macos, windows |
-| Tags | `ASCII`, `Art`, `Banners`, `Creative`, `Unicode`, `Text-Art`, `pyfiglet`, `figlet`, `cowsay`, `boxes` |
-| Related skills | [`excalidraw`](/docs/user-guide/skills/optional/creative/creative-excalidraw) |
-## Reference: full SKILL.md
-:::info
-The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
-:::
-# ASCII Art Skill
-Multiple tools for different ASCII art needs. All tools are local CLI programs or free REST APIs — no API keys required.
-## Tool 1: Text Banners (pyfiglet — local)
-Render text as large ASCII art banners. 571 built-in fonts.
-### Setup
-```bash
-pip install pyfiglet --break-system-packages -q
-```
-### Usage
-```bash
-python -m pyfiglet "YOUR TEXT" -f slant
-python -m pyfiglet "TEXT" -f doom -w 80    # Set width
-python -m pyfiglet --list_fonts             # List all 571 fonts
-```
-### Recommended fonts
-| Style | Font | Best for |
-|-------|------|----------|
-| Clean & modern | `slant` | Project names, headers |
-| Bold & blocky | `doom` | Titles, logos |
-| Big & readable | `big` | Banners |
-| Classic banner | `banner3` | Wide displays |
-| Compact | `small` | Subtitles |
-| Cyberpunk | `cyberlarge` | Tech themes |
-| 3D effect | `3-d` | Splash screens |
-| Gothic | `gothic` | Dramatic text |
-### Tips
-- Preview 2-3 fonts and let the user pick their favorite
-- Short text (1-8 chars) works best with detailed fonts like `doom` or `block`
-- Long text works better with compact fonts like `small` or `mini`
-## Tool 2: Text Banners (asciified API — remote, no install)
-Free REST API that converts text to ASCII art. 250+ FIGlet fonts. Returns plain text directly — no parsing needed. Use this when pyfiglet is not installed or as a quick alternative.
-### Usage (via terminal curl)
-```bash
-# Basic text banner (default font)
-curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello+World"
-# With a specific font
-curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Slant"
-curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Doom"
-curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Star+Wars"
-curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=3-D"
-curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Banner3"
-# List all available fonts (returns JSON array)
-curl -s "https://asciified.thelicato.io/api/v2/fonts"
-```
-### Tips
-- URL-encode spaces as `+` in the text parameter
-- The response is plain text ASCII art — no JSON wrapping, ready to display
-- Font names are case-sensitive; use the fonts endpoint to get exact names
-- Works from any terminal with curl — no Python or pip needed
-## Tool 3: Cowsay (Message Art)
-Classic tool that wraps text in a speech bubble with an ASCII character.
-### Setup
-```bash
-sudo apt install cowsay -y    # Debian/Ubuntu
-# brew install cowsay         # macOS
-```
-### Usage
-```bash
-cowsay "Hello World"
-cowsay -f tux "Linux rules"       # Tux the penguin
-cowsay -f dragon "Rawr!"          # Dragon
-cowsay -f stegosaurus "Roar!"     # Stegosaurus
-cowthink "Hmm..."                  # Thought bubble
-cowsay -l                          # List all characters
-```
-### Available characters (50+)
-`beavis.zen`, `bong`, `bunny`, `cheese`, `daemon`, `default`, `dragon`,
-`dragon-and-cow`, `elephant`, `eyes`, `flaming-skull`, `ghostbusters`,
-`hellokitty`, `kiss`, `kitty`, `koala`, `luke-koala`, `mech-and-cow`,
-`meow`, `moofasa`, `moose`, `ren`, `sheep`, `skeleton`, `small`,
-`stegosaurus`, `stimpy`, `supermilker`, `surgery`, `three-eyes`,
-`turkey`, `turtle`, `tux`, `udder`, `vader`, `vader-koala`, `www`
-### Eye/tongue modifiers
-```bash
-cowsay -b "Borg"       # =_= eyes
-cowsay -d "Dead"       # x_x eyes
-cowsay -g "Greedy"     # $_$ eyes
-cowsay -p "Paranoid"   # @_@ eyes
-cowsay -s "Stoned"     # *_* eyes
-cowsay -w "Wired"      # O_O eyes
-cowsay -e "OO" "Msg"   # Custom eyes
-cowsay -T "U " "Msg"   # Custom tongue
-```
-## Tool 4: Boxes (Decorative Borders)
-Draw decorative ASCII art borders/frames around any text. 70+ built-in designs.
-### Setup
-```bash
-sudo apt install boxes -y    # Debian/Ubuntu
-# brew install boxes         # macOS
-```
-### Usage
-```bash
-echo "Hello World" | boxes                    # Default box
-echo "Hello World" | boxes -d stone           # Stone border
-echo "Hello World" | boxes -d parchment       # Parchment scroll
-echo "Hello World" | boxes -d cat             # Cat border
-echo "Hello World" | boxes -d dog             # Dog border
-echo "Hello World" | boxes -d unicornsay      # Unicorn
-echo "Hello World" | boxes -d diamonds        # Diamond pattern
-echo "Hello World" | boxes -d c-cmt           # C-style comment
-echo "Hello World" | boxes -d html-cmt        # HTML comment
-echo "Hello World" | boxes -a c               # Center text
-boxes -l                                       # List all 70+ designs
-```
-### Combine with pyfiglet or asciified
-```bash
-python -m pyfiglet "HERMES" -f slant | boxes -d stone
-# Or without pyfiglet installed:
-curl -s "https://asciified.thelicato.io/api/v2/ascii?text=HERMES&font=Slant" | boxes -d stone
-```
-## Tool 5: TOIlet (Colored Text Art)
-Like pyfiglet but with ANSI color effects and visual filters. Great for terminal eye candy.
-### Setup
-```bash
-sudo apt install toilet toilet-fonts -y    # Debian/Ubuntu
-# brew install toilet                      # macOS
-```
-### Usage
-```bash
-toilet "Hello World"                    # Basic text art
-toilet -f bigmono12 "Hello"            # Specific font
-toilet --gay "Rainbow!"                 # Rainbow coloring
-toilet --metal "Metal!"                 # Metallic effect
-toilet -F border "Bordered"             # Add border
-toilet -F border --gay "Fancy!"         # Combined effects
-toilet -f pagga "Block"                 # Block-style font (unique to toilet)
-toilet -F list                          # List available filters
-```
-### Filters
-`crop`, `gay` (rainbow), `metal`, `flip`, `flop`, `180`, `left`, `right`, `border`
-**Note**: toilet outputs ANSI escape codes for colors — works in terminals but may not render in all contexts (e.g., plain text files, some chat platforms).
-## Tool 6: Image to ASCII Art
-Convert images (PNG, JPEG, GIF, WEBP) to ASCII art.
-### Option A: ascii-image-converter (recommended, modern)
-```bash
-# Install
-sudo snap install ascii-image-converter
-# OR: go install github.com/TheZoraiz/ascii-image-converter@latest
-```
-```bash
-ascii-image-converter image.png                  # Basic
-ascii-image-converter image.png -C               # Color output
-ascii-image-converter image.png -d 60,30         # Set dimensions
-ascii-image-converter image.png -b               # Braille characters
-ascii-image-converter image.png -n               # Negative/inverted
-ascii-image-converter https://url/image.jpg      # Direct URL
-ascii-image-converter image.png --save-txt out   # Save as text
-```
-### Option B: jp2a (lightweight, JPEG only)
-```bash
-sudo apt install jp2a -y
-jp2a --width=80 image.jpg
-jp2a --colors image.jpg              # Colorized
-```
-## Tool 7: Search Pre-Made ASCII Art
-Search curated ASCII art from the web. Use `terminal` with `curl`.
-### Source A: ascii.co.uk (recommended for pre-made art)
-Large collection of classic ASCII art organized by subject. Art is inside HTML `<pre>` tags. Fetch the page with curl, then extract art with a small Python snippet.
-**URL pattern:** `https://ascii.co.uk/art/{subject}`
-**Step 1 — Fetch the page:**
-```bash
-curl -s 'https://ascii.co.uk/art/cat' -o /tmp/ascii_art.html
-```
-**Step 2 — Extract art from pre tags:**
-```python
-import re, html
-with open('/tmp/ascii_art.html') as f:
-    text = f.read()
-arts = re.findall(r'<pre[^>]*>(.*?)</pre>', text, re.DOTALL)
-for art in arts:
-    clean = re.sub(r'<[^>]+>', '', art)
-    clean = html.unescape(clean).strip()
-    if len(clean) > 30:
-        print(clean)
-        print('\n---\n')
-```
-**Available subjects** (use as URL path):
-- Animals: `cat`, `dog`, `horse`, `bird`, `fish`, `dragon`, `snake`, `rabbit`, `elephant`, `dolphin`, `butterfly`, `owl`, `wolf`, `bear`, `penguin`, `turtle`
-- Objects: `car`, `ship`, `airplane`, `rocket`, `guitar`, `computer`, `coffee`, `beer`, `cake`, `house`, `castle`, `sword`, `crown`, `key`
-- Nature: `tree`, `flower`, `sun`, `moon`, `star`, `mountain`, `ocean`, `rainbow`
-- Characters: `skull`, `robot`, `angel`, `wizard`, `pirate`, `ninja`, `alien`
-- Holidays: `christmas`, `halloween`, `valentine`
-**Tips:**
-- Preserve artist signatures/initials — important etiquette
-- Multiple art pieces per page — pick the best one for the user
-- Works reliably via curl, no JavaScript needed
-### Source B: GitHub Octocat API (fun easter egg)
-Returns a random GitHub Octocat with a wise quote. No auth needed.
-```bash
-curl -s https://api.github.com/octocat
-```
-## Tool 8: Fun ASCII Utilities (via curl)
-These free services return ASCII art directly — great for fun extras.
-### QR Codes as ASCII Art
-```bash
-curl -s "qrenco.de/Hello+World"
-curl -s "qrenco.de/https://example.com"
-```
-### Weather as ASCII Art
-```bash
-curl -s "wttr.in/London"          # Full weather report with ASCII graphics
-curl -s "wttr.in/Moon"            # Moon phase in ASCII art
-curl -s "v2.wttr.in/London"       # Detailed version
-```
-## Tool 9: LLM-Generated Custom Art (Fallback)
-When tools above don't have what's needed, generate ASCII art directly using these Unicode characters:
-### Character Palette
-**Box Drawing:** `╔ ╗ ╚ ╝ ║ ═ ╠ ╣ ╦ ╩ ╬ ┌ ┐ └ ┘ │ ─ ├ ┤ ┬ ┴ ┼ ╭ ╮ ╰ ╯`
-**Block Elements:** `░ ▒ ▓ █ ▄ ▀ ▌ ▐ ▖ ▗ ▘ ▝ ▚ ▞`
-**Geometric & Symbols:** `◆ ◇ ◈ ● ○ ◉ ■ □ ▲ △ ▼ ▽ ★ ☆ ✦ ✧ ◀ ▶ ◁ ▷ ⬡ ⬢ ⌂`
-### Rules
-- Max width: 60 characters per line (terminal-safe)
-- Max height: 15 lines for banners, 25 for scenes
-- Monospace only: output must render correctly in fixed-width fonts
-## Decision Flow
-1. **Text as a banner** → pyfiglet if installed, otherwise asciified API via curl
-2. **Wrap a message in fun character art** → cowsay
-3. **Add decorative border/frame** → boxes (can combine with pyfiglet/asciified)
-4. **Art of a specific thing** (cat, rocket, dragon) → ascii.co.uk via curl + parsing
-5. **Convert an image to ASCII** → ascii-image-converter or jp2a
-6. **QR code** → qrenco.de via curl
-7. **Weather/moon art** → wttr.in via curl
-8. **Something custom/creative** → LLM generation with Unicode palette
-9. **Any tool not installed** → install it, or fall back to next option