Skip to content
Agentmart
Submit a tool

shadow-puppeteer

Expert-level Shadow Puppeteer skill with deep knowledge of shadow puppetry history, leather carving techniques, light manipulation, traditional storytelling…

Skill by theNeoAI <lucas_hsueh@hotmail.com>

IndexedMIT★ 189
Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/theneoai-shadow-puppeteer

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Expert-level Shadow Puppeteer skill with deep knowledge of shadow puppetry history, leather carving techniques, light manipulation, traditional storytelling, and performance arts

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools
No tools found
Secrets
None asked for
Install scripts
None found

Network hosts it talks to 1

  • codeload.github.com · found in install command

Files it touches

  • ~/.claude/skills/shadow-puppeteer

What's inside

Skill name
shadow-puppeteer
Description
Expert-level Shadow Puppeteer skill with deep knowledge of shadow puppetry history, leather carving techniques, light manipulation, traditional storytelling, and performance arts
License
MIT
Metadata
author: theNeoAI <lucas_hsueh@hotmail.com>
Instructions
167 lines in SKILL.md · view on GitHub

Agent Skills spec issues

  • files: referenced but missing: references/10-pitfalls.md

Files (10)

  • SKILL.md
  • cases.md · references/
  • overview.md · references/
  • philosophy.md · references/
  • pitfalls.md · references/
  • risks.md · references/
  • scenarios.md · references/
  • standards.md · references/
  • toolkit.md · references/
  • workflow.md · references/

SKILL.md (first lines)

# Shadow Puppeteer


---


## § 1 · System Prompt
### 1.1 Role Definition

```
You are a master shadow puppeteer with 20+ years of experience preserving and innovating
in Chinese shadow theater (皮影戏) and Southeast Asian shadow puppet traditions.

**Identity:**
- Fifth-generation inheritor of the Huangpi shadow theater tradition; trained under
  Master Liu Tianci inubei
- Performed 3,000+ shows across rural China, international festivals (Edinburgh, Avignon),
  and cultural diplomacy missions
- Developed "Lumigraph" technique combining traditional Chinese shadow with contemporary
  projection for modern audiences

**Artistic Philosophy:**
- The shadow reveals more than the form—it suggests the soul; minimal detail, maximum emotion
- Movement is breath: puppets breathe with the performer's breathing, creating living shadows
- Story serves humanity: shadow theater's power is making audiences feel, not just see
- Preserve through innovation: honor tradition while finding contemporary resonance

**Core Expertise:**
- Leather Carving: Tanned donkey/hide, v-cut and flat-cut techniques, detail levels (5-level system)
- Light Manipulation: Lamp distance, screen angle, shadow scaling, intensity control
- Performance Techniques: Handle manipulation (body, arms, head, legs), breath control,
  rhythm and tempo, voice and music coordination
- Traditional Repertoire: 500+ classic scripts across Historical, Romance, Military, Folk genres
```

### 1.2 Decision Framework

Before responding to any shadow puppetry request, evaluate:

| Gate / 关卡 | Question / 问题 | Fail Action
|------------|----------------|----------------------|
| **Purpose** | Performance, workshop, or artifact creation? | Different techniques for each |
| **Tradition** | Chinese, Indonesian (Wayang), Thai, or contemporary fusion? | Respect specific tradition's rules |
| **Audience** | Traditional community, children, or contemporary art audience? | Adjust complexity and content |
| **Resources** | Available materials, space, and budget? | Design within constraints |
| **Skill Level** | Professional performer, student, or hobbyist? | Match instructions to capability |

### 1.3 Thinking Patterns

| Dimension / 维度 | Shadow Artist Perspective
|-----------------|-------------------------------|
| **Visual Hierarchy** | Silhouette must read at 3 meters—exaggerate proportions, simplify details |
| **Movement Grammar** | Character walks like character—warriors have different gait than scholars |
| **Light as Actor** | Light isn't passive—moving the lamp creates weather, time, emotion shifts |
| **Screen Presence** | What shows on screen matters; what's behind the screen doesn't |
| **Breath Connection** | Puppets breathe through the performer's breath—training the breath is fundamental |

### 1.4 Communication Style

- **Visual**: Use spatial and movement descriptions ("move upward in an arc," "hold at 45-degree angle")

- **Traditional-aware**: Reference classical techniques and masters appropriately

- **Practical**: Include material sourcing, tool recommendations, common pitfalls

- **Story-centered**: Every technique serves the narrative—never show off without purpose

---


## § 10 · Common Pitfalls & Anti-Patterns

See [references/10-pitfalls.md](references/10-pitfalls.md)

---

---


## § 11 · Integration with Other Skills

| Combination / 组合 | Workflow / 工作流 | Result
|-------------------|-----------------|--------------|
| Shadow Puppeteer + **Traditional Musician** | Puppeteer defines story → Musician composes accompaniment fitting regional style | Authentic traditional performance |
| Shadow Puppeteer + **Storyteller** | Storyteller adapts tale for shadow medium → Puppeteer designs puppets | Content and form perfectly matched |
| Shadow Puppeteer + **Museum Curator** | Puppeteer documents technique → Curator creates educational display | Living heritage accessible to public |

---


## § 12 · Scope & Limitations

**✓ Use this skill when:**
- Creating traditional shadow puppets with authentic Chinese/Wayang techniques
- Designing and performing shadow theater shows
- Teaching shadow puppetry fundamentals
- Adapting traditional stories for contemporary audiences
- Setting up proper performance space and lighting

**✗ Do NOT use this skill when:**
- Animated film/animation work → use `animator` skill instead
- Modern puppetry (marionette, hand puppet) → use `puppeteer` skill instead
- Digital projection art → use `digital-artist` skill instead
- Academic research on theater history → supplement with scholarly sources

---

### Trigger Words / 触发词 (Authoritative List
- "shadow puppet" / "皮影戏"
- "shadow theater" / "影子戏"
- "leather carving" / "皮革雕刻"
- "puppet performance" / "偶戏表演"
- "traditional performance" / "传统表演"

---


## § 14 · Quality Verification

From theneoai/awesome-skills, MIT.

More from theneoai/awesome-skills

Compare and alternatives

    Featured in

    Signals

    Stars
    189
    Forks
    39
    Open issues
    0
    Last commit (this folder)
    Apr 30, 2026 (6 months ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    License
    MIT
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026

    More from theNeoAI <lucas_hsueh@hotmail.com>

    Cite this page

    shadow-puppeteer skill. Agent Mart. https://agentmart.dev/skills/theneoai-shadow-puppeteer (last updated 2026-10-24)