Stats
Actions
Available In
Tags
🐷🍄 PiggyTales
A Plugin for Claude Code
Where Piggy & Shroom tell amazing tales!
AI-powered content creation plugin for Claude Code with 22 specialized agents for audiobooks, animations, and child-safe content.
At a Glance
| Agents | Skills | Rules | Phases | Commands |
|---|---|---|---|---|
| 22 | 8 | 7 | 4 | 70+ |
What's Inside:
- 🤖 22 Specialized Agents — Discovery, Script, Asset, Production, Council, Management
- 🎙️ Voice Production — Vietnamese TTS via Vbee API with emotion tags
- 🛡️ Content Safety — Child-safe guidelines for ages 4-17
- 🔄 Flexible Workflows — Full, Standard, Lite, Express, Custom modes
- 🎮 70+ Commands — Complete workflow control with
/talecommands - 🐷🍄 Council Review — Piggy (Critic) & Shroom (Optimist) quality system
Quick Start
Prerequisites
- Claude Code — Install Anthropic's CLI first
- Git — Version control
Installation
In Claude Code terminal:
# Step 1: Add PiggyTales Marketplace (one-time)
/plugin marketplace add nguyenthienthanh/piggytales
# Step 2: Install PiggyTales Plugin
/plugin install piggytales@piggytales
First Project
# Create a new audiobook project
/tale new audiobook "My First Story"
# Set target audience
/tale audience children
# Apply preset
/tale preset audiobook-simple
# Start workflow
/tale next
Key Features
Content Types
| Type | Description |
|---|---|
| Audiobook | Vietnamese voice narration with emotional delivery |
| Animation | Scene-based visual storytelling |
| Short Video | TikTok/YouTube Shorts content |
| Music Video | Audio-visual music content |
Target Audiences
| Audience | Age Range | Guidelines |
|---|---|---|
children | 4-12 | Simple language, no scary content |
teens | 13-17 | Age-appropriate themes |
family | All ages | Suitable for everyone |
Workflow Modes
| Mode | Phases | Speed |
|---|---|---|
| Full | All 4 phases | Thorough |
| Standard | All phases | Balanced |
| Lite | Script + Production | Fast |
| Express | Script + Voice only | Fastest |
Documentation
| Document | Description |
|---|---|
| GET_STARTED.md | Quick setup guide |
| CLAUDE.md | Full command reference |
| VOICEOVER_SETUP.md | Voice configuration |
| TESTING_GUIDE.md | How to test |
Commands
Quick Reference
# Project
/tale new audiobook "Title"
/tale status
/tale list
# Workflow
/tale next
/tale approve
/tale council
# Production
/tale voice generate
/tale export all
# Shortcuts
/t s # status
/t n # next
/t a # approve
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT License - see LICENSE file.
Made with 🐷❤️🍄 by the PiggyTales Team
Where Piggy & Shroom tell amazing tales!
