kesef 0.0.0-stage → 1.200.0

package/LICENSE

@@ -0,0 +1,33 @@
+KesefSkills — license (final, approved by Eliron 20.10.2026)
+
+This package has two parts with two licenses:
+
+1. Code: bin/kesefskills.js and the scripts/*.py helpers inside skills/ — MIT License (below).
+2. Skill content: every SKILL.md, references/ file, catalog.json, packs/*.json and llms.txt —
+   Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0).
+   See LICENSE-CONTENT.md and https://creativecommons.org/licenses/by-nc-sa/4.0/
+
+The skills are free. They are not financial, legal or tax advice.
+
+-----------------------------------------------------------------------------
+MIT License
+
+Copyright (c) 2026 KesefSkills
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSE-CONTENT.md

@@ -0,0 +1,17 @@
+# רישיון התוכן · Content license
+
+סופי (אושר 20.10.2026). Copyright (c) 2026 KesefSkills.
+
+תוכן הסקילים (קבצי SKILL.md, תיקיות references, catalog.json, packs ו-llms.txt) מופץ לפי
+**Creative Commons ייחוס-שימוש לא מסחרי-שיתוף זהה 4.0 בינלאומי (CC BY-NC-SA 4.0)**.
+
+- מותר: להשתמש, להעתיק, להתאים ולשתף, בחינם.
+- ייחוס: לציין «KesefSkills» ולקשר לרישיון.
+- לא מסחרי: אין למכור את התוכן או לכלול אותו במוצר בתשלום בלי אישור בכתב.
+- שיתוף זהה: עיבודים מופצים תחת אותו רישיון.
+
+Full legal code: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode
+
+הקוד (bin/ וסקריפטים) מופץ לפי MIT; ראו LICENSE.
+
+הסקילים אינם ייעוץ פיננסי, משפטי או מס, ואינם מבטיחים תוצאה. סכומים ומועדים מתעדכנים; בדקו מול המקור הרשמי.

package/README.md

@@ -1,3 +1,96 @@
-# Temporary Holding Version
+<div dir="rtl">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# KesefSkills — סקילים חינמיים בעברית לענייני כסף
+
+גרסה 1.200.0 · 352 סקילים · 12 ערכות · חינם, בלי מנוי ובלי חשבון.
+
+סקילים בפורמט **Agent Skills** (תיקייה עם `SKILL.md`) לסוכני AI כמו Claude Code, Cursor ו-Codex.
+כל סקיל עוזר להבין, לארגן ולנסח טיוטה בנושא כסף יומיומי בישראל: תלוש שכר, החזר מס, בנק וכרטיסי אשראי, דירה, רכב, הורות, פנסיה ועוד. הסקילים נשענים על מקורות רשמיים (gov.il, ביטוח לאומי, בנק ישראל, רשות המסים).
+
+> **הבהרה:** הסקילים מיועדים לסיוע בניסוח ובארגון ואינם מהווים ייעוץ פיננסי, משפטי או מס, ואינם מבטיחים תוצאה. כל תוצר הוא טיוטה שאתם בודקים. סכומים ומועדים משתנים; בדקו תמיד מול המקור הרשמי.
+
+## התקנה מהירה
+
+התקנה של כל סקיל: `npx kesef install <skill-id>` (ברירת מחדל: Claude Code בפרויקט הנוכחי; ל-Cursor או Codex מוסיפים `--agent cursor` / `--agent codex`).
+
+</div>
+
+```bash
+npx kesef list --packs                       # ערכות
+npx kesef search תלוש                        # חיפוש בעברית או באנגלית
+npx kesef install payslip-check              # סקיל אחד ל-Claude Code בפרויקט הנוכחי
+npx kesef install oved --agent cursor        # ערכה שלמה ל-Cursor
+npx kesef install rechev --agent all --global  # Claude Code + Cursor + .agents (Codex)
+```
+
+<div dir="rtl">
+
+## פקודות
+
+| פקודה | מה היא עושה |
+|---|---|
+| `list [--packs] [--skills] [--json]` | רשימת ערכות וסקילים |
+| `search <מילים>` | חיפוש בשם, בכותרת ובתיאור (עברית ואנגלית) |
+| `install <slug\|pack>` | העתקת סקיל או ערכה לתיקיית הסקילים של הכלי |
+| `--agent` (או `--target`) | `claude` (ברירת מחדל) · `cursor` · `codex` · `agents` · `codex-legacy` · `generic` · `all` (אפשר גם רשימה: `claude,cursor`) |
+| `--dir <path>` | תיקיית הפרויקט (ברירת מחדל: התיקייה הנוכחית) |
+| `--project` · `--global` | התקנה לפרויקט (ברירת מחדל) · לתיקיית המשתמש |
+| `--force` · `--dry-run` | לדרוס סקיל קיים · להציג בלי להעתיק |
+| `--help` · `--version` | עזרה · גרסה |
+
+ה-CLI רק מעתיק קבצים. הוא לא מתחבר לרשת, לא יוצר חשבון ולא שולח מידע.
+
+## לאן מותקן כל סקיל
+
+| יעד | בפרויקט | עם `--global` | מקור |
+|---|---|---|---|
+| `claude` | `.claude/skills/<slug>/SKILL.md` | `~/.claude/skills/<slug>/` | [Claude Code: Skills](https://code.claude.com/docs/en/skills) |
+| `cursor` | `.cursor/skills/<slug>/SKILL.md` | `~/.cursor/skills/<slug>/` | [Cursor: Agent Skills](https://cursor.com/docs/skills) |
+| `codex` | `.agents/skills/<slug>/SKILL.md` | `~/.agents/skills/<slug>/` | [Codex: Build skills](https://learn.chatgpt.com/docs/build-skills) |
+| `agents` | `.agents/skills/<slug>/SKILL.md` | `~/.agents/skills/<slug>/` | התיקייה המשותפת של תקן Agent Skills (Codex ו-Cursor קוראים ממנה) |
+| `codex-legacy` | `.codex/skills/<slug>/SKILL.md` | `~/.codex/skills/<slug>/` | מיקום ישן ש-Codex עדיין קורא ([openai/codex#10437](https://github.com/openai/codex/pull/10437)) |
+| `generic` | `./skills/<slug>/SKILL.md` | `~/.kesefskills/skills/<slug>/` | לכל כלי אחר |
+| `all` | claude + cursor + agents | אותו דבר, בתיקיית המשתמש | |
+
+הערות: ב-Cursor אנחנו משתמשים ב-`.cursor/skills` ולא ב-`.cursor/rules`, כי rules נטענים בכל שיחה, וסקילים נטענים רק כשהם רלוונטיים. Codex עדיין קורא גם מ-`~/.codex/skills` לתאימות לאחור, אבל המיקום המתועד היום הוא `.agents/skills`. אחרי התקנה כדאי להפעיל מחדש את הכלי.
+
+## תקן Agent Skills ותאימות
+
+כל סקיל הוא תיקייה `<slug>/SKILL.md` לפי [המפרט של Agent Skills](https://agentskills.io/specification): `name` זהה לשם התיקייה, אותיות קטנות, ספרות ומקפים, עד 64 תווים. `description` עד 1024 תווים. השדות האופציונליים הם `license` ו-`metadata`, והתיקיות האופציונליות `scripts/` ו-`references/`. כל הסקילים עוברים את הבודק הרשמי `skills-ref validate`.
+
+החבילה עובדת גם עם [`npx skills add`](https://skills.sh) מתיקייה מקומית, למשל `npx skills add ./node_modules/kesef -s payslip-check -a claude-code`.
+
+## ערכות
+
+| ערכה | שם | סקילים |
+|---|---|---|
+| `atzmai` | ערכת עצמאי | 14 |
+| `oved` | ערכת עובד | 14 |
+| `over-dira` | ערכת עובר דירה | 14 |
+| `mashkanta` | ערכת משכנתא ורכישת דירה | 16 |
+| `horim` | ערכת הורים וילדים | 15 |
+| `rechev` | ערכת רכב | 16 |
+| `pensia` | ערכת פנסיה וחיסכון | 14 |
+| `bank` | ערכת בנק וכרטיסי אשראי | 16 |
+| `tisa` | ערכת נסיעה לחו״ל | 12 |
+| `studentim` | ערכת סטודנטים | 13 |
+| `prisha` | ערכת פרישה ועזיבת עבודה | 13 |
+| `maasik` | ערכת מעסיק קטן | 15 |
+
+הרשימה המלאה: `catalog.json` (slug, כותרת, תיאור, ערכות, גרסה) ו-`llms.txt`.
+
+## פרטיות
+
+הסקילים רצים בתוך חשבון ה-AI שלכם. הם לעולם לא יבקשו ת״ז, פרטי בנק, מספר כרטיס או סיסמה.
+
+## מבנה הריפו
+
+- **שורש הריפו** הוא חבילת ה-npm `kesef`: `package.json`, `bin/` (ה-CLI), `skills/`, `packs/`, `catalog.json`, `llms.txt`.
+- **`site/`** הוא קוד האתר kesefskills.co.il (Cloudflare Worker): `src/`, `public/` (קבצים סטטיים שנכתבו ידנית), `scripts/` (בנייה ובדיקות), `migrations/`, `sql/` וקובצי `wrangler.*.toml`. עמודי המדריכים, ה-ZIP-ים והחבילות שנוצרים בבנייה לא נשמרים בריפו.
+- **`.github/workflows/publish.yml`** מפרסם ל-npm דרך Trusted Publishing (OIDC) כשנדחפת תגית `vX.Y.Z` שתואמת לגרסה ב-`package.json`. אין בריפו טוקנים או סודות.
+
+## רישיון
+
+קוד: MIT. תוכן הסקילים: CC BY-NC-SA 4.0. © 2026 KesefSkills. ראו `LICENSE` ו-`LICENSE-CONTENT.md`.
+
+</div>

package/bin/kesef.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+// KesefSkills CLI: list / search / install free Hebrew money skills (Agent Skills format: <slug>/SKILL.md).
+// Zero dependencies. Node >= 18. Copies files only: no network, no accounts, nothing is sent anywhere.
+"use strict";
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const ROOT = path.resolve(__dirname, "..");
+const CATALOG = JSON.parse(fs.readFileSync(path.join(ROOT, "catalog.json"), "utf8"));
+const PKG = JSON.parse(fs.readFileSync(path.join(ROOT, "package.json"), "utf8"));
+const DISC = "הסקילים מיועדים לסיוע בניסוח ובארגון ואינם מהווים ייעוץ פיננסי, משפטי או מס. כל תוצר הוא טיוטה שאתם בודקים.";
+
+// Install targets (Agent Skills standard, https://agentskills.io/specification: one <name>/SKILL.md folder per skill).
+// Paths checked against each agent's official docs on 20.10.2026:
+//   claude : https://code.claude.com/docs/en/skills       project .claude/skills/<name>/ · personal ~/.claude/skills/<name>/
+//   cursor : https://cursor.com/docs/skills               project .cursor/skills/ · user ~/.cursor/skills/ (also reads .agents/skills)
+//   codex  : https://learn.chatgpt.com/docs/build-skills  repo .agents/skills/ · user $HOME/.agents/skills/
+//            (~/.codex/skills is the deprecated user location Codex still reads: target "codex-legacy")
+//   agents : the shared .agents/skills folder of the standard (Codex, Cursor and other agents read it)
+//   generic: ./skills (or ~/.kesefskills/skills with --global) for any other tool
+const TARGETS = {
+  claude: { project: [".claude", "skills"], global: [".claude", "skills"], label: "Claude Code" },
+  cursor: { project: [".cursor", "skills"], global: [".cursor", "skills"], label: "Cursor" },
+  codex: { project: [".agents", "skills"], global: [".agents", "skills"], label: "Codex" },
+  "codex-legacy": { project: [".codex", "skills"], global: [".codex", "skills"], label: "Codex (legacy .codex/skills)" },
+  agents: { project: [".agents", "skills"], global: [".agents", "skills"], label: "Agent Skills (.agents)" },
+  generic: { project: ["skills"], global: [".kesefskills", "skills"], label: "generic ./skills" },
+};
+const ALL = ["claude", "cursor", "agents"];   // --agent all: Claude Code + Cursor + .agents (Codex and other standard agents)
+
+const HELP = `kesef ${PKG.version} (KesefSkills) — סקילים חינמיים בעברית לענייני כסף (Agent Skills)
+
+שימוש:
+  kesef list [--packs] [--skills] [--json]
+  kesef search <מילים | words> [--json]
+  kesef install <slug|pack> [--agent claude|cursor|codex|agents|codex-legacy|generic|all] [--dir <path>] [--global] [--force] [--dry-run]
+  kesef --help | --version
+
+דוגמאות:
+  npx kesef list --packs
+  npx kesef search משכנתא
+  npx kesef install payslip-check --target claude
+  npx kesef install oved --agent cursor --dir ./my-project
+  npx kesef install rechev --agent all --global
+
+יעדים: --agent (או --target), ברירת מחדל claude; בפרויקט (ברירת מחדל, --project) או --global:
+  claude        .claude/skills/<slug>/   (גלובלי: ~/.claude/skills/)
+  cursor        .cursor/skills/<slug>/   (גלובלי: ~/.cursor/skills/)
+  codex         .agents/skills/<slug>/   (גלובלי: ~/.agents/skills/)
+  agents        .agents/skills/<slug>/   (גלובלי: ~/.agents/skills/)
+  codex-legacy  .codex/skills/<slug>/    (גלובלי: ~/.codex/skills/, לגרסאות Codex ישנות)
+  generic       ./skills/<slug>/         (גלובלי: ~/.kesefskills/skills/)
+  all           claude + cursor + agents
+
+${DISC}
+`;
+
+function parse(argv) {
+  const o = { _: [], flags: {} };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith("--")) {
+      const [k, v] = a.slice(2).split("=");
+      if (["target", "agent", "dir"].includes(k)) o.flags[k] = v !== undefined ? v : argv[++i];
+      else o.flags[k] = true;
+    } else if (a === "-h") o.flags.help = true;
+    else if (a === "-v") o.flags.version = true;
+    else o._.push(a);
+  }
+  return o;
+}
+
+const norm = (s) => String(s || "").toLowerCase()
+  .replace(/[\u0591-\u05C7]/g, "")          // niqqud / cantillation
+  .replace(/[\u05F3\u05F4'"`״׳]/g, "")       // geresh / gershayim / quotes
+  .replace(/משכנתה/g, "משכנתא")
+  .replace(/[-_]/g, " ").replace(/\s+/g, " ").trim();
+
+const skillBy = Object.fromEntries(CATALOG.skills.map((s) => [s.slug, s]));
+const packBy = Object.fromEntries(CATALOG.packs.map((p) => [p.slug, p]));
+
+function list(f) {
+  const showPacks = f.packs || !f.skills, showSkills = f.skills || !f.packs;
+  if (f.json) {
+    const out = {};
+    if (showPacks) out.packs = CATALOG.packs.map((p) => ({ slug: p.slug, title: p.title, skills: p.skills.length }));
+    if (showSkills) out.skills = CATALOG.skills.map((s) => ({ slug: s.slug, title: s.title }));
+    console.log(JSON.stringify(out, null, 2)); return 0;
+  }
+  if (showPacks) {
+    console.log(`ערכות (${CATALOG.packs.length}):`);
+    for (const p of CATALOG.packs) console.log(`  ${p.slug.padEnd(12)} ${p.title} · ${p.skills.length} סקילים`);
+  }
+  if (showSkills) {
+    if (showPacks) console.log("");
+    console.log(`סקילים (${CATALOG.skills.length}):`);
+    for (const s of CATALOG.skills) console.log(`  ${s.slug.padEnd(40)} ${s.title}`);
+  }
+  return 0;
+}
+
+function search(q, f) {
+  const terms = norm(q).split(" ").filter(Boolean);
+  if (!terms.length) { console.error("search: חסרה מילת חיפוש (missing query)"); return 2; }
+  const score = (s) => {
+    const hay = [norm(s.slug), norm(s.title), norm(s.description), norm((s.packs || []).join(" "))];
+    let sc = 0;
+    for (const t of terms) {
+      if (hay[0].includes(t)) sc += 5;
+      if (hay[1].includes(t)) sc += 4;
+      if (hay[2].includes(t)) sc += 1;
+      if (hay[3].includes(t)) sc += 2;
+      if (!hay.some((h) => h.includes(t))) return 0;
+    }
+    return sc;
+  };
+  const hits = CATALOG.skills.map((s) => [score(s), s]).filter((x) => x[0] > 0).sort((a, b) => b[0] - a[0] || a[1].slug.localeCompare(b[1].slug));
+  const packs = CATALOG.packs.filter((p) => terms.every((t) => norm(p.slug + " " + p.title + " " + p.blurb).includes(t)));
+  if (f.json) { console.log(JSON.stringify({ packs: packs.map((p) => p.slug), skills: hits.map((h) => h[1].slug) }, null, 2)); return 0; }
+  if (!hits.length && !packs.length) { console.log(`לא נמצאו תוצאות עבור "${q}"`); return 1; }
+  for (const p of packs) console.log(`  [ערכה] ${p.slug.padEnd(12)} ${p.title}`);
+  for (const [, s] of hits.slice(0, 25)) console.log(`  ${s.slug.padEnd(40)} ${s.title}`);
+  if (hits.length > 25) console.log(`  … ועוד ${hits.length - 25}`);
+  return 0;
+}
+
+function copyDir(src, dst) {
+  fs.mkdirSync(dst, { recursive: true });
+  for (const e of fs.readdirSync(src, { withFileTypes: true })) {
+    const a = path.join(src, e.name), b = path.join(dst, e.name);
+    if (e.isDirectory()) copyDir(a, b); else fs.copyFileSync(a, b);
+  }
+}
+
+function install(what, f) {
+  if (!what) { console.error("install: חסר שם סקיל או ערכה (missing <slug|pack>)"); return 2; }
+  if (f.global && f.project) { console.error("install: בחרו --global או --project, לא את שניהם"); return 2; }
+  const raw = String(f.agent || f.target || "claude").toLowerCase().split(",").map((x) => x.trim()).filter(Boolean);
+  const names = [...new Set(raw.flatMap((x) => (x === "all" ? ALL : [x])))];
+  const bad = names.filter((x) => !TARGETS[x]);
+  if (bad.length || !names.length) { console.error(`install: יעד לא מוכר "${bad.join(",")}". יעדים: ${Object.keys(TARGETS).join(", ")}, all`); return 2; }
+  let slugs;
+  if (packBy[what]) slugs = packBy[what].skills;
+  else if (skillBy[what]) slugs = [what];
+  else { console.error(`install: לא נמצא סקיל או ערכה בשם "${what}". נסו: kesef search ${what}`); return 2; }
+  const seen = new Set();
+  for (const tname of names) {
+    const t = TARGETS[tname];
+    const base = f.global ? path.join(os.homedir(), ...t.global) : path.join(path.resolve(f.dir || process.cwd()), ...t.project);
+    if (seen.has(base)) continue; seen.add(base);
+    console.log(`${f["dry-run"] ? "[dry-run] " : ""}מתקין ${slugs.length} סקילים ל-${t.label} (${f.global ? "גלובלי" : "פרויקט"}): ${base}`);
+    let done = 0, skipped = 0;
+    for (const s of slugs) {
+      const src = path.join(ROOT, "skills", s), dst = path.join(base, s);
+      if (!fs.existsSync(path.join(src, "SKILL.md"))) { console.error(`  ✗ ${s}: SKILL.md חסר בחבילה`); return 3; }
+      if (fs.existsSync(dst) && !f.force) { console.log(`  • ${s} כבר קיים (דילוג; --force כדי לדרוס)`); skipped++; continue; }
+      if (!f["dry-run"]) { if (fs.existsSync(dst)) fs.rmSync(dst, { recursive: true, force: true }); copyDir(src, dst); }
+      console.log(`  ✓ ${s} → ${path.join(dst, "SKILL.md")}`); done++;
+    }
+    const hint = tname === "claude" ? ` ב-Claude Code: /${slugs[0]}` : tname.startsWith("codex") ? ` ב-Codex: $${slugs[0]}` : tname === "cursor" ? ` ב-Cursor: /${slugs[0]}` : "";
+    console.log(`הותקנו ${done}${skipped ? `, דולגו ${skipped}` : ""}.${hint}`);
+  }
+  console.log(DISC);
+  return 0;
+}
+
+function main(argv) {
+  const o = parse(argv);
+  if (o.flags.version) { console.log(PKG.version); return 0; }
+  const cmd = o._[0];
+  if (o.flags.help || !cmd || cmd === "help") { console.log(HELP); return 0; }
+  if (cmd === "list" || cmd === "ls") return list(o.flags);
+  if (cmd === "search" || cmd === "find") return search(o._.slice(1).join(" "), o.flags);
+  if (cmd === "install" || cmd === "add") return install(o._[1], o.flags);
+  console.error(`פקודה לא מוכרת: ${cmd}\n`); console.log(HELP); return 2;
+}
+
+process.exitCode = main(process.argv.slice(2));