# Jared's Claude Code Plugins
A collection of Claude Code plugins for modern web development.
## Quick Install
```bash
# Add the marketplace
/plugin marketplace add jaredpalmer/claude-plugins
# Install the plugins
/plugin install jp@jp
```
## Available Skills
### GitHub Code Search
Search GitHub code across millions of repositories using grep.app. Find implementations, patterns, and examples from public codebases.
**Usage:**
```bash
bun run skills/github-code-search/scripts/search.ts "query" [--lang=TypeScript] [--repo=owner/repo] [--limit=10] [--regexp]
```
**Examples:**
```bash
# Find "use cache" implementations
bun run skills/github-code-search/scripts/search.ts "use cache" --lang=TypeScript --limit=5
# Search a specific repo
bun run skills/github-code-search/scripts/search.ts "cacheLife" --repo=vercel/next.js
```
**When to use:**
- Find implementations of specific patterns
- Search for API/library usage examples
- Research best practices across popular repositories
- Find code snippets matching regex patterns
---
### Next.js PPR & Caching Reviewer
Automatically reviews Next.js App Router code for optimal Partial Prerendering (PPR), caching strategy, Suspense boundaries, and React Query integration.
**Triggers automatically when:**
- Creating pull requests with Next.js components
- Implementing data-fetching features
- Adding or modifying Suspense boundaries
- Implementing caching strategies
**What it checks:**
- `'use cache'` and `'use cache: private'` directive usage
- `cacheLife()` and `cacheTag()` configuration
- Suspense boundary placement (deep vs shallow)
- Auth/data fetching separation patterns
- React Query SSR integration
- Build output verification (◐ vs ○ vs ƒ)
**Requires:** Next.js 16+ with `cacheComponents: true`
---
### X/Twitter Changelog Post Writer
A command that helps write polished X/Twitter changelog posts following best practices for developer marketing.
**Usage:**
```bash
/jp:x-changelog <description of your update>
```
**What it does:**
- Writes changelog posts optimized for X/Twitter algorithm
- Follows strict formatting: headline + 3-4 bullets + optional CTA
- Avoids hashtags, emoji, and passive voice
- Uses proper Unicode whitespace to control URL unfurling
- Asks clarifying questions about media and target audience
**Example:**
```bash
/jp:x-changelog We just shipped instant rollbacks for all deployments
```
## Local Development
Test plugins locally before publishing:
```bash
# Add your local directory as a marketplace
/plugin marketplace add /Users/you/path/to/claude-plugins
# Install and test
/plugin install jp@jp
```
## Adding New Components
### Skills (Auto-invoked by Claude)
Create `skills/<skill-name>/SKILL.md`:
```markdown
---
name: my-skill
description: When Claude should invoke this skill
---
# Skill Title
Instructions for the skill...
```
### Commands (User-invoked via `/command`)
Create `commands/my-command.md`:
```markdown
---
description: Brief description of what the command does
argument-hint: <expected arguments>
---
Instructions for what the command does.
```
Usage: `/jp:my-command`
### Agents (Task-based workers)
Create `agents/my-agent.md`:
```markdown
---
description: When to use this agent
tools: Glob, Grep, Read, Edit
---
Instructions for the agent...
```
## Documentation
For more information on creating Claude Code plugins, see the [official plugin documentation](https://docs.anthropic.com/en/docs/claude-code/plugins).
## License
MIT