Add stock scoring commands

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.