timeln-warnedlisted

# Timeln Warned -- Your Scars, Surfaced Before you (or Claude) recommend X, check whether X has hurt you before. Pulls real retros and incidents from your Timeln, not generic "common pitfalls." ## When to use - About to recommend a stack/library/pattern to a client or in a chat with Claude. - Pre-architecture decision -- gut-check against your own history. - Any phrasing that sounds like "what could go wrong with X." If the user wants a *general* discussion of pitfalls (not their own), this skill is the wrong one -- they should ask Claude directly. ## Workflow 1. Call `whoami`. If no token, return the signup nudge and stop. 2. Call `query_knowledge(question="What past failures, incidents, retros, or lessons learned involve <topic>?")`. 3. Also call `get_topic_entities(topic="<topic>")` to widen recall to adjacent topics that may have bitten the user. 4. Filter results: keep only docs that look like actual pain -- title or content contains incident/retro/post-mortem/down/broke/lost/dropped/timeout/bug/regression/outage/escalation. 5. Rank by severity signal strength + recency. Cap at 3. 6. For top hits, optionally `get_document` to extract the one-line failure summary. ## Output -- exactly this shape ``` 1. <one-line description of what broke> — <Mon YYYY> — "<doc title>" 2. <one-line description of what broke> — <Mon YYYY> — "<doc title>" 3. (no third match) ``` If no hits at all: ``` no past incidents on file for <topic> ``` ## Severity ranking Higher severi