ray-ai-skills

Initialize Claude Code in a repository with standard project scaffolding. Use this skill whenever the user wants to set up Claude Code in a new repo, initialize claude configuration, run /init with extras, or mentions "ray-init". This goes beyond the built-in /init by adding gitignore rules, Sideways files, and a local planning doc.

Test-Driven Development discipline for writing code. Use this skill whenever writing new features, adding behavior, refactoring with tests, fixing bugs with regression tests, or when the user mentions TDD, red-green-refactor, test-first, failing tests, or asks to write tests before implementation. Also triggers when branch plans contain FAILING test tasks or test-first instructions.

Create a plan document for the current branch, or for a specified new/existing branch. The complete template and all instructions are provided below — do not search for examples elsewhere.

Plan and track a bugfix with diagnosis-first discipline — create a BUGFIX.<branch>.md working doc, trace the reported symptom to a proven root cause, and write a failing test that reproduces the bug BEFORE fixing it. Use when the user reports a bug to fix, asks to investigate or diagnose a defect, starts a bugfix branch, or mentions "ray-bugfix-plan". The complete template and all instructions are below — do not search for examples elsewhere.

Audit skill source files for personal references, credentials, and other publication blockers before mirroring them into the ray-ai-skills public repo. Use this skill whenever the user wants to audit one or more skills, check skills before publishing/syncing, look for hardcoded paths or sensitive content in skills, or asks "audit my skills". If no specific skills are named, audit every skill that has changed since the last sync (or is new and not yet mirrored).

Update the ray-ai-skills repo from source skills under ~/.claude/skills/ — audit, then sync, then stop before commit. Also handles adding a new skill to .shared-skills, removing a skill from the mirror, or auditing without syncing. Use this skill whenever the user wants to sync skills into the repo, publish skill changes, update the skills mirror, add a skill to the shared list, remove a skill from the shared list, or says "skills-update". Accepts natural-language targets like "sync all", "update ray-tdd and ray-commit", "remove ray-foo", "audit only", etc.

Review a branch's implementation against its branch plan

Squash branch commits into meaningful groups via scripted interactive rebase

Domain-Driven Design architecture patterns and conventions for this project

Find and retrieve academic papers/PDFs from the user's ReadCube Papers reference library (default location on macOS: `~/Documents/Papers Library/`). Use this skill whenever the user asks to find, retrieve, locate, search for, or get a paper, PDF, reference, citation, or article from their library. Trigger on phrases like "find the PDF", "retrieve the pdf", "can you retrieve", "do you have the paper", "locate the paper", "search my papers", "from my Papers app", "in my library", "where is that file", or when the user references a specific author/year combination that needs to be found as a file. Also trigger when the user says "do you wish I provide a PDF" or similar — check the library first before asking the user to provide it. Also trigger when the user asks about categorization, collections, lists, tags, or how papers are organized — e.g., "what papers do I have on logistic regression", "what list is this paper in", "show me my collections", "papers tagged with X", "check my papers library for".

Generate or update an event poster PDF. Use this skill whenever the user wants to change poster content (text, dates, speaker info, sponsors), adjust poster layout or styling (fonts, spacing, colors, sections), add/remove/resize logos or images, or regenerate the poster PDF. Also use when the user mentions "poster", "flyer", "event poster", or references event-poster/ files.

Push branch and create or update a GitHub PR with a structured description derived from the branch plan

Analyze branch changes for test gaps, then generate a demo-based manual test plan that Claude Code can execute

Convert a raw transcript (talk, lecture, workshop, podcast) into a clean, flowing speech document organized by topical sections. Use this skill whenever the user wants to clean up a transcript, convert a talk recording to prose, speechify a transcript, or turn raw spoken content into a polished document. Trigger on phrases like "speechify", "clean up this transcript", "turn this transcript into a speech", "polish this talk", "convert transcript to prose".