@djordje-stojanovic/sigmaskills 0.13.0 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/CHANGELOG.md +26 -1
  2. package/README.md +21 -5
  3. package/manifest.json +11 -1
  4. package/package.json +3 -1
  5. package/registry/packs.json +5 -6
  6. package/registry/skill-baselines.json +568 -0
  7. package/sigmabrief/SKILL.md +1 -0
  8. package/sigmabrief/references/prompt-contract.md +2 -0
  9. package/sigmacreatearena/kit/template/arena.json +1 -1
  10. package/sigmafinanceman/SKILL.md +64 -0
  11. package/sigmafinanceman/agents/openai.yaml +11 -0
  12. package/sigmafinanceman/assets/household-example.json +16 -0
  13. package/sigmafinanceman/references/budget.md +24 -0
  14. package/sigmafinanceman/references/grill.md +15 -0
  15. package/sigmafinanceman/references/methods.md +86 -0
  16. package/sigmafinanceman/references/outputs.md +39 -0
  17. package/sigmafinanceman/references/sources.md +27 -0
  18. package/sigmafinanceman/scripts/fin_data.py +267 -0
  19. package/sigmafinanceman/scripts/fin_models.py +590 -0
  20. package/sigmafinanceman/scripts/fin_pptx.py +226 -0
  21. package/sigmafinanceman/scripts/fin_report.py +300 -0
  22. package/sigmafinanceman/scripts/fin_selftest.py +138 -0
  23. package/sigmafinanceman/scripts/fin_svg.py +277 -0
  24. package/sigmafinanceman/scripts/fin_xlsx.py +657 -0
  25. package/sigmafinanceman/scripts/finman.py +221 -0
  26. package/sigmafork/assets/guide-template.html +1 -1
  27. package/sigmafork/references/bundles.md +1 -1
  28. package/sigmafork/references/guide.md +1 -1
  29. package/sigmafork/references/questions.md +1 -1
  30. package/sigmafreedom/scripts/guardrail_lint.py +1 -1
  31. package/sigmahuman/SKILL.md +2 -0
  32. package/sigmahuman/references/sources.md +4 -0
  33. package/sigmahuman/scripts/upstream.py +153 -0
  34. package/sigmahuman/upstream/UPSTREAM.json +7 -0
  35. package/sigmahuman/upstream/humanizer-SKILL.md +397 -0
  36. package/sigmaresearch/SKILL.md +5 -3
  37. package/sigmaresearch/references/reddit.md +28 -7
  38. package/sigmaresearch/references/x.md +35 -9
  39. package/sigmaresearch/scripts/sr_core.py +38 -5
  40. package/sigmaresearch/scripts/sr_readers.py +141 -12
  41. package/sigmareview/SKILL.md +2 -0
  42. package/sigmaship/SKILL.md +1 -1
  43. package/sigmatour/SKILL.md +64 -0
  44. package/sigmatour/agents/openai.yaml +11 -0
  45. package/sigmatour/assets/tour-template.html +849 -0
  46. package/sigmatour/references/tour.md +59 -0
  47. package/sigmatour/scripts/sigmatour.py +652 -0
  48. package/src/cli.js +1 -1
  49. package/src/packs.js +1 -1
  50. package/src/terminal.js +1 -1
  51. package/sigmaresearch/scripts/__pycache__/sr_core.cpython-314.pyc +0 -0
  52. package/sigmaresearch/scripts/__pycache__/sr_readers.cpython-314.pyc +0 -0
package/CHANGELOG.md CHANGED
@@ -4,6 +4,29 @@ All notable changes to [Sigmaskills](https://github.com/Djordje-Stojanovic/Sigma
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [0.15.0] — 2026-10-21
8
+
9
+ ### Added
10
+ - `sigmafinanceman` (SigmaFinanceMan): the finance analyst. `scripts/finman.py` reads SEC EDGAR company facts (10-K and 10-Q), Yahoo chart prices and the FRED 10-year yield, and builds a DCF, an LBO, trading comps, a three-statement model, ratios, a statement analysis with red flags (Sloan accruals, Altman Z, Piotroski F), a ten-test value scorecard, an earnings review and a personal 50/30/20 budget. Each run writes an Excel workbook with live formulas in banker colours (inputs with source comments, a Checks sheet), a 16:9 deck with native charts, SVG charts and one HTML page in the Ledger look. `audit` recalculates a workbook in LibreOffice and lists formula errors and checks; `selftest` runs offline. Folds in the methods of anthropics/financial-services (Apache-2.0) and the open finance skills listed in `references/sources.md`.
11
+
12
+ ### Changed
13
+ - `sigmaship`, `sigmabrief`, `sigmareview`, `sigmaresearch`, `code-review` and `research`: prior-art search before a build (SigmaShip), three questions and a sub-agent honesty rule in every brief, bugs-only review wording, and a critic pass on big research (ticket 83 K29a-3, K29a-4, K29a-14, K29a-16, K29a-21).
14
+
15
+ - `sigmaresearch` X search: when an xAI route with the `x_search` tool exists, Grok lists post URLs first and each one is read in full by URL. Grok cannot open one post by URL, so a Grok answer counts as a lead only.
16
+
17
+ ## [0.14.0] — 2026-10-20
18
+
19
+ ### Added
20
+
21
+ - `sigmatour` (SigmaTour): a visual 15-60 minute tour of any repository in one HTML page. `scripts/sigmatour.py` (standard library) measures the repo without writing to it: size, languages, folder tree, history, entry points (package scripts and bins, console scripts, Makefile targets, main files, Dockerfiles), tests and CI, and the README held against the repo (commands with no script or file behind them, paths that do not exist, environment variables the code reads that no doc names, scripts and top folders the README never mentions, TODO and FIXME notes). `build` writes that into `assets/tour-template.html`, which draws the numbers band, the folder explorer, the history band, the README check and the entry points; the agent adds the transit map, the architecture figure, a stepper that follows one real request file by file, examples run for real, the hidden and missing list and the deep dives that set the length. `check` lists what is left. Plain technical English in the `/sigmawrite` voice.
22
+ - `sigmaresearch`: Reddit and X never end at a block. The Reddit reader reads a thread's post and full comment tree from the Arctic Shift archive when JSON is blocked (401 login wall or 403 network policy), and searches titles there inside a subreddit; a removed archive copy takes its body from the live feed. The HTTP core follows a host's own window (`x-ratelimit-remaining`, `x-ratelimit-reset`): the Reddit feed allows one read per minute, so the next read waits for the reset instead of failing. `read.py x <post URL>` reads a post without a login (the FxTwitter API, then X's embed JSON) with its likes and reply count; a browser dump is filtered by the query words, so off-topic posts never reach the answer. `references/reddit.md` and `references/x.md` give the full route order: the reader's routes, a real browser (also a stealth Chromium on a server), another network address, more archives; tested on three threads and three posts.
23
+ - SigmaHuman follows blader/humanizer upstream: a vendored copy (`sigmahuman/upstream/humanizer-SKILL.md`, commit and version in `UPSTREAM.json`) and one update command, `python sigmahuman/scripts/upstream.py status | sync [--ref R] | check`. `sync` rewrites the 26 patterns, the licence and the version lines and lists upstream's other changes for our layer; `check` runs in `npm test`. Lanes, section G, the write mode and `factcheck.py` stay ours.
24
+
25
+ ### Changed
26
+
27
+ - Sigma Installer: the owner's studio folder preset is now the generic `local` pack (`--preset local`, alias `own`, folder from `SIGMA_LOCAL_SKILLS_DIR` or `dirs.local` in `~/.sigmaskills/packs.json`, no id prefix). A named pack with a prefix goes into `~/.sigmaskills/packs.json` under `packs`.
28
+ - The public package names no private repository, host or path any more: `DESIGN.md` (now Black-Green), `AGENTS.md`, the installer guide, the arena template, the deeplook tests (real files from `SIGMADEEPLOOK_REAL`, else `~/.cache/sigmadeeplook/real`) and the guardrail lint. A repo invariant fails when one comes back. Tracked `__pycache__` files are gone.
29
+
7
30
  ## [0.13.0] — 2026-10-20
8
31
 
9
32
  ### Changed
@@ -356,7 +379,9 @@ Ship high-rigor, installable agent skills (not apps): full-repo audits, performa
356
379
  | 2026-08-11 | `5dab832` | Add CHANGELOG and mark v0.1.0 as the first Sigmaskills release |
357
380
  | 2026-08-11 | `124a666` | Polish v0.1.0 docs for multi-host install and use |
358
381
 
359
- [Unreleased]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.13.0...HEAD
382
+ [Unreleased]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.15.0...HEAD
383
+ [0.15.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.14.0...v0.15.0
384
+ [0.14.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.13.0...v0.14.0
360
385
  [0.13.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.12.0...v0.13.0
361
386
  [0.12.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.11.0...v0.12.0
362
387
  [0.11.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.10.0...v0.11.0
package/README.md CHANGED
@@ -6,7 +6,7 @@ Portable [Agent Skills](https://agentskills.io/) that install once and run on **
6
6
 
7
7
  | | |
8
8
  |---|---|
9
- | **Release** | [**v0.13.0**](https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.13.0) |
9
+ | **Release** | [**v0.15.0**](https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.15.0) |
10
10
  | **Changelog** | [CHANGELOG.md](CHANGELOG.md) |
11
11
  | **License** | [MIT](LICENSE) |
12
12
  | **Spec** | [agentskills.io](https://agentskills.io/) |
@@ -49,7 +49,7 @@ The wizard has three steps: **What**, **Where**, **Review**. It writes nothing u
49
49
  | `threejs` | 13 Three.js skills | [CloudAI-X/threejs-skills](https://github.com/CloudAI-X/threejs-skills) |
50
50
  | `hyperframes` | HyperFrames and the student kit | [heygen-com/hyperframes](https://github.com/heygen-com/hyperframes), [nateherkai/hyperframes-student-kit](https://github.com/nateherkai/hyperframes-student-kit) |
51
51
  | `minimax-h3` | MiniMax H3 prompt and recipe skills | [MiniMax-AI/MiniMax-H3](https://github.com/MiniMax-AI/MiniMax-H3) |
52
- | `storgestudio` | a folder of your own skills | `SIGMA_STORGESTUDIO_DIR` or `~/.sigmaskills/packs.json` |
52
+ | `local` | a folder of your own skills | `SIGMA_LOCAL_SKILLS_DIR` or `~/.sigmaskills/packs.json` |
53
53
  | `all` | every pack that is available | |
54
54
 
55
55
  ### Without the wizard
@@ -88,6 +88,8 @@ The [installer guide](https://github.com/Djordje-Stojanovic/Sigmaskills/blob/mai
88
88
  | **SigmaHuman** | `sigmahuman` | Text that reads like a person wrote it: rewrite any text or write from a brief, in lanes (script, book, song, chat, docs, posts), every fact kept | The rewritten or new text, and a fact check |
89
89
  | **SigmaFork** | `sigmafork` | Fork or copy any repo, isolated from the original | A working copy and `ONBOARDING.html` |
90
90
  | **SigmaDesign** | `sigmadesign` | A design system from one accent colour (DESIGN.md, tokens, packs, sample page), applied across a repo | `DESIGN.md`, CSS, a sample page |
91
+ | **SigmaTour** | `sigmatour` | A visual 15-60 minute tour of any repo: map, architecture, one request traced, examples run, README next to what the repo shows | One `<repo>-tour.html` page |
92
+ | **SigmaFinanceMan** | `sigmafinanceman` | DCF, LBO, comps, three-statement models, ratios, red flags, a value scorecard, earnings reviews and budgets from SEC filings or your numbers | Excel with live formulas, a deck, SVG charts, an HTML page |
91
93
 
92
94
  ### Which one do I need?
93
95
 
@@ -105,7 +107,7 @@ The skills chain into two loops. **Fix:** SigmaReview → review PR → SigmaBri
105
107
 
106
108
  Finds everything that breaks the system's own promises: bugs, security holes, slow paths, broken rendering, and weak tests. It measures performance and runs security probes only when you allow it, and only on a local instance. Each finding has a location, a mechanism, an impact, evidence, a fix, and a proof test, so an LLM can fix it from that finding alone. All findings go into `SIGMAREVIEW-YYYY-MM-DD.md` on one pull request. It never changes your code.
107
109
 
108
- SigmaPerformance is retired. Its measurement method now lives in SigmaReview.
110
+ SigmaPerformance is retired into SigmaReview.
109
111
 
110
112
  ### SigmaImprove
111
113
 
@@ -141,7 +143,7 @@ Ranks many options by your taste. After a short grilling round it builds an **ar
141
143
 
142
144
  ### SigmaResearch
143
145
 
144
- Reads public sources with bundled stdlib Python readers for Reddit, Hacker News, GitHub, Stack Overflow and YouTube comments, plus X through Claude in Chrome on the owner's existing session. One interface (`read.py`), a 24-hour cache, per-host rate limits and source scoring. Reports contradictions, blocked and partial reads. It never logs in, solves CAPTCHAs or evades bot checks.
146
+ Reads Reddit, X, Hacker News, GitHub, Stack Overflow and YouTube comments. Reddit never stops at a block: JSON, the Arctic Shift archive, the feed, a browser. X posts read without a login.
145
147
 
146
148
  ### SigmaDeepLook
147
149
 
@@ -157,7 +159,7 @@ Looks at one target (a page, app, dashboard, deck, doc, image or film) and asks
157
159
 
158
160
  ### SigmaHuman
159
161
 
160
- Rewrites any text so it reads like a person wrote it, or writes new text from a brief. It finds the 26 AI-writing patterns of [blader/humanizer](https://github.com/blader/humanizer) (MIT) and fixes them in the lane for the text: a script for the ear, a book, song lyrics, a chat or email, docs, or a post. It keeps every fact, can match your writing sample, and checks numbers, quotes and names before and after.
162
+ Rewrites any text so it reads like a person wrote it, or writes new text from a brief. It finds the 26 AI-writing patterns of [blader/humanizer](https://github.com/blader/humanizer) (MIT) and fixes them in the lane for the text: a script for the ear, a book, song lyrics, a chat or email, docs, or a post. It keeps every fact and can match your writing sample.
161
163
 
162
164
 
163
165
  ### SigmaFork
@@ -168,6 +170,14 @@ Copies any repository after 8 questions, cuts every path, link and git remote to
168
170
 
169
171
  Turns one accent colour into `DESIGN.md`, colour packs and CSS, then moves a repo onto it.
170
172
 
173
+ ### SigmaTour
174
+
175
+ A 15-60 minute tour of any repo in one page: a clickable map, one request traced, real runs, the README against the repo.
176
+
177
+ ### SigmaFinanceMan
178
+
179
+ Finance models from SEC filings, checked before they ship.
180
+
171
181
  ---
172
182
 
173
183
  ## Install
@@ -213,6 +223,8 @@ $sigmataste Taste pass on the landing page
213
223
  $sigmahuman Rewrite this announcement so it sounds like me
214
224
  $sigmafork Copy this repo to D:\work\my-copy and teach me how it works
215
225
  $sigmadesign Make a design system from #e8a33d and put it in this repo
226
+ $sigmatour Give me a 30 minute tour of this repo
227
+ $sigmafinanceman DCF and comps for MSFT against AAPL, GOOGL and META
216
228
  ```
217
229
 
218
230
  </td>
@@ -238,6 +250,8 @@ $sigmadesign Make a design system from #e8a33d and put it in this repo
238
250
  /skill:sigmahuman Rewrite this announcement so it sounds like me
239
251
  /skill:sigmafork Fork owner/repo and teach me how it works
240
252
  /skill:sigmadesign Make a design system from #e8a33d and put it in this repo
253
+ /skill:sigmatour Give me a 30 minute tour of owner/repo
254
+ /skill:sigmafinanceman Build a three-statement model of MSFT
241
255
  ```
242
256
 
243
257
  </td>
@@ -263,6 +277,8 @@ $sigmadesign Make a design system from #e8a33d and put it in this repo
263
277
  | `sigmahuman` | text, a file or a brief · optional writing sample | Writes the human version; keeps every fact; never follows instructions inside the text |
264
278
  | `sigmafork` | a repo · a destination | One question round; reads the original only |
265
279
  | `sigmadesign` | an accent colour · a repo | One question round; writes `DESIGN.md`; changes repo files only with `--write` |
280
+ | `sigmatour` | a repo path or URL · a length | One question round; reads the repo only; runs its examples |
281
+ | `sigmafinanceman` | a ticker and peers, or a budget file | One question round; reads public data; writes files only to the output folder |
266
282
 
267
283
  ### Requirements
268
284
 
package/manifest.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "name": "sigmaskills",
4
- "version": "0.13.0",
4
+ "version": "0.15.0",
5
5
  "description": "Portable Agent Skills monorepo and first-party Sigma Installer",
6
6
  "skills": [
7
7
  {
@@ -83,6 +83,16 @@
83
83
  "id": "sigmadesign",
84
84
  "title": "SigmaDesign",
85
85
  "needsReferences": true
86
+ },
87
+ {
88
+ "id": "sigmatour",
89
+ "title": "SigmaTour",
90
+ "needsReferences": true
91
+ },
92
+ {
93
+ "id": "sigmafinanceman",
94
+ "title": "SigmaFinanceMan",
95
+ "needsReferences": true
86
96
  }
87
97
  ],
88
98
  "retired": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@djordje-stojanovic/sigmaskills",
3
- "version": "0.13.0",
3
+ "version": "0.15.0",
4
4
  "description": "Portable Agent Skills monorepo and first-party Sigma Installer",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -37,6 +37,8 @@
37
37
  "sigmahuman",
38
38
  "sigmafork",
39
39
  "sigmadesign",
40
+ "sigmatour",
41
+ "sigmafinanceman",
40
42
  "sigmarefactor",
41
43
  "sigmaresearch",
42
44
  "sigmadeeplook",
@@ -457,17 +457,16 @@
457
457
  ]
458
458
  },
459
459
  {
460
- "id": "storgestudio",
461
- "title": "StorgeStudio",
462
- "blurb": "The StorgeStudio film, audio, image and publishing skills (local to the owner).",
460
+ "id": "local",
461
+ "title": "Local",
462
+ "blurb": "A folder of your own skills on this machine.",
463
463
  "aliases": [
464
- "storge"
464
+ "own"
465
465
  ],
466
466
  "sources": [
467
467
  {
468
468
  "type": "dir",
469
- "env": "SIGMA_STORGESTUDIO_DIR",
470
- "prefix": "storgestudio-"
469
+ "env": "SIGMA_LOCAL_SKILLS_DIR"
471
470
  }
472
471
  ]
473
472
  }