my-crazy-skills

# my-crazy-skills

[![OpenCode Security Scan](https://github.com/Keith-CY/my-crazy-skills/actions/workflows/opencode-security-scan.yml/badge.svg?branch=main)](https://github.com/Keith-CY/my-crazy-skills/actions/workflows/opencode-security-scan.yml)

Collection of AI "skills" tracked as git submodules. Categories live under `skills/` and reflect the current organization.

This repo is meant to be *linked* into an agent's skills directory (global or per-project) via `INSTALL.sh`.

## Install

### Quick install (curl)

If you use `curl | sh`, consider inspecting `INSTALL.sh` first.

```bash
curl -fsSL https://raw.githubusercontent.com/Keith-CY/my-crazy-skills/main/INSTALL.sh | sh
```

By default this links skills globally for Codex (`~/.codex/skills`).

### Install from a local clone (recommended)

```bash
git clone --recurse-submodules https://github.com/Keith-CY/my-crazy-skills
cd my-crazy-skills
./INSTALL.sh --help
./INSTALL.sh
```

### Notes and examples

- If no local `skills/` directory is found, the installer auto-clones to `~/.cache/my-crazy-skills`.
- Existing non-symlink destinations are backed up with a `.bak.<timestamp>` suffix.
- If `bun` is available, the installer can generate a de-duplicated tree at `skills/.deduped` (same upstream repo + same commit only) to avoid double-listed skills.
  - `skills/.deduped` is a hidden directory (note the leading `.`). Use `ls -la skills` (or Finder `Cmd+Shift+.`) to view it.
  - The generated `skills/.deduped/MANIFEST.json` is just metadata about what was de-duplicated.
  - Force-generate only: `./INSTALL.sh --dedupe-only`
  - Force raw skills (no dedupe): `./INSTALL.sh --no-dedupe`
  - Force regenerate: `./INSTALL.sh --dedupe --dedupe-force`
  - If `bun` is installed but not on `PATH`, use `BUN_BIN=/path/to/bun` (common: `BUN_BIN=$HOME/.bun/bin/bun`).
- Target other agents:
  - Gemini: `curl -fsSL https://raw.githubusercontent.com/Keith-CY/my-crazy-skills/main/INSTALL.sh | sh -s -- --gemini`
  - Gemini: `curl -fsSL h