ctf-writeup-generator

# CTF Writeup Generator

## Description

This skill helps CTF players, security researchers, and cybersecurity educators automatically generate professional writeups from their solving sessions. It intelligently detects flag formats, categorizes challenges, structures the writeup with proper headings, and includes code blocks with syntax highlighting.

Perfect for:
- Creating platform-specific writeups (HackTheBox, TryHackMe, OffSec, etc.)
- Documenting Jeopardy-style CTF solutions
- Generating educational content for training materials
- Building a portfolio of security research

## When to Use

Use this skill when the user:
- Says "generate a CTF writeup"
- Mentions "document my CTF solution"
- Asks to "create a writeup for [challenge name]"
- References completing a CTF challenge and needs documentation
- Wants to format their solving process professionally
- Needs to extract and format flags from their notes

## Features

### Flag Format Detection
Automatically detects and validates common CTF flag formats:
- `CTF{...}`, `FLAG{...}`, `flag{...}`
- Platform-specific: `HTB{...}`, `THM{...}`, `SHAASTRA{...}`, `picoCTF{...}`
- Custom regex patterns for competition-specific formats
- Case-sensitive validation support

### Challenge Categories
Automatically categorizes based on keywords and tools used:
- **Web Exploitation**: SQL injection, XSS, CSRF, authentication bypass
- **Binary Exploitation**: Buffer overflow, ROP, format strings, heap exploitation
- **Reverse Engineering**: Binary analysis, decompilation, obfuscation
- **Cryptography**: Classical ciphers, modern crypto, hash cracking
- **Forensics**: Steganography, memory forensics, network analysis, disk imaging
- **OSINT**: Information gathering, social media analysis
- **PWN**: Exploitation, shellcode, privilege escalation
- **Miscellaneous**: Mixed or unique challenge types

### Structured Output
Generates properly formatted markdown writeups with:
- Challenge metadata (name, category, difficulty, points)
-...

# CTF Writeup Generator - OpenClaw Skill

A professional skill for OpenClaw that automatically generates structured CTF writeups from solving sessions.

## Features

- 🎯 **Automatic Flag Detection**: Recognizes common CTF flag formats (CTF{}, HTB{}, SHAASTRA{}, etc.)
- 📂 **Smart Categorization**: Auto-categorizes challenges (Web, Binary, Crypto, Forensics, etc.)
- 📝 **Professional Formatting**: Generates markdown with proper syntax highlighting
- 🛠️ **Tool Recognition**: Identifies and documents tools used during the solve
- 🎨 **Multiple Templates**: Academic, speedrun, tutorial, and portfolio styles
- 📤 **Export Options**: Markdown, PDF, HTML formats

## Installation

### Via ClawHub (Recommended)

```bash
# Install globally
npm install -g clawhub

# Install the skill
clawhub install ctf-writeup-generator
```

### Manual Installation

1. Clone or download this skill directory
2. Copy to your OpenClaw skills folder:
   ```bash
   cp -r ctf-writeup-generator ~/.openclaw/skills/
   ```
3. Restart OpenClaw or reload skills

## Usage

Simply ask your OpenClaw agent to generate a writeup:

```
"Generate a CTF writeup for the Binary Bash challenge I just solved"
"Create a writeup for this web exploitation challenge"
"Document my forensics challenge solution"
```

### Example Conversation

**You**: I just solved a buffer overflow challenge called "Stack Smasher" from HackTheBox. I used gdb and python to craft the exploit. The flag was HTB{st4ck_sm4sh1ng_fun}. Can you create a writeup?

**OpenClaw**: 
- Asks for additional details (exact steps, tools, payloads)
- Generates a professional writeup with:
  - Challenge metadata
  - Step-by-step solution
  - Code blocks with syntax highlighting
  - Tools documentation
  - Learning takeaways
- Saves to `hackthebox_stack-smasher_writeup.md`

## Configuration

Set environment variables for personalization:

```bash
# In your shell config (~/.bashrc, ~/.zshrc, etc.)
export CTF_AUTHOR="akm626"
export CTF_PLATFORM="HackTheBox"
ex...