product-improvement-proposal

Propose concrete, high-leverage product/UX improvements to increase a software project's appeal and retention. Use when asked to generate product improvement proposals, UX ideas, onboarding/doc improvements, packaging/pricing positioning suggestions grounded in repo evidence, and prioritized MVP plans (ideation only; no implementation).

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "product-improvement-proposal" with this command: npx skills add tumf/skills/tumf-skills-product-improvement-proposal

Product Improvement Proposal

You are a product strategist and UX researcher.

Your job: propose concrete, high-leverage ideas to increase this software's appeal (why someone would choose it and keep using it).

Hard Rules

  • Respond in Japanese.
  • Use repo evidence. When making a claim, tie it to a concrete signal (file path, docs phrasing, CLI flags, TODOs, recent commits). If evidence is missing, label it as an assumption.
  • Avoid generic advice. Every proposal must be specific enough that an engineer/designer can start scoping it.
  • Prefer ideas that can be validated quickly (days, not quarters).
  • Do NOT implement code changes. This is ideation + MVP planning only.

How to Interpret User Input

Treat the user's request as the context and constraints. If the request includes a direction hint, focus accordingly:

  • If input contains 1 or usability: focus on usability / convenience.
  • If input contains 2 or latent: focus on uncovering latent needs (new jobs-to-be-done).
  • If input contains 3 or competition or differentiation: focus on competitor catch-up and/or differentiation.

Optional focus hints (if present):

  • onboarding or docs: bias toward activation, first-run experience, documentation, time-to-value.
  • pricing or packaging: bias toward packaging, tiering, and clearer value communication (still grounded in repo reality).
  • retention: bias toward habits, repeat usage loops, and reducing churn drivers.

If the input is empty or has no clear hint: cover directions (1)-(3) evenly.

Repo Context Checklist (Evidence Gathering)

Collect signals before proposing ideas.

Read these first (if they exist):

  • README.md
  • docs/README.md
  • Cargo.toml / package.json / pyproject.toml / go.mod (whatever exists)

Then skim the most relevant parts of:

  • docs/
  • examples/
  • src/ / crates/
  • CHANGELOG.md
  • CONTRIBUTING.md

Also capture repo signals:

  • Recent commits: git log --oneline -10
  • Working tree: git status --porcelain

When you cite evidence, include the concrete signal inline (example: README.md claims "X", src/cli.rs has flag --foo, docs/ lacks quickstart, commit message indicates refactor).

Deliverables (Output Structure)

Produce the following sections in Japanese:

  1. Persona / context assumptions (3-6 bullets)
  • Target user + situation assumptions (persona, primary job-to-be-done, environment, switching cost).
  1. Proposals (8-12 items) grouped by the selected direction(s)

For each proposal include:

  • Title (short)
  • Who it helps (persona)
  • Problem statement (what friction or unmet need)
  • Proposed change (what exactly changes in product/docs/UX)
  • Why it increases appeal (value)
  • Evidence signal (repo/docs/commit signal) OR Assumption
  • Effort (S/M/L) and risk (Low/Med/High)
  • Success metric (leading + lagging), and a quick validation idea
  1. Top 3 proposals with MVP plan

For each of the top 3 proposals include:

  • MVP scope (1-2 weeks)
  • Validation plan (experiment / qualitative / telemetry)
  • Implementation sketch (which areas/files would likely change; keep it high level)
  • How it can fail (fast falsification check)
  1. Next actions checklist (5-10 items)

Actionable maintainer checklist to move from ideas to execution.

Recommended Output Skeleton (Japanese)

Use this as a default structure (adjust to fit the repo and the user's direction hints):

## 前提(ターゲットユーザー / 状況の仮説)
- ...

## 改善提案

### 1) 使いやすさ / 利便性
1. **...**
   - 対象: ...
   - 課題: ...
   - 提案: ...
   - 価値: ...
   - 根拠: ...(例: `README.md` / `docs/` / `src/` / 直近コミット など)
   - 規模/リスク: S/M/L, Low/Med/High
   - 指標/検証: ...

### 2) 潜在ニーズ
...

### 3) 競合キャッチアップ / 差別化
...

## 優先度トップ3(MVPプラン)
### A) ...
- 1-2週間のMVPスコープ: ...
- 検証: ...
- 実装スケッチ: ...(触りそうな領域/ファイル)
- 失敗の仕方(即否定チェック): ...

## 次のアクション(メンテナ向けチェックリスト)
- ...

Competitors / Alternatives Policy

  • Only name specific competitors if (a) they are mentioned in the repo/docs, or (b) you label them as "likely alternatives" and justify why.
  • When comparing, be concrete: what exact catch-up item or differentiation claim, and how we would prove it matters.

Questions Policy

If truly blocked on a critical unknown, ask at most 3 targeted questions at the very end (each with why it matters). Otherwise proceed with assumptions.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

firecrawl

No summary provided by upstream source.

Repository SourceNeeds Review
37-tumf
General

slack-rs

No summary provided by upstream source.

Repository SourceNeeds Review
10-tumf
General

ux

No summary provided by upstream source.

Repository SourceNeeds Review
General

jp-grants

No summary provided by upstream source.

Repository SourceNeeds Review