# Viral

> Detect trends, score shareability, and write viral hooks. Use when crafting headlines, optimizing post timing, analyzing engagement, or drafting hooks.

- Skill: `bytesagain/viral` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add bytesagain/viral`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bytesagain/viral/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT-0
- Author: bytesagain (https://skillmd.com/u/bytesagain)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/bytesagain/viral

---


# Viral

Viral content toolkit — trend detection, shareability scoring, hook writing, timing optimization, and performance prediction.

## Commands

| Command | Description |
|---------|-------------|
| `viral run` | Execute main function |
| `viral list` | List all items |
| `viral add <item>` | Add new item |
| `viral status` | Show current status |
| `viral export <format>` | Export data |
| `viral help` | Show help |

## Usage

```bash
# Show help
viral help

# Quick start
viral run
```

## Examples

```bash
# Run with defaults
viral run

# Check status
viral status

# Export results
viral export json
```

- Run `viral help` for all commands
- Data stored in `~/.local/share/viral/`

---
*Powered by BytesAgain | bytesagain.com*
*Feedback & Feature Requests: https://bytesagain.com/feedback*

## Output

Results go to stdout. Save with `viral run > output.txt`.

## Output

Results go to stdout. Save with `viral run > output.txt`.

## Configuration

Set `VIRAL_DIR` to change data directory. Default: `~/.local/share/viral/`