Imported from wscherphof/ai-merkator-20260917 (.claude/skills/add-takeaway/SKILL.md). Install upstream with npx skills add wscherphof/ai-merkator-20260917 --skill add-takeaway. Copyright stays with the author.

Add a key takeaway

Overview

This repo collects the key takeaways of a presentation on developing with AI at Merkator. The deliverable is the list in README.md. Every takeaway the user states goes in that list, in their words.

When to use

• The user states a point from the talk ("the next one is…", "another takeaway is…").
• The user refines a takeaway already in the list ("make that one also mention X").
• The user asks to reorder, split, merge, or drop takeaways.

Not for: general edits to this repo that have nothing to do with the list.

Format

The list is a numbered Markdown list under ## Key takeaways. Each item is:

1. **Short imperative headline.** One or two sentences in plain language saying
   what to do and why. Optional sub-bullets when the takeaway has distinct parts:
   - **Name of the part** — what it is, in one line.

Rules:

• Headline is bold, imperative, and short — it is what lands on the slide.
• Body is the speaker's own point, lightly edited for reading. Don't inflate a one-line remark into a paragraph.
• Sub-bullets only when the takeaway genuinely splits into named parts. Otherwise keep it to the sentences.
• Numbering is presentation order. New takeaways append to the end unless the user says where it belongs.

How to add one

1. Read the current ## Key takeaways section before editing, so the new item matches the voice and depth of the existing ones.
2. Append the new numbered item — do not renumber or reword the others.
3. Show the user the resulting section and ask for the next takeaway.

Common mistakes