Individual skill
tweakidea
Use when a founder wants to evaluate a startup idea or problem, improve or compare idea evaluations, or mine Hacker News for product opportunities. Runs a 14-dimension weighted scorecard with assumption tracking, generates small/medium/big idea tweaks, diffs runs, browses and analyzes HN threads, and lists, opens, or shares artifacts saved under ~/.tweakidea/.
skills/tweakidea/SKILL.md
Source commit 007ebb9050fc6d0b3370bc5bf60c7f1f566a4301
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- Yes
- Skill scan complete
- Yes
- Observed behavior
- Not checked yet
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 57
- Repository last updated
- Oct 26, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- idea Repository topic
- startup Repository topic
- claude-code Repository topic
- competitor-analysis Repository topic
- founder-tools Repository topic
- hacker-news Repository topic
- idea-validation Repository topic
- market-research Repository topic
- product-market-fit Repository topic
- startup-evaluation Repository topic
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 7,187 bytesassets/report/styles.cssasset · 28,336 bytesassets/report/template.html.j2asset · 24,143 bytesassets/report/template.md.j2asset · 4,333 bytesassets/schemas/assumptions.jsonasset · 973 bytesassets/schemas/dimension-evaluation.jsonasset · 3,173 bytesassets/schemas/hypotheses.jsonasset · 948 bytesassets/schemas/idea.jsonasset · 1,502 bytesassets/schemas/next-steps.jsonasset · 1,337 bytesassets/schemas/numbers.jsonasset · 4,985 bytesassets/schemas/potential.jsonasset · 2,109 bytesassets/schemas/research.jsonasset · 2,413 bytesassets/schemas/strengths-weaknesses.jsonasset · 918 bytesassets/schemas/version.jsonasset · 1,366 bytesreferences/agents/ti-evaluator.mddoc · 15,342 bytesreferences/agents/ti-extractor.mddoc · 4,651 bytesreferences/agents/ti-narrative.mddoc · 10,529 bytesreferences/agents/ti-researcher.mddoc · 6,830 bytesreferences/commands/analyze-hn-post.mddoc · 9,292 bytesreferences/commands/browse-hn.mddoc · 5,828 bytesreferences/commands/diff.mddoc · 6,498 bytesreferences/commands/evaluate.mddoc · 27,039 bytesreferences/commands/improve.mddoc · 9,377 bytesreferences/commands/list.mddoc · 2,493 bytesreferences/commands/share.mddoc · 2,394 bytesreferences/commands/show.mddoc · 2,820 bytesreferences/founder.mddoc · 6,541 bytesreferences/hn.mddoc · 1,861 bytesreferences/report.mddoc · 6,766 bytesreferences/runtime.mddoc · 6,051 bytesreferences/scoring/EVALUATION.mddoc · 3,374 bytesreferences/scoring/dimensions/behavior-change-required.mddoc · 2,970 bytesreferences/scoring/dimensions/clarity-of-target-customer.mddoc · 2,445 bytesreferences/scoring/dimensions/defensibility.mddoc · 2,904 bytesreferences/scoring/dimensions/founder-market-fit.mddoc · 3,059 bytesreferences/scoring/dimensions/frequency.mddoc · 2,477 bytesreferences/scoring/dimensions/incumbent-indifference.mddoc · 2,539 bytesreferences/scoring/dimensions/mandatory-nature.mddoc · 2,289 bytesreferences/scoring/dimensions/market-growth.mddoc · 2,189 bytesreferences/scoring/dimensions/market-size.mddoc · 2,553 bytesreferences/scoring/dimensions/pain-intensity.mddoc · 2,446 bytesreferences/scoring/dimensions/scalability.mddoc · 2,355 bytesreferences/scoring/dimensions/solution-gap.mddoc · 2,712 bytesreferences/scoring/dimensions/urgency.mddoc · 2,191 bytesreferences/scoring/dimensions/willingness-to-pay.mddoc · 2,450 bytesscripts/compute.pyruns · 8,957 bytesscripts/hnparse.pyruns · 8,198 bytesscripts/hnsearch.pyruns · 5,179 bytesscripts/lib/__init__.pyruns · 0 bytesscripts/lib/errors.pyruns · 1,818 bytesscripts/lib/registry.pyruns · 2,246 bytesscripts/lib/schema.pyruns · 1,508 bytesscripts/render_report.pyruns · 6,026 bytes
Read excerpt
TweakIdea helps founders make better decisions: evaluate whether a problem is worth solving, or discover which problems are emerging from technology shifts. Be an honest second opinion, not a cheerleader.
## Setup
1. **SKILL_DIR** is the directory that contains this SKILL.md (the runtime reports it as the skill's base directory). If no base directory is reported, use the first of `$(pwd)/.claude/skills/tweakidea`, `$HOME/.claude/skills/tweakidea`, `$(pwd)/.agents/skills/tweakidea`, or `$HOME/.agents/skills/tweakidea` that contains `SKILL.md`. Every `{SKILL_DIR}` path in this skill and its references resolves against it.
2. **Runtime:** read [references/runtime.md](references/runtime.md) and map each capability it lists (`ask-user`, `spawn-subagent`, `web-search`, `read-file`, and the rest) and each model tier to what your runtime provides. The references name capabilities, not tools.
3. **HOME_DIR** is the output of `echo "$HOME"`. All user data lives under `{HOME_DIR}/.tweakidea/`.
4. Python helpers in `{SKILL_DIR}/scripts/` run through `uv run`. If a command needs them and `uv` is missing, tell the user to install it (`brew install uv` or `curl -LsSf https://astral.sh/uv/install.sh | sh`) and stop.
## Routing
The invocation arguments are:
$ARGUMENTS