Shakespeare Skills

Complete toolkit for building Nostr-powered applications with React, Tailwind, and Shakespeare deployment.

Installation

Install the skill to your .agents/skills directory:

npx shakespeare-skills

To update an existing installation:

npx shakespeare-skills --force

One skill, everything you need to build, design, and deploy Nostr applications.

Note: This installs the skill files to ~/.agents/skills/shakespeare-skills for use with AI coding agents like OpenCode.

What's Included

🏗️ Foundation

Start here - Base layer for all Nostr app development

• mkstack - Project scaffolding with TypeScript, React, Nostr libraries
• nostr - Protocol knowledge, NIPs, event kinds, implementation patterns
• nostr-tools - JavaScript/TypeScript library for Nostr events and relays

🛠️ Development Tools

Build faster - Tools to streamline development

• nak - Command-line Nostr toolkit (keys, events, relay testing)
• shakespeare-templates - Discover community app templates on Nostr
• opencode - AI-powered coding assistant integration

⚛️ Frontend Framework

UI layer - Best practices for the interface

• react - React 19 patterns, hooks, server components
• web-design - Tailwind CSS, shadcn/ui, animations, accessibility

✨ Application Features

Add functionality - Optional features to enhance your app

• direct-messaging - Private encrypted messaging (NIP-04/NIP-17)
• search-gifs - GIF search via Nostr events (NIP-94)
• shakespeare-ai - AI chat completions and image generation

🚀 Deployment

Go live - Publish your app

• shakespeare-build - Build and verify projects for deployment
• shakespeare-deploy - Deploy to shakespeare.wtf with Nostr keys

Quick Start

Create a new Nostr app:

"Create a new Nostr app with mkstack"

Find and clone a template:

"Find a social media template and clone it"

Style your app:

"Style my app with Tailwind and shadcn/ui"

Deploy to production:

"Build and deploy my app to shakespeare.wtf"

Documentation Structure

All documentation is in the references/ directory:

Main References:

• references/{topic}.md - Complete skill documentation

Detailed Guides:

• references/nostr/*.md - NIPs overview, event kinds, common mistakes, patterns
• references/react/*.md - Hooks reference, performance, server components
• references/shakespeare-ai/*.md - Authentication, credits, models, streaming

Technology Stack

Nostr Core:

• nostr-tools, @nostrify/react
• nak CLI toolkit

Frontend:

• React 19.x, TypeScript
• shadcn/ui, Tailwind CSS 3.x

Deployment:

• shakespeare.wtf (NIP-98 auth)
• Permissionless hosting with Nostr keys

AI Integration:

• Shakespeare AI API
• Chat completions, image generation

Examples

Full workflow:

1. Find template    → shakespeare-templates
2. Clone & modify   → git clone
3. Style interface  → web-design
4. Add features     → direct-messaging, shakespeare-ai
5. Build project    → shakespeare-build
6. Deploy live      → shakespeare-deploy

From scratch:

1. Scaffold project → mkstack
2. Learn Nostr      → nostr, nostr-tools
3. Build UI         → react, web-design
4. Deploy           → shakespeare-build, shakespeare-deploy

Related Resources

• Shakespeare: https://shakespeare.diy
• Shakespeare Hosting: https://shakespeare.wtf
• MKStack Template: https://gitlab.com/soapbox-pub/mkstack

License

MIT License - see LICENSE file for details