JeffreysPrompts.com

<div align="center">

<img src="illustration.webp" alt="JeffreysPrompts.com - A friendly robot shopping for prompts in a cozy prompt shop, with shelves of labeled prompt scrolls and a terminal showing 'jfp export idea-wizard'">

# JeffreysPrompts.com

**A curated collection of battle-tested prompts for agentic coding**

[![Next.js](https://img.shields.io/badge/Next.js-16-black?style=flat-square&logo=next.js)](https://nextjs.org/)
[![React](https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react)](https://react.dev/)
[![Bun](https://img.shields.io/badge/Bun-1.x-FBF0DF?style=flat-square&logo=bun)](https://bun.sh/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT%2BOpenAI%2FAnthropic%20Rider-blue.svg?style=flat-square)](./LICENSE)

---

*"Where'd you get that prompt?! It's lovely!"*<br>
*"Oh, this old thing? I got it at JeffreysPrompts.com."*

---

**Browse. Copy. Export markdown. Ship faster.**

</div>

## What is JeffreysPrompts.com?

JeffreysPrompts.com is a platform for discovering, copying, and exporting curated prompts that supercharge your work with AI coding agents like Claude Code, Codex CLI, and Gemini CLI.

It's two things in one:

| Component | Purpose |
|-----------|---------|
| **Web App** | Beautiful UI to browse, search, filter, and copy prompts |
| **CLI Tool (`jfp`)** | Agent-optimized command-line interface with JSON output |

Claude Code skills are managed separately in **Jeffrey's Skills.md** (`jsm`). JFP focuses on prompts and markdown export.

```
┌─────────────────────────────────────────────────────────────────────────┐
│                                                                         │
│   YOU                    jeffreysprompts.com                   AGENT    │
│    │                            │                                  │    │
│    ├─── Browse prompts ────────►│                                  │    │
│    │                            │                                  │    │
│    ├─── Copy/export ───────────►│────── jfp export ───────────────►│    │
│    │                            │            prompt.md             │    │
│    │◄───── Agent uses prompt ───│◄─────────────────────────────────│    │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘
```

---

## The Prompts

These prompts come from Jeffrey Emanuel's "My Favorite Prompts" series on Twitter. They're battle-tested patterns refined through extensive real-world usage with AI coding agents.

### The Idea Wizard

> *Generate 30 improvement ideas, rigorously evaluate each, distill to the very best 5*

The key insight: by forcing the agent to generate many ideas and then critically evaluate them, you get much better results than asking for "5 good ideas" directly.

### The README Reviser

> *Update documentation for recent changes, framing them as "how it always was"*

Addresses documentation drift. The framing trick produces cleaner, more professional docs.

### The Robot-Mode Maker

> *Create an agent-optimized CLI for any project*

Builds what the agent would want to use, because it WILL be using it. JSON output, token efficiency, quick-start mode.

**...and more.** Each prompt includes when to use it, tips, and examples.

---

## Table of Contents

- [Quick Start](#quick-start)
  - [Web App](#web-app)
  - [CLI Tool](#cli-tool)
- [Features](#features)
  - [Web App Features](#web-app-features)
  - [CLI Features](#cli-features)
- [The jfp CLI](#the-jfp-cli)
  - [Installation](#cli-installation)
  - [Commands](#cli-commands)
  - [Robot Mode](#robot-mode)
- [Architecture](#architecture)
  - [TypeScript-Native Prompts](#typescript-native-prompts)
  - [Project Structure](#project-structure)
- [Development](#development)
  - [Prerequisites](#prerequisites)
  - [Setup](#setup)
  - [Quality Gates](#quality-gates)
- [The Making-Of Page](#the-making-of-page)
- [Design Philosophy](#design-philosophy)
- [Contributing](#contributing)
- [License](#license)

---

## Quick Start

### Web App

Visit **[jeffreysprompts.com](https://jeffreysprompts.com)** to:

1. Browse all prompts with search and filtering
2. Click any prompt to copy it to your clipboard
3. Add prompts to your basket for bulk export
4. Download as markdown

### CLI Tool

```bash
curl -fsSL "https://jeffreysprompts.com/install-cli.sh?$(date +%s)" | bash
```

Usage:

```bash
# List all prompts
jfp list

# Fuzzy search
jfp search "brainstorm"

# View a prompt
jfp show idea-wizard

# Copy to clipboard
jfp copy idea-wizard

# Interactive mode (fzf-style)
jfp i
```

### Skills (JSM)

Claude Code skills are managed in **Jeffrey's Skills.md** (`jsm`). Use JFP for prompts and markdown export; use JSM for skills management.

---

## Features

### Web App Features

| Feature | Description |
|---------|-----------

... (truncated)