Add stock scoring commands

skills/openstock-agent-cli/references/commands/guide.md

@@ -7,6 +7,7 @@ This directory mirrors the `openstock` CLI command depth for agent execution.
 | `openstock version` | `version/` |
 | `openstock update` | `update/` |
 | `openstock search` | `search/` |
+| `openstock score ...` | `score/` |
 | `openstock api ...` | `api/` |
 | `openstock account ...` | `account/` |
 | `openstock market ...` | `market/` |
@@ -20,6 +21,7 @@ Subcommands also have leaf folders matching CLI depth, for example:
 | CLI Depth | Folder |
 | --- | --- |
 | `openstock api login` | `api/login/` |
+| `openstock score set` | `score/set/` |
 | `openstock account status` | `account/status/` |
 | `openstock market history` | `market/history/` |
 | `openstock universe chunks` | `universe/chunks/` |

skills/openstock-agent-cli/references/commands/score/delete/guide.md

@@ -0,0 +1,17 @@
+# `openstock score delete`
+
+Purpose: delete a saved stock evaluation score.
+
+Usage:
+
+```bash
+openstock score delete 005930
+```
+
+Inputs: `symbol`.
+
+Writes: `~/.config/openstock/scores.json` when a record exists.
+
+Output fields: `path`, `symbol`, `deleted`, `removed`.
+
+Agent rule: deletion changes local evaluation state; run only when requested.

skills/openstock-agent-cli/references/commands/score/get/guide.md

@@ -0,0 +1,17 @@
+# `openstock score get`
+
+Purpose: read a saved stock evaluation score.
+
+Usage:
+
+```bash
+openstock score get 005930
+```
+
+Inputs: `symbol`.
+
+Reads: `~/.config/openstock/scores.json`.
+
+Output fields: `path`, `symbol`, `score`, `updated_at_unix`.
+
+Agent rule: if the command fails with no saved score, do not infer a score of 0.

skills/openstock-agent-cli/references/commands/score/guide.md

@@ -0,0 +1,41 @@
+# `openstock score`
+
+## Purpose
+
+Store and query local stock evaluation scores by stock ID.
+
+## Storage
+
+Scores are stored beside `.env` under the OpenStock config directory:
+
+```text
+~/.config/openstock/scores.json
+```
+
+Each score is an integer from 0 to 100. `0` is the lowest evaluation and `100` is the highest.
+
+## Subcommands
+
+| Command | Purpose |
+| --- | --- |
+| `openstock score set <symbol> <score>` | Save or update a stock score. |
+| `openstock score get <symbol>` | Read one stock score. |
+| `openstock score list` | List all saved scores. |
+| `openstock score delete <symbol>` | Delete one stock score. |
+
+## Output Fields
+
+| Field | Meaning |
+| --- | --- |
+| `path` | Score file path. |
+| `symbol` | Normalized stock ID. |
+| `score` | 0 to 100 score. |
+| `updated_at_unix` | Update Unix timestamp in seconds. |
+| `count` | Number of saved scores. |
+| `scores` | Score records sorted by score descending. |
+| `deleted` | Whether a record was deleted. |
+| `removed` | Deleted record, if any. |
+
+## Agent Notes
+
+Use this for user- or strategy-defined evaluation state. Do not treat the score as market evidence unless the workflow defines how it was produced.

skills/openstock-agent-cli/references/commands/score/list/guide.md

@@ -0,0 +1,15 @@
+# `openstock score list`
+
+Purpose: list saved stock evaluation scores.
+
+Usage:
+
+```bash
+openstock score list
+```
+
+Reads: `~/.config/openstock/scores.json`.
+
+Output fields: `path`, `count`, `scores`.
+
+Agent rule: scores are sorted by score descending, then symbol ascending.

skills/openstock-agent-cli/references/commands/score/set/guide.md

@@ -0,0 +1,17 @@
+# `openstock score set`
+
+Purpose: save or update a stock evaluation score.
+
+Usage:
+
+```bash
+openstock score set 005930 87
+```
+
+Inputs: `symbol`, `score` from 0 to 100.
+
+Writes: `~/.config/openstock/scores.json`.
+
+Output fields: `path`, `symbol`, `score`, `updated_at_unix`.
+
+Agent rule: use only when the user or scoring workflow has produced a concrete score.