Agent Skills for AI coding assistants. These skills follow the Agent Skills Standard and work with Claude Code, Cursor, Gemini Code Assist, GitHub Copilot, and other compatible tools.
npx skills add Shpigford/skillsOr manually:
git clone https://github.com/Shpigford/skills.git ~/.skills/shpigford| Skill | Description |
|---|---|
| build | Feature development pipeline - research, plan, track, implement |
| but-for-real | Force a skeptical second pass on your own work |
| chat-widget | Build real-time support chat with floating widget |
| conductor-setup | Configure Rails projects for Conductor |
| favicon | Generate favicon sets from source images |
| feature-image | Generate branded social media images for feature announcements |
| issues | Create, list, and view GitHub issues |
| new-rails-project | Create opinionated Rails 8 + React projects |
| readme | Generate comprehensive project documentation |
| screenshots | Generate marketing screenshots with Playwright |
Creates comprehensive README.md documentation for projects. Performs deep codebase exploration before writing, covering:
- Local development setup (step-by-step)
- Architecture overview with directory structure and data flow
- Environment variables reference
- Deployment instructions (auto-detects platform)
- Troubleshooting common issues
Triggers: "write readme", "create readme", "document this project", "project documentation"
Example usage:
Write a readme for this project
Feature development pipeline for building major features. Manages a 4-phase workflow:
- Research - Deep exploration of a feature idea
- Implementation - Create phased implementation plan
- Progress - Set up progress tracking
- Phase execution - Implement each phase with tracking
Subcommands:
/build research [name] Deep research on a feature idea
/build implementation [name] Create phased implementation plan
/build progress [name] Set up progress tracking
/build phase [n] [name] Execute implementation phase n
/build status [name] Show status and next steps
Example workflow:
/build research chat-interface
/build implementation chat-interface
/build progress chat-interface
/build phase 1 chat-interface
Force a skeptical second pass on your own work. Runs after you've made changes to catch the things you missed — wrong logic, forgotten tests, unused imports, scope creep, and the classic "it should work" without actually running it.
What it checks:
- Did you actually do what was asked (and only what was asked)?
- Would you approve this if someone else wrote it?
- What did you forget? (Tests, references, TODOs)
- Did you run it?
Triggers: "but for real", "did that actually work", "review your own work", "check yourself"
Example usage:
/but-for-real
Build a real-time support chat system with a floating widget for users and an admin dashboard for support staff.
Features:
- Floating chat button with unread badge
- WebSocket-based real-time messaging
- Admin dashboard with active/archived chat management
- Email notifications (delayed to avoid spam)
- Framework-agnostic architecture guide
Includes:
- Data model schemas (chats, messages)
- API endpoint specifications
- WebSocket channel implementations
- Frontend components (React, Vue examples)
- Framework-specific code (Rails, Laravel, Next.js)
Triggers: "add a live chat widget", "build customer support chat", "create real-time messaging"
Example usage:
Add a live chat widget to the app
Configure a Rails project to work with Conductor, the Mac app for parallel coding agents. Creates:
conductor.json- Project configurationbin/conductor-setup- Setup script for worktreesscript/server- Server script with port/Redis isolation- Updates Rails config files to use
ENV['REDIS_URL']
Example usage:
Set up this project for Conductor
Generate a complete set of favicons from a source image. Auto-detects project type (Rails, Next.js, Vite, static HTML, etc.) and places files in the correct location.
Generates:
favicon.ico(multi-resolution: 16x16, 32x32, 48x48)favicon-96x96.pngapple-touch-icon.png(180x180)web-app-manifest-192x192.pngweb-app-manifest-512x512.pngsite.webmanifestfavicon.svg(if source is SVG)
Requires: ImageMagick v7+ (brew install imagemagick)
Example usage:
/favicon logo.png
/favicon assets/icon.svg
Generate branded social media images for announcing features or updates. Analyzes git history to detect what changed, auto-detects brand from your codebase (Tailwind, CSS vars, design tokens), and captures via Playwright.
Features:
- Git-aware: auto-detects recent feature work from commits, diffs, and branch names
- Deep brand analysis: studies marketing pages, OG images, color palettes, typography, and visual patterns
- Three visual styles: stylized mockup, screenshot + overlay, or abstract/illustrative
- Multiple platform sizes: Twitter/X, LinkedIn, Instagram, Open Graph
Requires: Playwright (npx playwright install chromium)
Triggers: "feature image", "announcement graphic", "social image for feature"
Example usage:
/feature-image dark mode support
Generate a social image for the new feature
Interact with GitHub issues using the gh CLI. Create, list, and view issues with guided prompts.
Actions:
- Create - Open new issues with title, body, labels (guides you through bug reports vs features)
- List - View open issues with filters (all, assigned to me, by label)
- View - See details of a specific issue by number
Requires: GitHub CLI (gh) authenticated
Example usage:
/issues
Create a new Rails project with an opinionated modern stack:
- Rails 8 with PostgreSQL (UUID primary keys, timestamptz)
- Inertia.js + React 19 with TypeScript
- Vite 5 for frontend bundling
- Tailwind CSS 4
- Sidekiq 8 with Redis for background jobs
- Redis for sessions and caching
Includes testing setup (minitest, mocha, VCR) and code quality tools (RuboCop, Brakeman).
Example usage:
/new-rails-project my-app
Generate marketing-quality screenshots of your app using Playwright. Captures at true HiDPI (2x retina) resolution.
Features:
- Auto-detects routes and features from your codebase
- Handles authentication automatically
- Produces 2880x1800 retina-quality images
- Supports dark mode, modals, and full-page captures
Requires: Playwright (npm install -D playwright)
Example usage:
/screenshots http://localhost:3000
Generate screenshots for Product Hunt
These skills work with any Agent Skills Standard-compatible tool:
- Claude Code (Anthropic)
- Cursor
- Gemini Code Assist (Google)
- GitHub Copilot (Microsoft)
MIT