skilldrop-cli 1.10.0 → 1.11.0

package/packs/educator/skills/exam-paper-check/scripts/exam_check.py

@@ -0,0 +1,328 @@
+#!/usr/bin/env python3
+"""Check an exam paper and its mark scheme for the faults students and moderators find. Stdlib only.
+
+Reads the paper (Markdown, plain text or .docx) and, optionally, its mark scheme and a spec
+(duration, objectives and their target weightings, which question parts assess which objective).
+Reports, each with the question it is in:
+  - part marks that don't add up to a question's stated total, and questions that don't add up
+    to the paper's stated total (an "answer either 5 or 6" choice counts once)
+  - question numbers that skip or repeat, and parts that skip ((a), (c)) or repeat
+  - a part with no marks shown
+  - a part the mark scheme doesn't cover, a scheme entry for a part that isn't in the paper,
+    and a scheme whose marks differ from the paper's
+  - the time per mark, and an objective that is never assessed or is far off its weighting
+It checks the paper's arithmetic and structure, not whether its questions are good.
+
+Usage:
+  python3 exam_check.py paper.md [--scheme scheme.md] [--spec spec.json] [--json]
+Exit codes: 0 no failures, 1 a failure, 2 a file can't be read.
+"""
+import argparse
+import json
+import re
+import sys
+import zipfile
+from xml.etree import ElementTree
+
+W = "{http://schemas.openxmlformats.org/wordprocessingml/2006/main}"
+ROMAN = ["i", "ii", "iii", "iv", "v", "vi", "vii", "viii", "ix", "x", "xi", "xii"]
+
+QUESTION = re.compile(r"^\s*(?:#+\s*)?(?:\*\*)?\s*(?:question|q)\s*\.?\s*(\d{1,3})\b[.):]?(?:\*\*)?\s*(.*)$", re.I)
+BARE_Q = re.compile(r"^\s*(?:\*\*(\d{1,3})[.)]?\*\*|(\d{1,3})[.)])\s+(.*)$")
+PLAIN_Q = re.compile(r"^\s*(\d{1,3})\s+([A-Za-z].*)$")
+COMBINED = re.compile(r"^\s*(?:\*\*)?(\d{1,3})\s*\(?([a-z])\)?(?:\s*\(?((?:x|ix|iv|v?i{0,3}))\))?(?:\*\*)?[\s.:)]+(.*)$", re.I)
+PART = re.compile(r"^\s*(?:\*\*)?\(?([a-z])\)(?:\*\*)?\s*(.*)$")
+SUBPART = re.compile(r"^\s*(?:\*\*)?\(((?:x|ix|iv|v?i{1,3}|v))\)(?:\*\*)?\s*(.*)$", re.I)
+MARK = re.compile(r"[\[(]\s*(\d{1,3})\s*(?:marks?|m)?\s*[\])]\s*\**\s*$", re.I)
+Q_TOTAL = re.compile(r"(?:total\s+for\s+question\s+(\d{1,3})\s*(?:is|=|:)?\s*(\d{1,3})\s*marks?"
+                     r"|question\s+(\d{1,3})\s+total\s*(?:is|=|:)?\s*(\d{1,3})"
+                     r"|\[\s*total\s*(?:for\s+question\s+(\d{1,3}))?\s*[:=]?\s*(\d{1,3})\s*(?:marks?)?\s*\])", re.I)
+PAPER_TOTAL = re.compile(r"(?:total\s+(?:for\s+(?:this\s+)?paper|marks?\s+(?:for\s+(?:this\s+)?paper|available)|marks?)"
+                         r"\s*(?:is|=|:)?\s*(\d{1,4})|(?:this\s+paper\s+is\s+worth|maximum\s+mark\s*(?:is|:)?)\s*(\d{1,4})"
+                         r"|(\d{1,4})\s+marks?\s+in\s+total|total\s+of\s+(\d{1,4})\s+marks?)", re.I)
+DURATION = re.compile(r"(?:time(?:\s+allowed)?|duration)\s*[:=]?\s*(?:(\d{1,2})\s*h(?:ours?|rs?)?\s*)?(?:(\d{1,3})\s*min(?:utes?|s)?)?", re.I)
+EITHER = re.compile(r"answer\s+either\s+question\s+(\d{1,3})\s+or\s+(?:question\s+)?(\d{1,3})", re.I)
+
+
+def read_text(path):
+    if path.lower().endswith(".docx"):
+        with zipfile.ZipFile(path) as z:
+            root = ElementTree.fromstring(z.read("word/document.xml"))
+        return ["".join(t.text or "" for t in p.iter(W + "t")) for p in root.iter(W + "p")]
+    with open(path, encoding="utf-8-sig") as f:
+        return f.read().splitlines()
+
+
+def parse(lines):
+    """Questions with their parts and marks, in document order, plus the stated totals."""
+    qs = []
+    q = part = None
+    stated, stated_line, duration, choices = None, None, None, []
+
+    def new_question(n, line):
+        nonlocal q, part
+        q = {"n": n, "line": line, "parts": [], "stated": None, "marks": None}
+        qs.append(q)
+        part = None
+
+    def new_part(label, line):
+        nonlocal part
+        part = {"label": label, "line": line, "marks": None}
+        q["parts"].append(part)
+
+    for i, raw in enumerate(lines, 1):
+        line = raw.strip()
+        if not line:
+            continue
+        totals = list(Q_TOTAL.finditer(line))
+        if totals:
+            for m in totals:
+                qn = m.group(1) or m.group(3) or m.group(5)
+                val = int(m.group(2) or m.group(4) or m.group(6))
+                target = next((x for x in reversed(qs) if str(x["n"]) == qn), None) if qn else q
+                if target is not None:
+                    target["stated"] = val
+            continue
+        pm = PAPER_TOTAL.search(line)
+        if pm and stated is None and not re.search(r"question\s+\d", line, re.I):
+            stated, stated_line = int(next(g for g in pm.groups() if g)), i
+            continue
+        dm = DURATION.search(line)
+        if dm and duration is None and (dm.group(1) or dm.group(2)):
+            duration = int(dm.group(1) or 0) * 60 + int(dm.group(2) or 0)
+        choices += [(int(e.group(1)), int(e.group(2))) for e in EITHER.finditer(line)]
+
+        rest, labelled = line, False
+        m, c, b = QUESTION.match(line), COMBINED.match(line), BARE_Q.match(line)
+        if not b:
+            pl = PLAIN_Q.match(line)    # "4 Level-marked…" in a scheme: only as the next question number
+            if pl and (q is None and pl.group(1) == "1" or q is not None and int(pl.group(1)) == q["n"] + 1):
+                b = re.match(r"^\s*()(\d{1,3})\s+(.*)$", line)
+        sub, pt = SUBPART.match(line), PART.match(line)
+        if m:
+            new_question(int(m.group(1)), i)
+            rest, labelled = m.group(2), True
+        elif c and c.group(2).lower() <= "j":
+            n = int(c.group(1))
+            if q is None or q["n"] != n:
+                new_question(n, i)
+            new_part(c.group(2).lower() + (f"({c.group(3).lower()})" if c.group(3) else ""), i)
+            rest, labelled = c.group(4), True
+        elif b and (q is None or b.group(1) or int(b.group(2)) == q["n"] + 1):   # a bold number is always a question
+            new_question(int(b.group(1) or b.group(2)), i)
+            rest, labelled = b.group(3), True
+        elif q is not None and sub and part is not None and not (
+                sub.group(1).lower() == "i" and part["label"] == "h"):   # (i) after (h) is the next part
+            new_part(f"{part['label'].split('(')[0]}({sub.group(1).lower()})", i)
+            rest, labelled = sub.group(2), True
+        elif q is not None and pt:
+            new_part(pt.group(1).lower(), i)
+            rest, labelled = pt.group(2), True
+            inner = SUBPART.match(rest)        # "(a) (i) Describe…" opens the part and its first subpart
+            if inner:
+                new_part(f"{part['label']}({inner.group(1).lower()})", i)
+                rest = inner.group(2)
+        mk = MARK.search(rest)
+        if mk and q is not None:
+            if part is not None:
+                if part["marks"] is None:
+                    part["marks"] = int(mk.group(1))
+            elif q["marks"] is None:
+                q["marks"] = int(mk.group(1))
+    return {"questions": qs, "stated_total": stated, "stated_line": stated_line,
+            "duration": duration, "choices": choices}
+
+
+def q_marks(q):
+    leaves = leaf_parts(q)
+    if leaves:
+        return sum(p["marks"] or 0 for p in leaves)
+    return q["marks"] or 0
+
+
+def leaf_parts(q):
+    """Parts that carry marks themselves: (a)(i) and (a)(ii), not (a) when it has subparts."""
+    labels = [p["label"] for p in q["parts"]]
+    return [p for p in q["parts"] if not any(o.startswith(p["label"] + "(") for o in labels)]
+
+
+def check(paper, scheme=None, spec=None):
+    fails, warns = [], []
+    qs = paper["questions"]
+    if not qs:
+        return {"fails": ["no numbered questions found"], "warns": [], "rows": [], "total": 0, "stated_total": None,
+                "duration": None, "pace": None, "coverage": {}}
+    seen = {}
+    for q in qs:
+        if q["n"] in seen:
+            fails.append(f"Question {q['n']} is numbered twice (lines {seen[q['n']]} and {q['line']})")
+        seen.setdefault(q["n"], q["line"])
+    nums = sorted(seen)
+    for a, b in zip(nums, nums[1:]):
+        if b != a + 1:
+            warns.append(f"question numbers jump from {a} to {b}")
+    if nums[0] != 1:
+        warns.append(f"the first question is numbered {nums[0]}")
+    rows = []
+    for q in qs:
+        letters, last_roman = [], {}
+        for p in q["parts"]:
+            base, _, sub = p["label"].partition("(")
+            if sub:
+                r = sub.rstrip(")")
+                prev = last_roman.get(base)
+                want = ROMAN[ROMAN.index(prev) + 1] if prev in ROMAN and ROMAN.index(prev) + 1 < len(ROMAN) else "i"
+                if r != want:
+                    warns.append(f"Question {q['n']}({base}): part ({r}) follows ({prev or '—'}); expected ({want})")
+                last_roman[base] = r
+            else:
+                if base in letters:
+                    fails.append(f"Question {q['n']}: part ({base}) appears twice")
+                elif letters and ord(base) != ord(letters[-1]) + 1:
+                    warns.append(f"Question {q['n']}: part ({base}) follows ({letters[-1]}); "
+                                 f"({chr(ord(letters[-1]) + 1)}) is missing")
+                elif not letters and base != "a":
+                    warns.append(f"Question {q['n']}: the first part is ({base})")
+                letters.append(base)
+        for p in leaf_parts(q):
+            if p["marks"] is None:
+                warns.append(f"Question {q['n']}({p['label']}) shows no marks")
+        if not q["parts"] and q["marks"] is None and q["stated"] is None:
+            warns.append(f"Question {q['n']} shows no marks")
+        total = q_marks(q) if (q["parts"] or q["marks"] is not None) else (q["stated"] or 0)
+        if q["stated"] is not None and (q["parts"] or q["marks"] is not None) and total != q["stated"]:
+            fails.append(f"Question {q['n']}: the parts add up to {total} but the question total says {q['stated']}")
+        rows.append({"question": q["n"], "marks": total, "stated": q["stated"],
+                     "parts": {p["label"]: p["marks"] for p in leaf_parts(q)}})
+    by_n = {r["question"]: r["marks"] for r in rows}
+    total = sum(by_n.values())
+    for a, b in paper["choices"]:
+        if a in by_n and b in by_n:
+            total -= min(by_n[a], by_n[b])
+            if by_n[a] != by_n[b]:
+                fails.append(f"Questions {a} and {b} are a choice but are worth {by_n[a]} and {by_n[b]} marks")
+    stated = paper["stated_total"] if paper["stated_total"] is not None else (spec or {}).get("total")
+    if stated is not None and total != stated:
+        fails.append(f"the questions add up to {total} marks but the paper says {stated}")
+    duration = paper["duration"] or (spec or {}).get("duration_minutes")
+    pace = duration / total if duration and total else None
+    if scheme is not None:
+        smap = {}
+        for q in scheme["questions"]:
+            leaves = leaf_parts(q)
+            if leaves:
+                for p in leaves:
+                    smap[f"{q['n']}{p['label']}"] = p["marks"]
+            else:
+                smap[str(q["n"])] = q["marks"]
+        pmap = {}
+        for q in qs:
+            leaves = leaf_parts(q)
+            if leaves:
+                for p in leaves:
+                    pmap[f"{q['n']}{p['label']}"] = p["marks"]
+            else:
+                pmap[str(q["n"])] = q["marks"] if q["marks"] is not None else q["stated"]
+        for k, v in pmap.items():
+            if k not in smap:
+                fails.append(f"the mark scheme has nothing for {pretty(k)}")
+            elif smap[k] is not None and v is not None and smap[k] != v:
+                fails.append(f"{pretty(k)} is worth {v} on the paper but {smap[k]} in the mark scheme")
+        for k in smap:
+            if k not in pmap:
+                fails.append(f"the mark scheme covers {pretty(k)}, which isn't on the paper")
+        if scheme.get("stated_total") is not None:
+            s_by_q = {}
+            for k, v in smap.items():
+                n = int(re.match(r"\d+", k).group(0))
+                s_by_q[n] = s_by_q.get(n, 0) + (v or 0)
+            s_total = sum(s_by_q.values())
+            for a, b in paper["choices"]:
+                if a in s_by_q and b in s_by_q:
+                    s_total -= min(s_by_q[a], s_by_q[b])
+            if s_total != scheme["stated_total"]:
+                fails.append(f"the mark scheme says it is out of {scheme['stated_total']} but its own marks add up to {s_total}")
+    coverage = {}
+    if spec and spec.get("assesses"):
+        targets = spec.get("objectives", {})
+        pmarks = {}
+        for q in qs:
+            leaves = leaf_parts(q)
+            for p in leaves or [{"label": "", "marks": q_marks(q)}]:
+                pmarks[f"{q['n']}{p['label']}"] = p["marks"] or 0
+        dropped = {str(b) for _, b in paper["choices"]}   # a choice counts once
+        for key, objs in spec["assesses"].items():
+            k = key.replace(" ", "").lower()
+            if re.match(r"\d+", k).group(0) in dropped:
+                continue
+            share = pmarks.get(k)
+            if share is None:
+                matches = {pk: v for pk, v in pmarks.items() if pk.startswith(k)}
+                share = sum(matches.values()) if matches else None
+            if share is None:
+                warns.append(f"the spec maps {key} to objectives but there is no {key} on the paper")
+                continue
+            objs = [objs] if isinstance(objs, str) else objs
+            for o in objs:
+                coverage[o] = coverage.get(o, 0) + share / len(objs)
+        for o, target in targets.items():
+            got = coverage.get(o, 0)
+            if got == 0:
+                fails.append(f"objective {o} is never assessed")
+            elif target and total and abs(got / total * 100 - target) > max(5, target * 0.25):
+                warns.append(f"objective {o} has {got / total * 100:.0f} % of the marks against a target of {target:g} %")
+    return {"fails": fails, "warns": warns, "rows": rows, "total": total, "stated_total": stated,
+            "duration": duration, "pace": pace, "coverage": coverage}
+
+
+def pretty(key):
+    m = re.match(r"(\d+)([a-z]?)(\(.*\))?", key)
+    n, a, r = m.groups()
+    return f"Question {n}" + (f"({a})" if a else "") + (r or "")
+
+
+def report(r):
+    L = ["# Exam paper check", "", "| Question | Marks | Stated total | Parts |", "|---|---:|---:|---|"]
+    for row in r["rows"]:
+        parts = ", ".join(f"({k.replace('(', ')(').rstrip(')')}) {v if v is not None else '?'}" for k, v in row["parts"].items())
+        L.append(f"| {row['question']} | {row['marks']} | {row['stated'] if row['stated'] is not None else ''} | {parts} |")
+    L.append(f"| **Paper** | **{r['total']}** | {r['stated_total'] if r['stated_total'] is not None else ''} | |")
+    if r["pace"]:
+        L += ["", f"Time: {r['duration']} minutes for {r['total']} marks, {r['pace']:.2f} minutes a mark."]
+    if r["coverage"]:
+        L += ["", "| Objective | Marks | Share |", "|---|---:|---:|"]
+        for o, v in sorted(r["coverage"].items()):
+            L.append(f"| {o} | {v:g} | {v / r['total'] * 100:.0f} % |")
+    L.append("")
+    if not r["fails"]:
+        L.append("PASS every total adds up, numbering runs in order, and the scheme matches the paper.")
+    L += [f"FAIL {f}" for f in r["fails"]] + [f"WARN {w}" for w in r["warns"]]
+    return "\n".join(L) + "\n"
+
+
+def main(argv=None):
+    ap = argparse.ArgumentParser(description="Check an exam paper and its mark scheme.")
+    ap.add_argument("paper")
+    ap.add_argument("--scheme", help="the mark scheme (.md, .txt or .docx)")
+    ap.add_argument("--spec", help="spec.json: duration_minutes, total, objectives {name: target %%}, assesses {part: [objectives]}")
+    ap.add_argument("--json", action="store_true")
+    args = ap.parse_args(argv)
+    try:
+        paper = parse(read_text(args.paper))
+        scheme = parse(read_text(args.scheme)) if args.scheme else None
+        spec = None
+        if args.spec:
+            with open(args.spec, encoding="utf-8-sig") as f:
+                spec = json.load(f)
+            if not isinstance(spec, dict):
+                raise ValueError("spec.json must be an object")
+    except (OSError, ValueError, UnicodeDecodeError, zipfile.BadZipFile, KeyError, ElementTree.ParseError) as e:
+        print(f"FAIL cannot read input: {e}")
+        return 2
+    r = check(paper, scheme, spec)
+    print(json.dumps(r, indent=2) if args.json else report(r), end="" if not args.json else "\n")
+    return 1 if r["fails"] else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/packs/educator/skills/exam-paper-check/templates/spec.json

@@ -0,0 +1,11 @@
+{
+  "duration_minutes": 50,
+  "total": 50,
+  "objectives": {"AO1": 40, "AO2": 40, "AO3": 20},
+  "assesses": {
+    "1a": "AO1", "1b": "AO2", "1c": "AO1",
+    "2a(i)": "AO1", "2a(ii)": "AO2", "2a(iii)": "AO2", "2b": "AO3",
+    "3a": "AO1", "3b": "AO3", "3c": "AO2",
+    "4": ["AO1", "AO3"]
+  }
+}

package/packs/startup-legal/pack.json

@@ -1,5 +1,5 @@
 {
-  "description": "Legal groundwork for a startup that can't yet pay a lawyer for everything: an agreement checked before you sign it (blanks, broken cross-references, mismatched amounts, the renewal date, and the clauses that hurt a small company, with wording to ask for), your cap table modelled through SAFEs, notes and a priced round, and your first office lease turned into its real commitment and exit dates. Each says what is worth a lawyer's hour.",
+  "description": "Legal groundwork for a startup that can't yet pay a lawyer for everything: an agreement checked before you sign it (blanks, broken cross-references, mismatched amounts, the renewal date, and the clauses that hurt a small company, with wording to ask for), your cap table modelled through SAFEs, notes and a priced round, vesting schedules with leavers, acceleration and the 83(b) deadline, and your first office lease turned into its real commitment and exit dates. Each says what is worth a lawyer's hour.",
   "display_name": "Startup legal",
   "keywords": [
     "legal",
@@ -10,6 +10,8 @@
     "SAFE",
     "cap table",
     "dilution",
+    "vesting",
+    "83(b)",
     "lease"
   ],
   "links": {
@@ -39,6 +41,7 @@
     "you_bring": [
       "the agreement you've been sent, or your own template",
       "your cap table, SAFEs and any term sheet",
+      "grant documents for anyone with vesting shares or options",
       "the heads of terms or draft lease for an office"
     ],
     "steps": [
@@ -54,6 +57,11 @@
         "you_get": "What each founder and investor owns after the round, what each SAFE converted at, and what the pool top-up cost you.",
         "decide": "Which valuation and pool terms to negotiate for."
       },
+      {
+        "skill": "vesting-schedule",
+        "you_do": "Give it each grant's shares, start date and terms, and any leaving date.",
+        "you_get": "Cliff and fully-vested dates, what is vested on any date, leaver outcomes, and the 83(b) deadline as an exact date."
+      },
       {
         "skill": "lease-check",
         "you_do": "Give it the heads of terms or the draft lease.",
@@ -61,6 +69,6 @@
         "decide": "Sign, negotiate, or take the guarantee or break clause to a lawyer."
       }
     ],
-    "you_end_with": "Agreements you understand before signing, a cap table you can defend, and an office lease whose cost and exits you know."
+    "you_end_with": "Agreements you understand before signing, a cap table and vesting schedule you can defend, and an office lease whose cost and exits you know."
   }
 }

package/packs/startup-legal/skills/vesting-schedule/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: vesting-schedule
+description: Work out vesting for founder stock, restricted stock, options and RSUs — each grant's cliff date and amount, every vesting date in whole shares, what is vested on any date, what happens when someone leaves (vested, forfeited or repurchasable, and the last day to exercise), single- and double-trigger acceleration on a sale, and the US 83(b) election deadline moved past weekends and holidays — computed by a script that keeps the totals exact. Use when a founder asks "how much has my co-founder vested", "what happens to her shares if she leaves", "when does the cliff hit", "build our vesting schedule", "when is the 83(b) deadline", or "what does double-trigger acceleration give us in a sale".
+---
+
+# vesting-schedule
+
+Founders and early employees ask the same questions at the worst moments: a co-founder is
+leaving, an acquirer is asking, a grant was signed last week and nobody remembers the 83(b).
+The answers are date arithmetic that is easy to get wrong in ways that matter: a vesting start
+on the 31st in a month with 30 days, a cliff that falls between two quarterly dates, rounding
+that runs ahead of the grant, a 30-day deadline that lands on the Fourth of July. A script
+computes every grant exactly; the agent turns the founder's documents into its input and the
+result into the answer they need.
+
+## How to respond
+
+**These rules come before the steps and outrank them:**
+
+- **Answer the question asked, first.** ✅ *"If Sam leaves on 20 August, 45,000 of their
+  120,000 options have vested and the other 75,000 lapse. They have until 18 November to
+  exercise."* Never mention a script, a JSON file, this skill's name, a path inside its folder
+  or a temporary path, and never call your work "the check" or "a tool".
+- **Every share count and date comes from the computed schedule,** run on the final inputs.
+  Each scenario the person asks about (a leaving date, a closing date, "what if she's let go
+  in July instead") is its own run with that date. Never count months by hand: a 30-month
+  answer written as 31 is the commonest error in this work.
+- **Stay on the questions asked,** in their order, and answer each fully. For a leaver that
+  means what happens to the unvested shares: who can buy them back, at what price if the
+  documents say, and the deadline for doing it as a date, against today's date, plus the last
+  day to exercise vested options.
+- **The 83(b) deadline is never approximate.** Give the date, say it is 30 days from the grant
+  (or from an early exercise), and when day 30 falls on a weekend or federal holiday, say that
+  the deadline moves to the next business day and advise filing well before day 30 anyway.
+  When it has passed, say so plainly and what that means: the shares are taxed as they vest
+  instead of at grant. Recommend a tax adviser only for what to do next, not for the date.
+- **Say which terms you assumed.** The vesting start (often earlier than the grant date), the
+  cliff, monthly or quarterly vesting, the exercise window after leaving (90 days is usual), the
+  company's buy-back window, what counts as a "good reason" resignation for double-trigger, and
+  how acceleration is ordered (single trigger here applies to what is unvested at the sale;
+  documents sometimes accelerate from the end of the schedule instead). Tag each `[assumption]` and
+  give the figure under the other reading when it changes the answer.
+- **Name what is worth a lawyer's hour, and only that.** One or two lines: a leaver dispute,
+  acceleration terms an acquirer is pushing back on, a missed 83(b). Never refuse, never open
+  with a disclaimer.
+- **Working files stay out of sight.** The input goes in a private temporary folder
+  (`mktemp -d`) and is deleted before replying. A spreadsheet they asked for goes in their
+  working directory under a plain name.
+
+1. **Gather each grant** from the documents or the conversation: holder, type (founder stock,
+   restricted stock, option, RSU), shares, grant date, vesting start, months, cliff, frequency,
+   acceleration (single trigger: on a sale; double trigger: a sale and then losing the job within
+   a window), any leaving date, any early exercise, and whether an 83(b) was filed. Defaults
+   when unsaid: 48 months, a 12-month cliff, monthly, US. Ask at most two questions, only for a
+   missing share count or start date.
+
+2. **Write the input** in the shape of [`templates/vesting.json`](templates/vesting.json). A sale
+   goes in `change_of_control` at the top.
+
+3. **Run it** on the date they care about (today, a leaving date, a closing date).
+
+   ```bash
+   work=$(mktemp -d 2>/dev/null || mktemp -d ./.work.XXXXXX)   # a private folder for this run only
+   # Claude Code
+   python3 "${CLAUDE_SKILL_DIR}/scripts/vesting.py" "$work/vesting.json" --as-of 2027-06-30
+   # Other IDEs (from the skill folder); --csv writes every vesting date
+   python3 scripts/vesting.py "$work/vesting.json" --csv vesting-schedule.csv --full
+   ```
+
+   Exit 0 means computed, 1 means a check failed (a schedule that doesn't sum to its grant, or a
+   passed 83(b) deadline), 2 means the input can't be read. Rerun with the other reading of any
+   assumption that changes the answer.
+
+4. **Reply in this order:**
+   1. **The answer** to their question, with the numbers and dates.
+   2. **Each grant's summary:** cliff date and amount, fully vested date, vested and unvested now.
+   3. **Deadlines:** 83(b) dates, last days to exercise.
+   4. **The schedule,** yearly in the reply (every date in a spreadsheet when asked).
+   5. **Assumptions,** one line each.
+   6. **What to have a lawyer or tax adviser look at,** one or two lines.
+
+**Non-interactive runs** (subagent, CI, headless): unsaid terms take the defaults above, tagged
+`[assumption]`. With no share count or no start date for a grant, emit `BLOCKED: need each
+grant's shares and vesting start date`.
+
+## Useful references in this skill
+
+- [`templates/vesting.json`](templates/vesting.json) — the input: a founder with double-trigger acceleration, an engineer who leaves, an advisor on quarterly vesting
+- [`scripts/vesting.py`](scripts/vesting.py) — cliffs, month-end dates, whole-share rounding, leavers, acceleration, 83(b) deadlines with US holidays
+- [`examples/cofounder-leaving.md`](examples/cofounder-leaving.md) — worked example: a co-founder leaving 14 months in, with a missed 83(b) question
+
+## Quality bar
+
+- **Every share count and date comes from the computed schedule,** and each grant's dates sum to its shares.
+- **A start on the 29th–31st vests on the last day of shorter months,** and leap years count.
+- **The 83(b) deadline is an exact date,** moved past weekends and federal holidays, and a passed one is said plainly.
+- **Leaving gives vested, unvested and the exercise deadline,** each from the leaving date, not today.
+- **Every assumed term is stated,** with the other reading's figure when it changes the answer.
+- **The reply answers the question first,** with no mention of scripts or files.
+
+## When to use this skill
+
+- ✅ A co-founder or early employee is leaving and everyone needs the numbers
+- ✅ A new grant was signed: when does it cliff, and when is the 83(b) due
+- ✅ An acquirer or investor asks what vests on a sale
+- ✅ Building the schedule for a founder agreement or an option plan
+
+## When NOT to use this skill
+
+- ❌ Tax: what an 83(b) or an exercise costs, ISOs against NSOs, EMI or ESOP rules
+- ❌ Ownership after a funding round: that's a cap table
+- ❌ Drafting the stock purchase or option agreement
+- ❌ Valuing the shares or setting a strike price
+
+## Anti-patterns to avoid
+
+- ❌ **"About 30 days from the grant."** The 83(b) date is exact, and a weekend moves it.
+- ❌ **Vesting from the grant date when the agreement says an earlier start.** Founders often backdate the start to when they began.
+- ❌ **Rounding each month up.** A schedule of 2,500.4 shares a month that rounds up overshoots the grant; round the running total down and settle on the last date.
+- ❌ **Treating double-trigger as automatic on a sale.** It needs the second trigger.
+- ❌ **Counting the leaver's vesting to today** instead of to their leaving date.
+- ❌ **"The schedule shows…"** The founder wants the number.

package/packs/startup-legal/skills/vesting-schedule/evals/eval_queries.json

@@ -0,0 +1,30 @@
+[
+  {
+    "query": "How much has my co-founder vested if she leaves next month?",
+    "should_trigger": true
+  },
+  {
+    "query": "When is the 83(b) deadline for the stock we signed last week?",
+    "should_trigger": true
+  },
+  {
+    "query": "Build the vesting schedule for our first three hires' options",
+    "should_trigger": true
+  },
+  {
+    "query": "What does double-trigger acceleration give our team if we're acquired?",
+    "should_trigger": true
+  },
+  {
+    "query": "How much of the company will I own after the Series A?",
+    "should_trigger": false
+  },
+  {
+    "query": "Review this employment contract before I send it",
+    "should_trigger": false
+  },
+  {
+    "query": "What strike price should our options have?",
+    "should_trigger": false
+  }
+]

package/packs/startup-legal/skills/vesting-schedule/evals/evals.json

@@ -0,0 +1,70 @@
+{
+  "skill_name": "vesting-schedule",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "My co-founder Alex is leaving on 30 September 2026. 3,000,000 founder shares, four-year vesting, one-year cliff, monthly, from 1 July 2025; the stock purchase agreement was signed 15 September 2025. How much does Alex keep, and does it matter if Alex never filed the 83(b)?",
+      "assertions": [
+        "Says Alex keeps 875,000 shares and 2,125,000 are unvested and can be bought back",
+        "Gives the cliff as 1 July 2026 with 750,000 shares",
+        "Gives the 83(b) deadline as 15 October 2025, 30 days after the purchase, and says it has passed",
+        "Explains plainly what a missed 83(b) means: each vesting tranche is taxed as it vests",
+        "Does not mention a script or the skill's name, and does not invent terms (acceleration, repurchase price) not in the prompt"
+      ]
+    },
+    {
+      "id": 2,
+      "held_out": "2026-11-08",
+      "prompt": "my cofounder Dana Okafor has 850,000 founder shares, 4 year vesting with a 1 year cliff, monthly after that, vesting start 31 Jan 2024. she's leaving on 20 Sep 2026. how much has she vested, when did the cliff hit, and what happens to the rest?",
+      "assertions": [
+        "Cliff is 31 January 2025, when 212,500 shares vest (850,000 x 12 / 48)",
+        "Handles the 31st start in short months: the February 2025 vesting date is 28 February 2025 (not 3 March or skipped), with cumulative vested 230,208 (floor of 850,000 x 13 / 48); later dates fall on the last day of shorter months, e.g. 30 June",
+        "Vested on leaving (20 September 2026) is 548,958 shares - 31 months, last vesting date 31 August 2026 (floor of 850,000 x 31 / 48 = 548,958.33); accept 548,959 only if a different rounding is stated",
+        "The September 2026 vesting date (30 September 2026) falls after she leaves, so it does not vest",
+        "Unvested shares are 301,042 (850,000 - 548,958), and the answer says that for founder stock these are normally subject to the company's repurchase right (typically at the original price) or forfeited under the stock agreement, rather than describing an option exercise window",
+        "Does not invent acceleration, a repurchase price, a leaving reason, or 83(b) facts that are not in the prompt, and says the stock agreement governs"
+      ]
+    },
+    {
+      "id": 3,
+      "held_out": "2026-11-08",
+      "prompt": "We're Larkspur Robotics, Inc. (Delaware) and I need our vesting worked out before a board meeting. Grants:\n\n1. Mei Tanaka (co-founder, CEO): 3,000,000 shares of restricted common stock, vesting commencement date 1 March 2025, 48 months, 12-month cliff, then monthly. Double-trigger acceleration: 100% of unvested shares vest if she is terminated without cause within 12 months after a change of control.\n2. Tomas Herrera (co-founder, CTO): 2,000,000 shares of restricted common stock, same schedule and start date as Mei. Single-trigger acceleration: 25% of his then-unvested shares vest on a change of control. No other acceleration.\n3. Noor Haddad (joining as third co-founder): buys 650,000 shares of restricted common stock on 25 November 2026, vesting commencement date 25 November 2026, 48 months, 12-month cliff, then monthly. No acceleration.\n\nQuestions: (a) What is Noor's 83(b) filing deadline? (b) When is her cliff and how many shares vest then? (c) We have an offer that would close on 15 June 2027. What does each of the three have vested at closing, after any acceleration? (d) If the buyer terminates Mei without cause on 30 September 2027, what does she end up with? (e) What if instead they terminate her without cause on 20 July 2028?",
+      "assertions": [
+        "Noor's 83(b) deadline: 30 days after 25 November 2026 is Friday 25 December 2026, Christmas Day (a federal holiday), followed by a weekend, so the deadline moves to Monday 28 December 2026; the answer advises filing well before it",
+        "Noor's cliff is 25 November 2027 with 162,500 shares (650,000 x 12 / 48); at the 15 June 2027 closing she has 0 vested and, having no acceleration, still 0 after closing",
+        "At closing on 15 June 2027 (27 months, last vesting date 1 June 2027): Mei has 1,687,500 vested (3,000,000 x 27 / 48) and the sale alone does not accelerate her shares (double-trigger needs the termination too)",
+        "Tomas at closing: 1,125,000 vested by schedule (2,000,000 x 27 / 48) plus 25% of his 875,000 unvested = 218,750 accelerated, giving 1,343,750; applies the 25% to unvested shares, not to the whole grant (which would wrongly give 500,000)",
+        "Mei terminated without cause on 30 September 2027 is within 12 months of closing, so double-trigger applies: 1,875,000 vested by schedule (30 months, last vest 1 September 2027) plus 1,125,000 accelerated = all 3,000,000 shares vested",
+        "Mei terminated on 20 July 2028 is outside the 12-month window (which ended 15 June 2028), so there is no acceleration: 2,500,000 vested (40 months, last vest 1 July 2028) and 500,000 unvested, subject to repurchase or forfeiture",
+        "Does not invent an option exercise window for this restricted stock, acceleration for Noor, a purchase or repurchase price, or deal terms not in the prompt"
+      ]
+    },
+    {
+      "id": 4,
+      "held_out": "2026-11-09",
+      "prompt": "My co-founder Ravi Okafor has 1,250,000 founder shares, 4-year vesting, 1-year cliff, monthly after that, vesting start 31 Aug 2025. He signed his stock purchase agreement on 27 Oct 2026 and hasn't filed an 83(b) yet. Today is 9 Nov 2026. How much has he vested, when did the cliff hit, and what's his 83(b) deadline?",
+      "assertions": [
+        "Cliff date is 31 Aug 2026, with 312,500 shares vesting then (1,250,000 x 12 / 48)",
+        "Vested today (9 Nov 2026) is 364,583 shares: 14 monthly dates have passed (to 31 Oct 2026), floor(1,250,000 x 14 / 48) = floor(364,583.33); unvested 885,417",
+        "Vesting dates fall on the 31st or the last day of shorter months (30 Sep 2025, 30 Nov 2026, 28 Feb 2027 etc.); the next vesting is 30 Nov 2026 for 26,042 shares (390,625 - 364,583), and vesting finishes on 31 Aug 2029",
+        "83(b) deadline: 30 days after the 27 Oct 2026 transfer is Thursday 26 Nov 2026, which is Thanksgiving (a US federal holiday), so the deadline moves to Friday 27 Nov 2026",
+        "Says the 30-day clock runs from the 27 Oct 2026 purchase/transfer date, not the 31 Aug 2025 vesting start, and urges filing promptly since the deadline cannot be extended",
+        "Does not invent a purchase price, a tax amount, acceleration terms or other details not in the prompt"
+      ]
+    },
+    {
+      "id": 5,
+      "held_out": "2026-11-09",
+      "prompt": "We're Halcyon Loom Inc. and we're in the middle of an acquisition, so I need two vesting questions answered precisely. Today is 9 Nov 2026.\n\n1. Lena Varga, a co-founder, got 1,100,000 shares of restricted stock with a vesting start of 29 March 2024: 48 months, 1-year cliff, monthly vesting after. She resigned effective 4 September 2026. Her stock purchase agreement gives the company the right to repurchase unvested shares at her original price, exercisable by written notice within 60 days of her termination date. We haven't sent any notice. How many shares has she vested, how many can we buy back, and are we still in time?\n\n2. Jonah Pike, an early employee, holds an option over 50,000 shares, vesting start 31 January 2025, same 4-year / 1-year-cliff / monthly terms. His grant has double-trigger acceleration: 100% of unvested shares vest if he is terminated without cause within 12 months after a change of control. The sale is due to close on 15 December 2026 and the buyer says it will keep him. How much is vested at closing, does his acceleration kick in at closing, and if the buyer lets him go without cause on 10 March 2027, how much will he have and what's his last day to exercise? His option agreement gives 90 days after termination to exercise.",
+      "assertions": [
+        "Lena: vesting dates fall on the 29th, except 28 Feb 2025 (and other Februaries); the cliff was 29 Mar 2025; at her 4 Sep 2026 departure 29 months had vested (last date 29 Aug 2026): floor(1,100,000 x 29 / 48) = floor(664,583.33) = 664,583 vested, leaving 435,417 unvested shares subject to repurchase",
+        "Lena's repurchase window: 60 days after 4 Sep 2026 is 3 Nov 2026, which is before today (9 Nov 2026), so the window closed 6 days ago with no notice sent; says the company appears to have lost the right under the agreement as described and should check the agreement's exact wording with counsel, rather than telling them they can still buy back",
+        "Jonah at closing (15 Dec 2026): 22 monthly dates have passed (last 30 Nov 2026, the month-end because November has 30 days): floor(50,000 x 22 / 48) = floor(22,916.67) = 22,916 vested; the cliff was 31 Jan 2026 with 12,500 vesting",
+        "States the double trigger is not met at closing because he is kept on (sale alone is one trigger), so nothing accelerates at closing",
+        "If terminated without cause on 10 Mar 2027 (85 days after closing, within the 12-month window), both triggers are met: without acceleration he would have 26,041 vested (25 months, last date 28 Feb 2027, floor(50,000 x 25 / 48)); acceleration vests the remaining 23,959, so all 50,000 are vested",
+        "Jonah's last day to exercise is 8 Jun 2027 (90 days after 10 Mar 2027)",
+        "Does not invent repurchase prices, exercise prices, tax figures, deal value or terms not in the prompt"
+      ]
+    }
+  ]
+}