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>
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.
About
Reviews
Write a reviewNo 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 VerificationFrom theneoai/awesome-skills, MIT.
More from theneoai/awesome-skills
- 0.681score
wechat-article-reviewer
feishu-claw
微信公众号文章审核助手。当 theneoai 写完文章后 @铁蛋队长 发送文章内容时触发审核。 检查文章是否符合微信公众号发布标准:字数、内容深度、事实性、标题质量、原创度、敏感词、风格一致性、排版规范。 发现问题时提供具体整改意见,退回 theneoai 重写(最多3次),3次不通过则通知 lucas 人工介入。
SkillCFreshness: C★ 189Claude Code +9 - 0.612score
jobs-to-be-done
wdavidturner
Apply Jobs-to-be-Done framework for customer discovery and product strategy.
SkillDFreshness: D★ 189Claude Code +9 - 0.612score
idea-validator
aakashg
Stress-test product ideas across 5 dimensions before investing time to build.
SkillDFreshness: D★ 189Claude Code +9 - 0.612score
opportunity-solution-trees
wdavidturner
Apply Opportunity Solution Trees (OST) by Teresa Torres to connect outcomes to customer needs.
SkillDFreshness: D★ 189Claude Code +9 - 0.591score
chef
theNeoAI <lucas_hsueh@hotmail.com>
Expert culinary professional with advanced skills in food preparation, kitchen operations management, menu engineering, and culinary team leadership.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
quantity-surveyor
theNeoAI <lucas_hsueh@hotmail.com>
Chartered Quantity Surveyor (MRICS) with 15+ years in construction cost management, contract administration, and value engineering.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
steel-worker
theNeoAI <lucas_hsueh@hotmail.com>
Expert steel worker specializing in rebar installation, structural steel fabrication, and concrete reinforcement.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
electrical-engineer
theNeoAI <lucas_hsueh@hotmail.com>
Licensed Professional Electrical Engineer (PE) specializing in power systems, lighting design, fire alarm systems, and renewable energy.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
bricklayer
theNeoAI <lucas_hsueh@hotmail.com>
Expert bricklayer specializing in masonry construction, brick laying, stone work, and mortar selection.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
brand-strategist
theNeoAI <lucas_hsueh@hotmail.com>
Senior brand strategist with 15+ years experience advising Fortune 500 companies and high-growth startups.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
ai-product-manager
theNeoAI <lucas_hsueh@hotmail.com>
Elite AI Product Manager skill with expertise in AI product strategy, LLM product development, ML feature prioritization, AI ethics and fairness.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
plumber
theNeoAI <lucas_hsueh@hotmail.com>
Expert plumber specializing in pipe installation, drainage systems, water supply, and plumbing code compliance.
SkillCFreshness: C★ 189Claude Code +9
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
- Repository
- github.com/theneoai/awesome-skills
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
More from theNeoAI <lucas_hsueh@hotmail.com>
- 0.591score
ai-product-manager
theNeoAI <lucas_hsueh@hotmail.com>
Elite AI Product Manager skill with expertise in AI product strategy, LLM product development, ML feature prioritization, AI ethics and fairness.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
brand-strategist
theNeoAI <lucas_hsueh@hotmail.com>
Senior brand strategist with 15+ years experience advising Fortune 500 companies and high-growth startups.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
electrical-engineer
theNeoAI <lucas_hsueh@hotmail.com>
Licensed Professional Electrical Engineer (PE) specializing in power systems, lighting design, fire alarm systems, and renewable energy.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
chef
theNeoAI <lucas_hsueh@hotmail.com>
Expert culinary professional with advanced skills in food preparation, kitchen operations management, menu engineering, and culinary team leadership.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
quantity-surveyor
theNeoAI <lucas_hsueh@hotmail.com>
Chartered Quantity Surveyor (MRICS) with 15+ years in construction cost management, contract administration, and value engineering.
SkillCFreshness: C★ 189Claude Code +9 - 0.591score
bricklayer
theNeoAI <lucas_hsueh@hotmail.com>
Expert bricklayer specializing in masonry construction, brick laying, stone work, and mortar selection.
SkillCFreshness: C★ 189Claude Code +9
Cite this page
shadow-puppeteer skill. Agent Mart. https://agentmart.dev/skills/theneoai-shadow-puppeteer (last updated 2026-10-24)