product-improvement-proposal
Skill4 starsChanged 7 months agoMITView on GitHub
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).
We split this skill into the rules it gives an agent
15 rules. About 0 are common, 11 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈11
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
Use repo evidence. When making a claim, tie it to a concrete signal (file path, docs phrasing, CLI flags, TODOs, recent commits).
- Distinctive: line 18
Avoid generic advice. Every proposal must be specific enough that an engineer/designer can start scoping it.
- Distinctive: line 19
Prefer ideas that can be validated quickly (days, not quarters).
- Distinctive: line 20
Do NOT implement code changes.
- Distinctive: line 24
Treat the user's request as the context and constraints.
- Very specific: line 26
If input contains 1 or usability: focus on usability / convenience.
- Very specific: line 27
If input contains 2 or latent: focus on uncovering latent needs (new jobs-to-be-done).
- Very specific: line 28
If input contains 3 or competition or differentiation: focus on competitor catch-up and/or differentiation.
- Distinctive: line 36
If the input is empty or has no clear hint: cover directions (1)-(3) evenly.
- Distinctive: line 42
Read these first (if they exist):
- Very specific: line 61
When you cite evidence, include the concrete signal inline (example: README.md claims "X", src/cli.rs has flag --foo, docs/ lacks …
- Distinctive: line 99
Use this as a default structure (adjust to fit the repo and the user's direction hints):
- Distinctive: line 136
Only name specific competitors if (a) they are mentioned in the repo/docs, or (b) you label them as "likely alternatives" and justify why.
- Distinctive: line 137
When comparing, be concrete: what exact catch-up item or differentiation claim, and how we would prove it matters.
- Distinctive: line 141
If truly blocked on a critical unknown, ask at most 3 targeted questions at the very end (each with why it matters).
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
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
1orusability: focus on usability / convenience. - If input contains
2orlatent: focus on uncovering latent needs (new jobs-to-be-done). - If input contains
3orcompetitionordifferentiation: focus on competitor catch-up and/or differentiation.
Optional focus hints (if present):
onboardingordocs: bias toward activation, first-run experience, documentation, time-to-value.pricingorpackaging: 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.mddocs/README.mdCargo.toml/package.json/pyproject.toml/go.mod(whatever exists)
Then skim the most relevant parts of:
docs/examples/src//crates/CHANGELOG.mdCONTRIBUTING.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:
- Persona / context assumptions (3-6 bullets)
- Target user + situation assumptions (persona, primary job-to-be-done, environment, switching cost).
- 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
- 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)
- 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.
In this repository25 other files it gives its agents.
- AGENTS.mdAGENTS.md
- greats-soul-archive-contributor/AGENTS.mdAGENTS.md
- agentic-cli-designSkill
- ai-chat-frontendSkill
- autoresearch-agentSkill
- brainstorm-frameworksSkill
- business-planningSkill
- clawdbot-configSkill
- dashboard-design-guidebookSkill
- fermi-estimationSkill
- firecrawlSkill
- gogcliSkill
- greats-soul-archive-contributorSkill
- jp-grantsSkill
- openclaw-agent-creatorSkill
- opencode-agent-creatorSkill
- opencode-command-creatorSkill
- openspec-brownfield-baselineSkill
- oss-publishSkill
- python-uv-projectSkill
- rust-cliSkill
- slack-rsSkill
- unit-test-hygieneSkill
- wt-setupSkill
- youtube-summarizerSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

