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 17 stars 4 forks Updated today MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
42
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
5 months ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Featured

oma-translator

Context-aware translation that preserves tone, style, and natural word order. Use when translating UI strings, documentation, marketing copy, or any multilingual content. Infers register, domain, and style from the source text and surrounding codebase context.

1,240 Updated yesterday
first-fluke
AI & Automation Solid

translate

Translate English or Japanese tech articles and texts into natural, fluent Chinese. Use this skill when the user wants to translate text to Chinese, asks for Chinese translation, mentions "translate to Chinese", "翻译", provides English/Japanese tech content for translation, or wants any text converted into Chinese. Also trigger when the user pastes text and asks to translate it, or references a file to translate into Chinese.

59 Updated 2 days ago
hesorchen
Data & Documents Listed

translate

Translate any project or set of files into one or more target languages using the three-tier translator panel (Lead → Senior/Junior with adversarial QA). Works on codebases (i18n message catalogs, WordPress .po/.pot/.json, MDX/HTML content trees) and standalone documents (Markdown, JSON, docx, txt, subtitles, CSV). Detects the source language and file formats, computes the translation scope (whole project, changed-since-last-run, or an explicit file/glob set), classifies each batch as low-risk (Junior) or domain-prose (Senior), and applies the domain SPECIALIZATION setting (default `general`; e.g. technical, marketing, legal). Runs one final verify/build at the end and writes a report. Use when the user says "translate this", "translate into <language>", "localize the project", "run the translation pass", "translate the WordPress strings", "translate these files", or "i18n sweep".

2 Updated 6 days ago
roshaw