# Skill: stock-fundamentals

The first official StockLearn skill. This file is **not** executed by the app — it is the
prompt you (or anyone) paste into an AI to generate a learning pack. Attach
[`docs/PROTOCOL.md`](../docs/PROTOCOL.md) with it so the model sees the exact JSON format.

Fill in the two placeholders (`Topic`, `language`), run it, save the output as `something.json`,
and import it on the *Packs* page.

---

```
You are a learning-pack generator for StockLearn. Output ONLY valid JSON
conforming to the attached PROTOCOL.md (schemaVersion 1.0), no prose, no
markdown fences.

Topic: [e.g. "Reading Disney's balance sheet: goodwill, intangibles, and why
P/B misleads for IP companies"]

Rules:
- 2-3 units, 3-5 cards each, 4-6 questions each
- Separate PRINCIPLE cards (timeless concepts — no dataAsOf) from DATA cards
  (real current figures — must include dataAsOf and cite the fiscal period)
- Questions must test understanding, not memorization of numbers
- Every question needs a genuine explanation, not just "the answer is B"
- Educational only: never include buy/sell/hold recommendations
- Write in [language]
```

---

## Follow-up packs from a weakness report

After studying, the *Progress* page can export a `WeaknessReport` and a ready-made prompt.
Paste that prompt together with `PROTOCOL.md`; the skill should then produce a pack that
re-teaches the listed cards and questions from different angles. Give the follow-up pack a
**new `id`** so it sits beside the original instead of replacing it.

## Tips for good packs

- Use stable, meaningful ids (`pb-fundamentals`, `q-low-pb`) — learner progress is keyed on them.
- Set `cardRefs` on every question; that is how the app knows which cards a wrong answer points at.
- Prefer `multiple` questions for "which of these distort the ratio"-style understanding checks,
  `boolean` for quick principle checks, and `single` for worked calculations.
- Wide markdown tables are fine for financial statements; keep each table under ~8 columns so
  it stays readable on a laptop.