tech-to-pm-translator

Solid

Convert technical developer documentation into PM/designer-friendly context documents. Reads engineering docs (architecture refs, API docs, runbooks, ADRs, READMEs) and produces structured, code-free knowledge base files that non-engineers can use to understand systems, file better bugs, write better specs, and have informed conversations with engineers. Triggers on: "translate docs for PMs", "make this PM-friendly", "convert tech docs", "create PM context", "non-engineer version", "explain this for PMs", "designer-friendly docs", "/tech-to-pm".

AI & Automation 21 stars 4 forks Updated 6 days ago MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
45
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Tech-to-PM Translator Converts technical developer documentation into structured, code-free knowledge base documents that PMs, designers, and other non-engineers can use to understand systems without reading code. ## Philosophy This is a **translation** skill, not a **summarization** skill. - **Summarization** loses detail. A PM reading a summary still can't answer questions. - **Translation** reframes the same information for a different audience. A PM reading a translated doc can understand what breaks, why, and who to talk to. The output preserves technical accuracy while stripping implementation detail and adding decision-support framing. ## When to Activate - User says "translate docs for PMs", "make this PM-friendly", "convert tech docs" - User says "create PM context from these docs", "non-engineer version" - User says "explain this system for PMs/designers", "create onboarding docs" - User has technical markdown files and wants them accessible to non-coders - After a team writes architecture docs and wants broader org understanding ## Input Required: - **Source path**: Directory or glob pattern containing technical docs (e.g., `.claude/ref/`, `docs/architecture/`, `**/*.md`) Optional: - **Output path**: Where to write the translated docs (default: alongside source or user-specified) - **Audience**: "pm" (default), "designer", "stakeholder", "new-hire" (adjusts framing depth) - **Project name**: For context-specific terminology and ownership mapping - **Exi...

Details

Author
mshadmanrahman
Repository
mshadmanrahman/pm-pilot
Created
6 months ago
Last Updated
6 days ago
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category