Agent skill

Decision Memo

by MaxKmet in MaxKmet/idea-validation-agents

Writes a concise, human-readable decision brief summarizing the full validation analysis — including score, verdict, RAT experiment, pre-mortem, and tier-appropriate next actions.

MITAuto-check passed

Install Decision Memo

skills CLI
$ npx skills add MaxKmet/idea-validation-agents --skill decision-memo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MaxKmet/idea-validation-agents decision-memo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MaxKmet/idea-validation-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/decision-memo .claude/skills/decision-memo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
decision-memo
GitHub stars
477
Token cost
~2k tokens
SKILL.md length
839 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Writes a concise, human-readable decision brief summarizing the full validation analysis — including score, verdict, RAT experiment, pre-mortem, and tier-appropriate next actions.

  • Works in 5 steps: No hedging. "This might work if…" is… → Evidence over opinion. Every strength… → Asymmetric emphasis on risks. Humans… → …
  • SKILL.md covers Purpose, Input, Writing Principles and Formatting Constraints, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Decision Memo is an agent skill from MaxKmet/idea-validation-agents. Writes a concise, human-readable decision brief summarizing the full validation analysis — including score, verdict, RAT experiment, pre-mortem, and tier-appropriate next actions. The document a founder actually acts on.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with TikTok. The repository describes itself as: AI agents that act as your personal venture analyst - from startup idea brainstorming to full validation and go-to-market strategy. Built for developers who'd rather validate in… The licence is MIT.

Example prompts

  • “Use the decision-memo skill to write a concise, human-readable decision brief summarizing the full validation analysis — including score, verdict…”
  • “/decision-memo”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. No hedging. "This might work if…" is banned. State the verdict and own it.
  2. Evidence over opinion. Every strength and risk must cite a specific data point from a dimension file (k-factor, LTV:CAC ratio, D30…
  3. Asymmetric emphasis on risks. Humans overweight strengths and underweight risks. The memo corrects for this by giving risks more detail…
  4. One clear next action. Not three options — one. The alternative path exists only as a contingency.
  5. Respect the founder's tier. Don't tell a beginner to "optimize your Meta ads funnel." Don't tell a growth-tier founder to "watch some…

What it can do on your machine

Read from SKILL.md and the folder at commit 3a4c800. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Decision Memo loads about 2k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 839 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MaxKmet/idea-validation-agents at commit 3a4c800, republished under its MIT licence (© MaxKmet). 839 words, ~2,023 tokens.

Download SKILL.mdSave it as .claude/skills/decision-memo/SKILL.md (or your agent's skills folder).
name
decision-memo
description
Writes a concise, human-readable decision brief summarizing the full validation analysis — including score, verdict, RAT experiment, pre-mortem, and tier-appropriate next actions. The document a founder actually acts on.
<!-- version: 0.2.0 | outputs: memory/ideas/<slug>/decision_memo.md -->

Skill: decision-memo

Purpose

After all analysis is complete, produce a document the user can actually act on. This is not a report — it is a decision brief. It surfaces the most important signals, names the riskiest assumption, and gives a concrete next action calibrated to the founder's tier. A good decision memo makes the reader feel slightly uncomfortable — that means it's honest.

Input

  • Idea slug
  • memory/ideas/<slug>/scores.json (required — includes RAT)
  • memory/ideas/<slug>/weaknesses.json (if available)
  • memory/ideas/<slug>/pivot_options.json (if available and verdict is "pivot")
  • All other available dimension files in memory/ideas/<slug>/
  • memory/user_profile.md (for tier-appropriate recommendations)

Writing Principles

The memo must be scannable in under 2 minutes. Follow these rules:

  1. No hedging. "This might work if…" is banned. State the verdict and own it.
  2. Evidence over opinion. Every strength and risk must cite a specific data point from a dimension file (k-factor, LTV:CAC ratio, D30 retention, WTP range, etc.).
  3. Asymmetric emphasis on risks. Humans overweight strengths and underweight risks. The memo corrects for this by giving risks more detail than strengths.
  4. One clear next action. Not three options — one. The alternative path exists only as a contingency.
  5. Respect the founder's tier. Don't tell a beginner to "optimize your Meta ads funnel." Don't tell a growth-tier founder to "watch some TikTok tutorials."

Formatting Constraints

SectionMax lengthPurpose
Verdict line1 sentenceInstant signal
Score + confidence1 lineQuantitative anchor
Validation watermark1–2 linesTrust calibration (only if confidence < high)
Top 3 Strengths1 sentence each, with one data pointWhat's working
Top 3 Risks2 sentences each: the risk + what happens if ignoredWhat kills it
Riskiest Assumption3–5 sentencesThe one thing to test before building anything
Pre-mortem3 bullet pointsFailure imagination exercise
Recommended Next Step2–4 sentences with specificsWhat to do this week
Kill criteria1–2 sentencesWhen to walk away
Alternative Path1–2 sentencesPlan B

Total memo length: ~400–600 words. If it's longer, cut. Brevity is a feature.

Process

  1. Load scores.json and all available dimension files.
  2. Check score_confidence. If "low", compose a validation watermark (see below).
  3. Identify the 3 highest-scoring dimensions → strengths. For each, pull one concrete data point from the source file (e.g., "k-factor estimated at 0.6" not "good viral potential").
  4. Identify the 3 lowest-scoring dimensions → risks. For each, describe what goes wrong if ignored. If weaknesses.json exists, use its root_cause_type and failure_mode to add specificity.
  5. Extract the RAT from scores.json.riskiest_assumption_test. Frame it as the one question to answer before writing a line of code.
  6. Run a pre-mortem: assume the idea failed 12 months from now. Write 3 most likely causes of death based on the risk profile.
  7. Compose the recommended next step:
    • If verdict = pursue: the next step is to build a scoped MVP (define what "scoped" means for this idea).
    • If verdict = test: the next step IS the RAT experiment from scores.json. Restate it with concrete specifics (channel, spend, threshold, timeline).
    • If verdict = pivot: the next step is the recommended pivot from pivot_options.json (if available) or running the pivot-engine skill.
    • If verdict = drop: the next step is to archive and move on. Name one thing learned from the analysis that applies to future ideas.
  8. Define kill criteria: the specific outcome that means "stop and move on." This is the inverse of the RAT pass threshold.
  9. Write the alternative path — what to do if the recommended step fails or the kill criteria is met.
  10. Write the memo following the template below.
Show full SKILL.md (261 more words)Show less
Validation Watermark

If score_confidence from scores.json is not "high", insert a watermark immediately after the score line:

ConfidenceWatermark
medium"This score is based on incomplete data. {list missing dimensions}. Run these analyses before making a build/no-build decision."
low"LOW CONFIDENCE — Only {N} of 7 dimensions scored. This verdict is directional, not conclusive. Required before acting: {list mandatory missing analyses}."
Pre-mortem Method

The pre-mortem is a proven debiasing technique (Klein, 2007). It forces the founder to imagine failure before committing resources.

Instructions:

  1. Assume the idea launched and failed within 12 months.
  2. Working backward from the risk profile and killer dimensions, write the 3 most probable causes of death.
  3. Each cause must be specific and tied to a scored dimension — not generic ("ran out of money" is too vague; "CAC exceeded LTV by 4x because TikTok organic reach declined and no paid channel was viable under $500/mo" is useful).

Output

Write to memory/ideas/<slug>/decision_memo.md:

markdown
---
idea_slug: ""
verdict: "pursue | test | pivot | drop"
final_score: 0
score_confidence: "high | medium | low"
created_at: ""
---

# Decision Memo: <Idea Name>

## Verdict: <PURSUE / TEST / PIVOT / DROP>

**Score: X/100** | Confidence: <high / medium / low>

<Validation watermark — only if confidence is medium or low>

---

## Why This Score

<2–3 sentences explaining what the score means in plain language. Not a recap of methodology — a statement of what the analysis revealed about this idea's viability.>

## Top 3 Strengths

1. **<Dimension>** (<score>/100): <one sentence with specific data point>
2. **<Dimension>** (<score>/100): <one sentence with specific data point>
3. **<Dimension>** (<score>/100): <one sentence with specific data point>

## Top 3 Risks

1. **<Dimension>** (<score>/100): <the risk>. <what happens if ignored — the failure mode.>
2. **<Dimension>** (<score>/100): <the risk>. <what happens if ignored — the failure mode.>
3. **<Dimension>** (<score>/100): <the risk>. <what happens if ignored — the failure mode.>

## Riskiest Assumption

The assumption most likely to kill this idea:

> "<the assumption, stated plainly>"

**Test it before building anything.** <Restate the RAT experiment: what to do, how long, how much it costs, and what "pass" looks like.>

## Pre-mortem: If This Fails in 12 Months

1. <Most likely cause of death — specific, tied to data>
2. <Second most likely cause — specific, tied to data>
3. <Third most likely cause — specific, tied to data>

---

## What To Do Now

<The one recommended next step — concrete, specific, calibrated to founder tier. Include timeline and cost if applicable.>

**Kill criteria:** <The specific outcome that means stop. e.g., "If landing page converts below 5% after 200 visitors, drop this idea.">

## If That Doesn't Work

<Alternative path — one sentence. What to do if the recommended step fails or kill criteria is met.>

Notes

  • If the verdict is pivot and pivot_options.json exists, embed the recommended pivot in the "What To Do Now" section with enough detail to act on immediately.
  • If the verdict is drop, the tone should be respectful but firm. Don't soften a drop verdict. The value of a good drop is the time it saves for the next idea.
  • The memo should be re-generated whenever scores.json is updated (e.g., after a pivot re-score). Append a version note at the bottom: _v2 — re-scored after [pivot description]_.
  • Decision memos are the primary artifact the user references after the session. Optimize for re-readability days later, not just first-read clarity.

© MaxKmet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/decision-memo of MaxKmet/idea-validation-agents.

Open the folder on GitHubat commit 3a4c800

Compare with similar skills

Decision Memo next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Decision Memo compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Decision Memo this skillMaxKmet/idea-validation-agents477—~2kAutomated safety check: PassMIT
Net New Video Editorericosiu/ai-marketing-skills3.6k—~1.1kAutomated safety check: PassMIT
Business Contact and Social Links Finderbrowser-act/skills6.1k1 repos~1.6kAutomated safety check: PassMIT
Gingiris Ugc MatrixGingiris-1031/Competitor-analysis-tool110—~790Automated safety check: PassNone
Platform Arbitrageacogood/diffmode_free163—~2.5kAutomated safety check: PassApache-2.0
Tiktok Automationdavepoon/buildwithclaude3.6k7 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • Net New Video Editor

    ericosiu/ai-marketing-skills

    Turn newly recorded talking-head footage into review-ready vertical video drafts with an explicit edit plan, deterministic FFmpeg rendering, captions, hook cards, audio normalization, and visual QA.

    3.6k GitHub stars~1.1k tokensUpdated 17 days ago
    Media & CreativeAuto-check passed
  • Finds a company's official website and social profiles from its name, or collects social links from a website URL, using BrowserAct templates run by a Python script.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Marketing & SEOAuto-check passed
  • Gingiris Ugc Matrix

    Gingiris-1031/Competitor-analysis-tool

    🇺🇸 UGC Matrix Growth Playbook — Scale user-generated content with AI + real creators.

    110 GitHub stars~790 tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Platform Arbitrage

    acogood/diffmode_free

    Platform arbitrage audit for a founder's product — a Diffmode growth-tactics think-tank research stage (prompt TT-DG-003).

    163 GitHub stars~2.5k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Tiktok Automation

    davepoon/buildwithclaude

    Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats.

    3.6k GitHub starsUsed in 7 repos~1.7k tokens
    Productivity & AutomationAuto-check passed
  • Social Media Dashboard

    nexu-io/open-design

    Creator-facing social media analytics dashboard in a single HTML file.

    100k GitHub stars~1.4k tokensUpdated today
    Business, Finance & HRAuto-check passed

More from MaxKmet/idea-validation-agents

All 15 skills in this repo
  • Cac Modeler

    MaxKmet/idea-validation-agents

    Models LTV, CAC by channel, LTV:CAC ratios, and payback period for an indie developer.

    477 GitHub stars~3.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Competitor Mapper

    MaxKmet/idea-validation-agents

    Maps the full competitive landscape — direct, indirect, substitute, and emerging competitors — with positioning gap analysis, review mining, and marketinsights-calibrated saturation scoring.

    477 GitHub stars~3.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Desire Evaluator

    MaxKmet/idea-validation-agents

    Scores the strength of core human desire motivations (survival, status, belonging, control, curiosity) for a given app idea to predict user pull and retention potential.

    477 GitHub stars~551 tokensUpdated 3 mo ago
    Auto-check passed
  • Distribution Analysis

    MaxKmet/idea-validation-agents

    Evaluates organic reach potential, paid feasibility, platform distribution advantages, creator economy fit, and founder edge for a B2C app idea.

    477 GitHub stars~3.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Idea Scoring

    MaxKmet/idea-validation-agents

    Aggregates all dimension scores into a final idea score (0–100) and issues a verdict.

    477 GitHub stars~3.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Pivot Engine

    MaxKmet/idea-validation-agents

    Generates structured pivot options for a scored idea based on weak dimensions, marketinsights signals, and founder constraints.

    477 GitHub stars~4.7k tokensUpdated 3 mo ago
    Auto-check passed

Works with

Questions about Decision Memo

What does Decision Memo do?

Writes a concise, human-readable decision brief summarizing the full validation analysis — including score, verdict, RAT experiment, pre-mortem, and tier-appropriate next actions. Decision Memo is an agent skill from MaxKmet/idea-validation-agents. Writes a concise, human-readable decision brief summarizing the full validation analysis — including score, verdict, RAT experiment, pre-mortem, and tier-appropriate next actions.

How do I install Decision Memo in Claude Code?

Run `npx skills add MaxKmet/idea-validation-agents --skill decision-memo -a claude-code`. Or copy the skill folder (skills/decision-memo in MaxKmet/idea-validation-agents) into .claude/skills/decision-memo in your project. Claude Code loads it when a task matches its description.

How do I install Decision Memo in Codex?

Run `npx skills add MaxKmet/idea-validation-agents --skill decision-memo -a codex`. Or copy the skill folder (skills/decision-memo in MaxKmet/idea-validation-agents) into .agents/skills/decision-memo in your project. Codex loads it when a task matches its description.

Can I use Decision Memo in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MaxKmet/idea-validation-agents --skill decision-memo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/decision-memo, .gemini/skills/decision-memo, .github/skills/decision-memo and .opencode/skills/decision-memo in your project.

What does Decision Memo need to run?

SKILL.md names no scripts, command-line tools or credentials: Decision Memo is instructions for the agent only.

Does Decision Memo access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Decision Memo safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Decision Memo use?

Decision Memo is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Decision Memo use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Decision Memo?

Skills that share tags, products or a category with Decision Memo: Net New Video Editor (ericosiu/ai-marketing-skills, 3.6k stars), Business Contact and Social Links Finder (browser-act/skills, 6.1k stars), Gingiris Ugc Matrix (Gingiris-1031/Competitor-analysis-tool, 110 stars) and Platform Arbitrage (acogood/diffmode_free, 163 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Decision Memo?

MaxKmet (a GitHub user) maintains it in MaxKmet/idea-validation-agents, which has 477 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on June 16, 2026.

Source: MaxKmet/idea-validation-agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.