my-crazy-skills

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.

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)

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:
  • Claude: curl -fsSL https://raw.githubusercontent.com/Keith-CY/my-crazy-skills/main/INSTALL.sh | sh -s -- --claude
  • Gemini: curl -fsSL https://raw.githubusercontent.com/Keith-CY/my-crazy-skills/main/INSTALL.sh | sh -s -- --gemini
  • OpenCode: curl -fsSL https://raw.githubusercontent.com/Keith-CY/my-crazy-skills/main/INSTALL.sh | sh -s -- --opencode
• Per-project link (Codex example): curl -fsSL https://raw.githubusercontent.com/Keith-CY/my-crazy-skills/main/INSTALL.sh | sh -s -- --project /path/to/project
• Per-project + target (Claude example): curl -fsSL https://raw.githubusercontent.com/Keith-CY/my-crazy-skills/main/INSTALL.sh | sh -s -- --claude --project /path/to/project

Updating

• Local clone: git pull --recurse-submodules (or git submodule update --init --recursive).
• curl | sh installs: re-run the installer (it reuses ~/.cache/my-crazy-skills if present).
• GitHub Actions: Sync Popular Skills from skills.sh (.github/workflows/update-skills-from-skills-sh.yml) can add/update popular skill sources as submodules under skills/popular/.

Development

• If you use git worktree, keep worktrees under .worktree/ (gitignored) and remove the worktree + branch after merging.
• If you need Node.js tooling locally, prefer bun over npm/pnpm/yarn.

Layout

Auto-generated from the skills/ directory.

• skills/creative/
  • skill-prompt-generator
• skills/frontend/
  • ui-skills
  • ui-ux-pro-max-skill
• skills/general/
  • claude-skills
  • clawdhub
  • ipsw-skill
  • mcp-progressive-agentskill
• skills/learning/
  • 33-js-concepts
• skills/platforms/
  • clawdhub
  • marketplace
• skills/popular/
  • anthropics--skills
  • better-auth--skills
  • callstackincubator--agent-skills
  • coreyhaines31--marketingskills
  • expo--skills
  • remotion-dev--skills
  • vercel-labs--agent-browser
  • vercel-labs--agent-skills
• skills/publishing/
  • x-article-publisher-skill
• skills/research/
  • ipsw-skill
  • notebooklm-py
  • notebooklm-skill
• skills/tooling/
  • agent-browser
  • agent-skills
  • claude-code-templates
  • design-engineer-auditor-package
  • mcp-progressive-agentskill
  • resend--email-best-practices
  • skills
• skills/workflows/
  • planning-with-files
  • superpowers