Agent skill

Decision Log Setup

by mohitagw15856 in mohitagw15856/pm-claude-skills

Set up the team decision log that ends relitigation — the one-line-per-decision format (what, why, who, when, reopening rule), the capture moments wired into existing rituals, and the lookup habit…

MITAuto-check passedDevelopment

Install Decision Log Setup

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill decision-log-setup -a claude-code

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

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills decision-log-setup --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/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/decision-log-setup .claude/skills/decision-log-setup && 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-log-setup
GitHub stars
1.4k
Token cost
~1.4k tokens
SKILL.md length
711 words
Files
1
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

Set up the team decision log that ends relitigation — the one-line-per-decision format (what, why, who, when, reopening rule), the capture moments wired into existing rituals, and the lookup habit…

  • Works in 5 steps: The line is five fields and stays a… → Capture rides existing rituals: the… → The reopening rule is stated per… → …
  • Asked set up a decision log
  • SKILL.md covers What This Skill Produces, Required Inputs, Framework: The Log Rules and Output Format, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Decision Log Setup is an agent skill from mohitagw15856/pm-claude-skills. Set up the team decision log that ends relitigation — the one-line-per-decision format (what, why, who, when, reopening rule), the capture moments wired into existing rituals, and the lookup habit that makes it pay. Use when asked set up a decision log, we keep re-deciding the same things, where do decisions get recorded, or new people keep asking why we do X. Produces the log format, the capture wiring, the reopening rule, and the retrieval habits.

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

It sits in Development, covering Architecture decision records. The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Asked set up a decision log
  • We keep re-deciding the same things
  • Where do decisions get recorded
  • New people keep asking why we do X

Example prompts

  • “/decision-log-setup”

Workflow steps

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

  1. The line is five fields and stays a line: date · decision (one sentence, the what) · why (two sentences max, including the rejected…
  2. Capture rides existing rituals: the decision meeting's on-screen close writes the line · the thread landing's record is the line · the…
  3. The reopening rule is stated per decision: default — "reopens on new information, not new preferences" — with specific triggers where…
  4. Retrieval is the ROI moment: the why-question response becomes a link ("logged here — short version: chose X over Y for Z"), the…
  5. Back-fill the greatest hits only: the 10–15 decisions people actually re-ask about get retro-logged (best-effort whys, marked as…

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. 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.

    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 Log Setup loads about 1.4k tokens when it runs. Until then it costs about 118 tokens; SKILL.md has 711 words of instructions outside code blocks.

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

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 mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 711 words, ~1,402 tokens.

Download SKILL.mdSave it as .claude/skills/decision-log-setup/SKILL.md (or your agent's skills folder).
name
decision-log-setup
description
Set up the team decision log that ends relitigation — the one-line-per-decision format (what, why, who, when, reopening rule), the capture moments wired into existing rituals, and the lookup habit that makes it pay. Use when asked set up a decision log, we keep re-deciding the same things, where do decisions get recorded, or new people keep asking why we do X. Produces the log format, the capture wiring, the reopening rule, and the retrieval habits.

Decision Log Setup Skill

Teams re-decide because decisions evaporate: made in a meeting, mentioned in a thread, remembered differently by everyone, and relitigated the moment someone new (or someone persistent) asks "wait, why do we…?" The decision log is the cheapest institutional memory there is — one line per decision (what, why, who, when, and the reopening rule) — but logs fail as shelf-ware unless capture is wired into existing moments (the meeting's last five minutes, the thread's landing) and retrieval becomes reflex ("checked the log?" as the first response to why-questions).

What This Skill Produces

  • The format — the five-field line, with the two-sentence-why discipline and the option-we-rejected field that does the anti-relitigation work
  • The capture wiring — the existing moments (decision-meeting-format closes, thread-to-decision landings, 1:1 calls) that now end with a log line
  • The reopening rule — what reopens a decision (new information) and what doesn't (new mood, new people)
  • The retrieval habits — the log-first reflex, the onboarding tour, the link-not-relitigate response

Required Inputs

Ask for these if not provided:

  • Where decisions currently happen — the meetings, threads, and hallways; capture wires into real venues, and unwired venues keep leaking
  • The platform — a doc, a wiki page, a database/table; sortable-and-searchable beats beautiful, and the log lives where the team already looks
  • The scope line — which decisions get logged (the test: would someone plausibly ask "why" in six months?) vs. the operational micro-calls that don't; over-logging kills the habit as surely as under-logging kills the value
  • The relitigation history — the decisions that keep reopening; they get back-filled first, because they're the demonstration

Framework: The Log Rules

  1. The line is five fields and stays a line: date · decision (one sentence, the what) · why (two sentences max, including the rejected alternative: "chose X over Y because Z") · decider · reopening trigger. The rejected-alternative clause is the anti-relitigation payload — "we considered that and here's why not" is the sentence that ends the third rehash.
  2. Capture rides existing rituals: the decision meeting's on-screen close writes the line · the thread landing's record is the line · the weekly's "any decisions this week?" sweeps the strays. New ceremony fails; hitching to existing ceremony sticks. One person per venue owns the write (the facilitator, the thread-lander).
  3. The reopening rule is stated per decision: default — "reopens on new information, not new preferences" — with specific triggers where known ("revisit if churn exceeds X"). This converts "can we talk about this again?" from a social negotiation into a rule lookup, which is the log's quiet superpower.
  4. Retrieval is the ROI moment: the why-question response becomes a link ("logged here — short version: chose X over Y for Z"), the onboarding tour includes the log's greatest hits, and decisions cite prior decisions ("consistent with #47"). A log that's written but never linked is a diary; the link habit is what compounds.
  5. Back-fill the greatest hits only: the 10–15 decisions people actually re-ask about get retro-logged (best-effort whys, marked as reconstructed) — full historical back-fill is archaeology that delays the living log. Forward capture from today; history only where it's actively bleeding.
Show full SKILL.md (205 more words)Show less

Output Format

Decision Log: [team] — lives at [location]

The Format

DateDecisionWhy (incl. rejected alt.)DeciderReopens if

Capture Wiring

[Venue → moment → who writes the line · the weekly sweep as the catch-all]

The Reopening Rule

[The default · how specific triggers get set · the link-instead-of-debate response]

Retrieval Habits

[The why-question → link reflex · onboarding's greatest-hits tour · the back-fill list (10–15, marked reconstructed)]

Quality Checks

  • Every field fits the one-line discipline; whys include the rejected alternative
  • Capture is attached to named existing moments with named writers
  • The reopening default is stated and per-decision triggers are possible
  • The link-first response habit has been demonstrated on a real why-question
  • Back-fill stopped at the greatest hits

Anti-Patterns

  • Do not log without the rejected alternative — "we chose X" without "over Y because Z" relitigates fine
  • Do not build capture as new ceremony — hitch to rituals that already happen
  • Do not log everything — the six-month-why test keeps the log readable and the habit light
  • Do not let new-people-energy reopen settled calls — the rule distinguishes information from mood
  • Do not write and never link — retrieval is where the log earns; capture alone is journaling

Example Trigger Phrases

  • "Set up a decision log."
  • "We keep re-deciding the same things."
  • "Where do decisions get recorded?"

© mohitagw15856, 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-log-setup of mohitagw15856/pm-claude-skills.

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

Decision Log Setup 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 Log Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Decision Log Setup this skillmohitagw15856/pm-claude-skills1.4k—~1.4kAutomated safety check: PassMIT
PR Design DocOpenHands/OpenHands90k—~2.4kAutomated safety check: PassMIT
Cto AdvisorIbrahim-3d/orchestrator-supaconductor3814 repos~2.4kAutomated safety check: PassMIT
Architecture DecisionDonchitos/Claude-Code-Game-Studios26k—~1.7kAutomated safety check: PassMIT
Improve Codebase Architectureywwynm/EverythingDone14415 repos~1.3kAutomated safety check: PassGPL-3.0
Domain Modelingbrim-borium/spotify_sdk1665 repos~806Automated safety check: PassApache-2.0

Similar skills

  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    90k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Cto Advisor

    Ibrahim-3d/orchestrator-supaconductor

    Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

    381 GitHub starsUsed in 4 repos~2.4k tokens
    DevelopmentAuto-check passed
  • Architecture Decision

    Donchitos/Claude-Code-Game-Studios

    Create an ADR documenting a technical decision: context, alternatives considered, consequences.

    26k GitHub stars~1.7k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Improve Codebase Architecture

    ywwynm/EverythingDone

    Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.

    144 GitHub starsUsed in 15 repos~1.3k tokens
    DevelopmentAuto-check passed
  • Domain Modeling

    brim-borium/spotify_sdk

    Build and sharpen a project's domain model. An agent skill from brim-borium/spotify_sdk.

    166 GitHub starsUsed in 5 repos~806 tokens
    DevelopmentAuto-check passed
  • Design Doc Mermaid

    SpillwaveSolutions/design-doc-mermaid

    Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.

    176 GitHub starsUsed in 1 repo~5.6k tokens
    DevelopmentAuto-check passed

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo
  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Decision Log Setup

What does Decision Log Setup do?

Set up the team decision log that ends relitigation — the one-line-per-decision format (what, why, who, when, reopening rule), the capture moments wired into existing rituals, and the lookup habit…. Decision Log Setup is an agent skill from mohitagw15856/pm-claude-skills. Set up the team decision log that ends relitigation — the one-line-per-decision format (what, why, who, when, reopening rule), the capture moments wired into existing rituals, and the lookup habit that makes it pay.

When should I use Decision Log Setup?

Decision Log Setup fits situations like: asked set up a decision log; we keep re-deciding the same things; where do decisions get recorded; new people keep asking why we do X.

How do I install Decision Log Setup in Claude Code?

Run `npx skills add mohitagw15856/pm-claude-skills --skill decision-log-setup -a claude-code`. Or copy the skill folder (skills/decision-log-setup in mohitagw15856/pm-claude-skills) into .claude/skills/decision-log-setup in your project. Claude Code loads it when a task matches its description.

How do I install Decision Log Setup in Codex?

Run `npx skills add mohitagw15856/pm-claude-skills --skill decision-log-setup -a codex`. Or copy the skill folder (skills/decision-log-setup in mohitagw15856/pm-claude-skills) into .agents/skills/decision-log-setup in your project. Codex loads it when a task matches its description.

Can I use Decision Log Setup 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 mohitagw15856/pm-claude-skills --skill decision-log-setup -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-log-setup, .gemini/skills/decision-log-setup, .github/skills/decision-log-setup and .opencode/skills/decision-log-setup in your project.

What does Decision Log Setup need to run?

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

Does Decision Log Setup 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 Log Setup 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 Log Setup use?

Decision Log Setup 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 Log Setup use?

About 1.4k tokens (SKILL.md is roughly 5.6k 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 Log Setup?

Skills that share tags, products or a category with Decision Log Setup: PR Design Doc (OpenHands/OpenHands, 90k stars), Cto Advisor (Ibrahim-3d/orchestrator-supaconductor, 381 stars), Architecture Decision (Donchitos/Claude-Code-Game-Studios, 26k stars) and Improve Codebase Architecture (ywwynm/EverythingDone, 144 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Decision Log Setup?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,433 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 8, 2026.

Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.