better-dsh 0.2.5 → 0.3.0-c

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-architecture-diagram.md

@@ -1,165 +0,0 @@
----
-title: "Architecture Diagram — Dark-themed SVG architecture/cloud/infra diagrams as HTML"
-sidebar_label: "Architecture Diagram"
-description: "Dark-themed SVG architecture/cloud/infra diagrams as HTML"
----
-
-{/* 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. */}
-
-# Architecture Diagram
-
-Dark-themed SVG architecture/cloud/infra diagrams as HTML.
-
-## Skill metadata
-
-| | |
-|---|---|
-| Source | Bundled (installed by default) |
-| Path | `skills/creative\architecture-diagram` |
-| Version | `1.0.0` |
-| Author | Cocoon AI (hello@cocoon-ai.com), ported by Hermes Agent |
-| License | MIT |
-| Platforms | linux, macos, windows |
-| Tags | `architecture`, `diagrams`, `SVG`, `HTML`, `visualization`, `infrastructure`, `cloud` |
-| Related skills | [`concept-diagrams`](/docs/user-guide/skills/optional/creative/creative-concept-diagrams), [`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.
-:::
-
-# Architecture Diagram Skill
-
-Generate professional, dark-themed technical architecture diagrams as standalone HTML files with inline SVG graphics. No external tools, no API keys, no rendering libraries — just write the HTML file and open it in a browser.
-
-## Scope
-
-**Best suited for:**
-- Software system architecture (frontend / backend / database layers)
-- Cloud infrastructure (VPC, regions, subnets, managed services)
-- Microservice / service-mesh topology
-- Database + API map, deployment diagrams
-- Anything with a tech-infra subject that fits a dark, grid-backed aesthetic
-
-**Look elsewhere first for:**
-- Physics, chemistry, math, biology, or other scientific subjects
-- Physical objects (vehicles, hardware, anatomy, cross-sections)
-- Floor plans, narrative journeys, educational / textbook-style visuals
-- Hand-drawn whiteboard sketches (consider `excalidraw`)
-- Animated explainers (consider an animation skill)
-
-If a more specialized skill is available for the subject, prefer that. If none fits, this skill can also serve as a general SVG diagram fallback — the output will just carry the dark tech aesthetic described below.
-
-Based on [Cocoon AI's architecture-diagram-generator](https://github.com/Cocoon-AI/architecture-diagram-generator) (MIT).
-
-## Workflow
-
-1. User describes their system architecture (components, connections, technologies)
-2. Generate the HTML file following the design system below
-3. Save with `write_file` to a `.html` file (e.g. `~/architecture-diagram.html`)
-4. User opens in any browser — works offline, no dependencies
-
-### Output Location
-
-Save diagrams to a user-specified path, or default to the current working directory:
-```
-./[project-name]-architecture.html
-```
-
-### Preview
-
-After saving, suggest the user open it:
-```bash
-# macOS
-open ./my-architecture.html
-# Linux
-xdg-open ./my-architecture.html
-```
-
-## Design System & Visual Language
-
-### Color Palette (Semantic Mapping)
-
-Use specific `rgba` fills and hex strokes to categorize components:
-
-| Component Type | Fill (rgba) | Stroke (Hex) |
-| :--- | :--- | :--- |
-| **Frontend** | `rgba(8, 51, 68, 0.4)` | `#22d3ee` (cyan-400) |
-| **Backend** | `rgba(6, 78, 59, 0.4)` | `#34d399` (emerald-400) |
-| **Database** | `rgba(76, 29, 149, 0.4)` | `#a78bfa` (violet-400) |
-| **AWS/Cloud** | `rgba(120, 53, 15, 0.3)` | `#fbbf24` (amber-400) |
-| **Security** | `rgba(136, 19, 55, 0.4)` | `#fb7185` (rose-400) |
-| **Message Bus** | `rgba(251, 146, 60, 0.3)` | `#fb923c` (orange-400) |
-| **External** | `rgba(30, 41, 59, 0.5)` | `#94a3b8` (slate-400) |
-
-### Typography & Background
-- **Font:** JetBrains Mono (Monospace), loaded from Google Fonts
-- **Sizes:** 12px (Names), 9px (Sublabels), 8px (Annotations), 7px (Tiny labels)
-- **Background:** Slate-950 (`#020617`) with a subtle 40px grid pattern
-
-```svg
-<!-- Background Grid Pattern -->
-<pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse">
-  <path d="M 40 0 L 0 0 0 40" fill="none" stroke="#1e293b" stroke-width="0.5"/>
-</pattern>
-```
-
-## Technical Implementation Details
-
-### Component Rendering
-Components are rounded rectangles (`rx="6"`) with 1.5px strokes. To prevent arrows from showing through semi-transparent fills, use a **double-rect masking technique**:
-1. Draw an opaque background rect (`#0f172a`)
-2. Draw the semi-transparent styled rect on top
-
-### Connection Rules
-- **Z-Order:** Draw arrows *early* in the SVG (after the grid) so they render behind component boxes
-- **Arrowheads:** Defined via SVG markers
-- **Security Flows:** Use dashed lines in rose color (`#fb7185`)
-- **Boundaries:**
-  - *Security Groups:* Dashed (`4,4`), rose color
-  - *Regions:* Large dashed (`8,4`), amber color, `rx="12"`
-
-### Spacing & Layout Logic
-- **Standard Height:** 60px (Services); 80-120px (Large components)
-- **Vertical Gap:** Minimum 40px between components
-- **Message Buses:** Must be placed *in the gap* between services, not overlapping them
-- **Legend Placement:** **CRITICAL.** Must be placed outside all boundary boxes. Calculate the lowest Y-coordinate of all boundaries and place the legend at least 20px below it.
-
-## Document Structure
-
-The generated HTML file follows a four-part layout:
-1. **Header:** Title with a pulsing dot indicator and subtitle
-2. **Main SVG:** The diagram contained within a rounded border card
-3. **Summary Cards:** A grid of three cards below the diagram for high-level details
-4. **Footer:** Minimal metadata
-
-### Info Card Pattern
-```html
-<div class="card">
-  <div class="card-header">
-    <div class="card-dot cyan"></div>
-    <h3>Title</h3>
-  </div>
-  <ul>
-    <li>• Item one</li>
-    <li>• Item two</li>
-  </ul>
-</div>
-```
-
-## Output Requirements
-- **Single File:** One self-contained `.html` file
-- **No External Dependencies:** All CSS and SVG must be inline (except Google Fonts)
-- **No JavaScript:** Use pure CSS for any animations (like pulsing dots)
-- **Compatibility:** Must render correctly in any modern web browser
-
-## Template Reference
-
-Load the full HTML template for the exact structure, CSS, and SVG component examples:
-
-```
-skill_view(name="architecture-diagram", file_path="templates/template.html")
-```
-
-The template contains working examples of every component type (frontend, backend, database, cloud, security), arrow styles (standard, dashed, curved), security groups, region boundaries, and the legend — use it as your structural reference when generating diagrams.

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

@@ -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 | Bundled (installed by default) |
-| Path | `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/bundled/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
-python3 -m pyfiglet "YOUR TEXT" -f slant
-python3 -m pyfiglet "TEXT" -f doom -w 80    # Set width
-python3 -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
-python3 -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