product-teardown-skill

by yanliudesignVerified

Principal-PM-level product-teardown skill — reverse-engineer any product as a system and render a bilingual (EN + ZH) HTML report with a product-screenshot gallery.

67
Stars
4
Forks
Python
Language
8/24/2026
Added
View on GitHubDownload ZIP

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillTip is an informational directory and does not control or maintain the underlying repository. Any security checks displayed are automated and limited in scope. Review the source code before installing.

Read the Terms of Service

Installation

Add to your Claude Code skills directory:

# Add to your Claude Code skills
git clone https://github.com/yanliudesign/product-teardown-skill

Getting Started

Guides for using skills like product-teardown-skill.

Security Report

Verified

Last scanned: —

{
  "status": "PASSED",
  "issues": []
}

README.md

Chinese · English

🔬 Product Teardown Skill


Reverse-engineer any product as a system — and get a bilingual, print-ready HTML report. In one shot.

License Version Stars

Claude Code Codex OpenCode OpenClaw Hermes

A Principal-PM-level product-teardown skill. Point it at any product (Linear, Notion, Cursor, Perplexity…) and it reverse-engineers the thing as a system — loops, strategy, moat, opportunities — then renders the analysis as a bilingual (EN + ZH), print-ready HTML report with an embedded product-screenshot gallery. Not a "5 things I like about this app" review. A structural read of why the product wins, where it leaks, and what the next move should be.


How it works — just 2 steps

Invoke the skill with anything like "teardown Linear" / "break down Notion" / "analyze Cursor" and it runs the same flow every time:

  1. Chat response — full teardown in 11 sections (Snapshot → Users & JTBD → Core Loop → Architecture → UX Quality → Business Model → Growth → AI Readiness → Friction → Opportunities → Final PM Verdict).
  2. HTML report auto-generates — two cross-linked files (EN + ZH, toggle in the bottom-right), saved to ~/Desktop/Claude skills/product-teardown-<slug>-{en,zh}-<yyyymm>.html. Print-optimized (Cmd+P → clean PDF).

Teardown Report · the 11-section spine

Every run ends with two single-file HTML reports at ~/Desktop/Claude skills/. Fixed 11-section spine, plus a product-tour gallery:

#SectionWhat it answers
Product Tour6 screenshots pulled from the product's own og:image marketing assets.
1SnapshotOne-line pitch · category · stage · pricing · notable numbers.
2Users & JTBDWho hires this product, and for what job — including the replaced alternative.
3Core LoopThe atomic user loop that makes the product habit-forming (or doesn't).
4ArchitectureObject model · surfaces · integrations · what's a primitive vs a feature.
5UX QualitySignature interactions, latency, information density, empty states.
6Business ModelMonetization vector · unit economics · expansion path (PLG / sales / hybrid).
7GrowthAcquisition loops · virality vector · retention hooks · notable moats.
8AI ReadinessAssistive / Embedded / Autonomous — placed on the spectrum with evidence.
9FrictionWhere the product leaks — onboarding, mid-funnel, power-user ceiling.
10Opportunities3–5 concrete next-move bets (features, wedges, adjacencies).
11Final PM VerdictThe one sentence a Principal PM would write on the internal doc.

Reports are print-optimized (Cmd+P → clean PDF) and cross-linked EN ↔ ZH via a bottom-right language switcher.


Example output · Linear teardown

product-teardown-linear-en-202607.html + -zh- counterpart · cross-linked EN / ZH switcher · 6-image product tour · 11-section deep dive.

Cover — Linear · category, users, model, stage + 11-section table of contents

TL;DR + key metricsUsers & JTBDCore Product Loop
If you only read three things + Time-to-value, Core loop frequency, Moat scoreTarget users, trigger & context, functional/emotional/social JTBDTrigger → Action → Reward → Return loop + acquisition, retention, virality
Competitor LandscapeAI / Future ReadinessMetrics · North Star + Guardrails
Linear vs Jira / Notion / Asana / Height across philosophy, speed, non-eng fit, AI depthAssistive / Embedded / Autonomous spectrum + current usage + strategic AI riskWeekly Active Teams (north star) + input metrics + guardrails + blindspots

Five design principles

  1. Structure over opinion. Every section answers a specific question. No "here's what I think about this app."
  2. Loops, not features. The Core Loop section is the spine of the teardown — features are downstream of the loop.
  3. AI placement is a spectrum, not a badge. Assistive / Embedded / Autonomous — pick one and defend it with evidence.
  4. Screenshots must come from the product itself. Pull from og:image marketing assets (curl -s <url> | grep og:image), not random blog posts.
  5. Bilingual by default. Every teardown ships EN + ZH in the same run, cross-linked. Not translated later.

Repo contents

product-teardown-skill/
├── product-teardown-prompt.md              # Portable skill prompt (paste into any tool)
├── templates/
│   ├── product-teardown-template-en.html   # English report template
│   └── product-teardown-template-zh.html   # Chinese report template (same placeholders)
└── scripts/
    ├── fill_linear.py                      # Reference implementation — renders both templates
    └── translate_template_zh.py            # One-shot: derives the ZH template from EN
  • Aesthetic: cream paper + serif display + yellow accent. Print-optimized.
  • Placeholders: {{ALL_CAPS_KEYS}}. Fill via str.replace with keys sorted longest-first so prefixes don't collide.
  • AI meter: put active on exactly one of {{ACTIVE_IF_ASSISTIVE}} / {{ACTIVE_IF_EMBEDDED}} / {{ACTIVE_IF_AUTONOMOUS}}; empty on the other two.
  • Language switcher: {{LANG_EN_HREF}} / {{LANG_ZH_HREF}} = target filenames; {{ACTIVE_IF_EN}} / {{ACTIVE_IF_ZH}} = active on the file's own language.
  • Brand footer: contains TEARDOWN. mark + LinkedIn / X / Xiaohongshu links. Do not remove.

Use as a VS Code slash command

Copy product-teardown-prompt.md into your VS Code prompts folder as product-teardown.prompt.md and invoke via /product-teardown <product name>.

macOS: ~/Library/Application Support/Code/User/prompts/


How it thinks

  • A product is a system, not a screen. The screen is what you see; the loop is what makes it work. The teardown always finds the loop first, then works outward to surfaces, business model, and moat.
  • JTBD beats persona. "Who uses it" is less useful than "what did they hire it to replace." The interesting answer is almost never the obvious one.
  • AI readiness is a placement problem, not a checkbox. Every AI feature sits somewhere on Assistive → Embedded → Autonomous. Naming the point is the analysis.
  • Opportunities must be actionable. No "they should add AI." Every opportunity in §10 is a concrete wedge you could ship next quarter.

License

MIT — fork it, remix it, ship your own version.

Created by Dreameryanyan · LinkedIn · X · Xiaohongshu

Frequently Asked Questions

What is product-teardown-skill?

product-teardown-skill is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by yanliudesign. Principal-PM-level product-teardown skill — reverse-engineer any product as a system and render a bilingual (EN + ZH) HTML report with a product-screenshot gallery. It has 67 GitHub stars.

Is product-teardown-skill safe to use?

Yes. product-teardown-skill passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install product-teardown-skill?

Clone the repository with "git clone https://github.com/yanliudesign/product-teardown-skill" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is product-teardown-skill written in?

product-teardown-skill is primarily written in Python. It is open-source under yanliudesign on GitHub, so you can review or fork the full source.

Are there alternatives to product-teardown-skill?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh product-teardown-skill against similar tools.

Comments (0)

No comments yet. Be the first to share your thoughts!

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI Agentsai-agentsanthropicclaude-code
View details
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI Agentsai-agentsbrainstorming
View details

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI Agentsai-agentsanthropicclaude-code
View details

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI Agentsclaude-codeai-tools
View details

claude-code

by anthropics

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

120,03119,897Shell
AI Agents
View details

Developers Also Liked

Based on votes and bookmarks from developers who liked this skill

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI Agentsai-agentsanthropicclaude-code
View details
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI Agentsai-agentsbrainstorming
View details

n8n

by n8n-io

12

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

201,88160,308TypeScript
MCP Serversapisai-tools
View details

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI Agentsai-agentsanthropicclaude-code
View details

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI Agentsclaude-codeai-tools
View details