Improve README styling

Author: t3chn

README.md

@@ -1,42 +1,94 @@
-# Loadout
+```
+██╗      ██████╗  █████╗ ██████╗  ██████╗ ██╗   ██╗████████╗
+██║     ██╔═══██╗██╔══██╗██╔══██╗██╔═══██╗██║   ██║╚══██╔══╝
+██║     ██║   ██║███████║██║  ██║██║   ██║██║   ██║   ██║
+██║     ██║   ██║██╔══██║██║  ██║██║   ██║██║   ██║   ██║
+███████╗╚██████╔╝██║  ██║██████╔╝╚██████╔╝╚██████╔╝   ██║
+╚══════╝ ╚═════╝ ╚═╝  ╚═╝╚═════╝  ╚═════╝  ╚═════╝    ╚═╝
+```
+
+<div align="center">
+
+[![Typing SVG](https://readme-typing-svg.demolab.com?font=Fira+Code&weight=500&size=20&duration=2500&pause=800&color=00FF00&center=true&vCenter=true&width=520&lines=%24+loadout+--help;manifest+%2B+lock+%2B+symlinks;codex+%7C+claude;agent-first+skill+management)](https://git.io/typing-svg)
+
+![CI](https://img.shields.io/github/actions/workflow/status/t3chn/loadout/ci.yml?branch=main&style=flat-square&logo=github&logoColor=00ff00&label=ci&labelColor=000000&color=00ff00)
+![License](https://img.shields.io/github/license/t3chn/loadout?style=flat-square&label=license&labelColor=000000&color=00ff00)
+![Rust](https://img.shields.io/badge/rust-stable-000000?style=flat-square&logo=rust&logoColor=00ff00)
+![prek](https://img.shields.io/badge/prek-enabled-000000?style=flat-square&logo=pre-commit&logoColor=00ff00)
+![policy](https://img.shields.io/badge/policy-english--only-000000?style=flat-square&labelColor=000000&color=00ff00)
 
-Machine-first skill manager for project-scoped skills across Codex CLI and Claude Code.
+</div>
 
-## Problem
+---
 
-Projects frequently copy skills from a central skills repository. That creates drift:
+<details open>
+<summary><b>📌 ~/problem</b></summary>
+<br>
+
+Projects often copy skills from a central skills repository. That creates drift:
 
 - the project copy diverges from the source
-- improvements get lost or re-done
+- improvements get lost or duplicated
 - each client (Codex vs Claude) ends up with a different layout and UX
 
-## What this repo does
+</details>
+
+<details open>
+<summary><b>🧠 ~/solution</b></summary>
+<br>
 
 Loadout makes skill usage reproducible and agent-friendly:
 
-- Uses a **manifest + lock** (pinned commit SHAs) committed in the project.
-- Clones skill sources into a **gitignored runtime cache** per project.
-- Exports selected skills into `.codex/skills/` and `.claude/skills/` via **symlinks**.
-- Enforces **explicit trust** for third-party sources (supply-chain gating).
-- Outputs **JSON by default** (including errors), so agents can parse reliably.
+- **manifest + lock** (pinned commit SHAs) committed in the project
+- per-project source clones in `.codex/.loadout/` (gitignored)
+- symlink export into `.codex/skills/` and `.claude/skills/`
+- explicit trust gate for third-party sources
+- JSON by default on stdout (including errors)
+
+Docs:
+
+- `docs/PRD_Skill_Manager.md`
+- `docs/Agent_Playbook.md`
 
-## Project layout
+</details>
 
-- `src/` — `loadout` CLI (Rust)
-- `src/bin/no_cyrillic.rs` — repo policy check: English-only (no Cyrillic)
-- `docs/` — PRD + agent playbook
-- `templates/user-scoped/` — user-scoped wrapper skill templates
+<details>
+<summary><b>🚀 ~/quickstart</b></summary>
+<br>
 
-## Quick start (local dev)
+```bash
+# in a git project
+loadout init --primary-url <skills_repo_url> --primary-ref main
+
+loadout suggest --target codex --query "pdf" --limit 10
+loadout add --target codex pdf-processing
+
+# if you select third-party skills, you must trust the source explicitly
+loadout source trust third --yes
+```
+
+</details>
+
+<details>
+<summary><b>🧪 ~/dev</b></summary>
+<br>
 
 ```bash
 cargo test
 uvx prek run --all-files
 ```
 
-## Notes
+</details>
+
+---
+
+<details>
+<summary><b>🗒️ ~/notes</b></summary>
+<br>
+
+- v1 targets macOS/Linux (symlink export). Windows fallback export is a roadmap item.
 
-- v1 targets macOS/Linux. Windows fallback export is a roadmap item.
+</details>
 
 ## License