
pm-gap-analysis
Run a Pragmatic Institute Gap Analysis — a market-driven self-assessment of how well the team performs the 37 activities of the Pragmatic Framework, who owns each, and where the biggest gaps are. Use when the PM asks "where do we stand", "how are we doing on the framework", a product-org self-assessment, a maturity check, or where to focus. Produces a Gap Analysis table plus a top-3-gaps action plan as a Markdown or Word .docx artifact.
- Installs
- 40
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/julianoczkowski/product-manager --skill pm-gap-analysis- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads pm-gap-analysis automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Gap Analysis (Pragmatic Framework: whole-framework self-assessment)
Best done with a small cross-functional group (product management, product
marketing, sales, development, executives). It scores every activity in the framework
so the team can agree where to invest. See the full 37-box list in
../pm-copilot/references/framework.md.
The scale
- Importance — how important is this activity to the company? 0 (low) – 5 (high).
- Assessment — how well are you performing it today? 0 (not doing) – 5 (high).
- Gap = Importance − Assessment. The largest positive gaps are where you're under-performing on things that matter most.
- Also estimate Target Hrs/Wk vs Actual Hrs/Wk per activity; divide total hours by 40 to sanity-check how many people are needed.
Owner role abbreviations: PM (Product Manager), PMM (Product Marketing Manager), MC (Marketing Communications), SE (Sales Engineer), Dev (Development), Exec (Executive), PgM (Program Manager), PjM (Project Manager), PO (Product Owner), TPM (Technical PM), Other.
Method
- For each of the 7 columns' activities, agree the Current Owner and discuss the Proposed Owner.
- Score Importance (0–5) and Assessment (0–5); compute the Gap.
- Triage: pick the top 2–3 gaps to focus on over the next few quarters. If more than three tie, the group chooses the three most important.
- Fix the strategic (left) side first. If Market Problems has a large gap, fix it first — it improves everything downstream.
- Build an action plan for the top gaps (barriers, how to close, owner).
- Redo the Gap Analysis in 6–9 months to measure improvement and find the next gaps.
Interview the user for inputs (batch questions)
- What's the scope — a product, portfolio, or business unit? (Startups: whole org.)
- Who's in the assessment group (which functions)?
- Walk column by column: for each activity, Importance (0–5) and Assessment (0–5), current owner, and rough hours. (Offer to go column-by-column so it's not overwhelming.)
Artifact templates
Gap Analysis
# Pragmatic Framework Gap Analysis — <scope>
**Company:** <company> · **Scope / Product:** <product, portfolio, or BU>
**Author:** <author> · **Assessed by:** <names/functions> · **Date created:** <date>
**Scale:** Importance 0–5 · Assessment 0–5 (0 = not doing) · Gap = Importance − Assessment
## MARKET
| Activity | Current Owner | Proposed Owner | Importance | Assessment | Gap | Target Hrs/Wk | Actual Hrs/Wk |
| :--- | :--- | :--- | ---: | ---: | ---: | ---: | ---: |
| Market Problems | | | | | | | |
| Win/Loss Analysis | | | | | | | |
| Distinctive Competencies | | | | | | | |
| Competitive Landscape | | | | | | | |
| Asset Assessment | | | | | | | |
<!-- Repeat a table for FOCUS, BUSINESS, PLANNING, PROGRAMS, ENABLEMENT, SUPPORT
using the activity lists in references/framework.md -->
**Total hours/week:** <sum> → **People needed (÷40):** <n>
Top-3 Gaps Action Plan
# Action Plan — Top Gaps
| Rank | Activity | Gap | Barrier | How we'll close it | Owner | By when |
| ---: | :--- | ---: | :--- | :--- | :--- | :--- |
| 1 | | | | | | |
| 2 | | | | | | |
| 3 | | | | | | |
**Re-assess on:** <date + 6–9 months>
Deliver the artifact
Follow ../pm-copilot/references/artifact-output.md: confirm inputs, ask Markdown
or .docx, write the .md, convert via your environment's native document-creation capability on request. Then route to
the worst-scoring box using ../pm-copilot/references/journey.md (e.g. a Market
Problems gap → run pm-market-problems). Not every one of the 37 boxes has a
dedicated skill (e.g. Pricing, Asset Assessment, Market Definition, Distribution
Strategy, Buyer Experience) — if the top gap lands on one of those, say so plainly
and advise directly from that box's definition in
../pm-copilot/references/framework.md instead of forcing the nearest skill.
FAQ
What does the pm-gap-analysis skill do?
Run a Pragmatic Institute Gap Analysis — a market-driven self-assessment of how well the team performs the 37 activities of the Pragmatic Framework, who owns each, and where the biggest gaps are. Use when the PM asks "where do we stand", "how are we doing on the framework", a product-org self-assessment, a maturity check, or where to focus. Produces a Gap Analysis table plus a top-3-gaps action plan as a Markdown or Word .docx artifact.
How do I install pm-gap-analysis?
Run npx skills add https://github.com/julianoczkowski/product-manager --skill pm-gap-analysis in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/pm-gap-analysis/ (personal) or .claude/skills/pm-gap-analysis/ (project).
Which AI agents can use pm-gap-analysis?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is pm-gap-analysis safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains pm-gap-analysis?
It is published by julianoczkowski in julianoczkowski/product-manager. It has 40 recorded installs.
More from julianoczkowski/product-manager
pm-opportunity-scoring
julianoczkowski/product-manager
Score and rank product opportunities objectively with the Pragmatic Institute Opportunity Scoring model — across distinctive competency fit, competitive landscape, investment level, and impact to buyers/users. Use when the PM asks which idea to pursue, "score these opportunities", prioritize projects/bets, or compare options objectively instead of by opinion. Produces an Opportunity Scorecard as a Markdown or Word .docx artifact.
pm-market-problems
julianoczkowski/product-manager
Run Pragmatic Institute market discovery and validate real market problems before anything gets built. Use when a PM says "I want to build a feature", "do market research", "talk to customers", "discovery", "validate this idea", "is this problem real", "NIHITO", or "who should I interview". Enforces the outside-in rule: build only for problems that are urgent, pervasive, and that the market will pay to solve. Produces a Market Discovery Document and a Market Problems Table as a Markdown or Word .docx artifact.
pm-copilot
julianoczkowski/product-manager
Open the skill to read its SKILL.md instructions.
pm-distinctive-competence
julianoczkowski/product-manager
Articulate your organization's Distinctive Competencies the Pragmatic Institute way — the unique abilities to deliver value that are valued, different, and provable. Use when a PM says "what makes us different", "our moat", "unique strengths", "why us", "competitive advantage", or "distinctive competence". Strategy = intersect market problems with what only you can do. Produces a Distinctive Competencies worksheet as a Markdown or Word .docx artifact.
pm-win-loss-analysis
julianoczkowski/product-manager
Open the skill to read its SKILL.md instructions.
pm-positioning
julianoczkowski/product-manager
Open the skill to read its SKILL.md instructions.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.