You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit f4d136f
Browse filesBrowse the repository at this point in the historyBrowse files
Estimate Codex's skill-listing budget and flag skills OpenCode truncates
Overnight round 2 (docs/44). The hygiene report gains a read-only
codex_listing section that applies Codex's own listing rule (2% of the
context window, 1,024-character description cap, ceil(bytes/4) tokens per
line; openai/codex#19679) to ~/.agents/skills, and an
opencode-output-truncation warning for enabled skills over OpenCode's
2,000-line / 50 KiB tool-output head (anomalyco/opencode#62718). Near-limit
documents are read through the bounded regular-file reader, so a FIFO
cannot block the report. No command, route, Store method or schema change.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Copy file name to clipboardExpand all lines: docs/08-web-ui.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -398,7 +398,7 @@ stated beside the setting and in every result.
398
398
| GET |`/api/search?q=term[&scope=SCOPE]`| search over name/description/body (scope-aware); bounded wildcard failures return the standard JSON `StoreError` 400 |
399
399
| GET |`/api/stats`| Store.stats plus scope/token enrichment: `scopes`, `all_total`, `all_tokens`, `all_avg_tokens`, `window`, `window_tokens`, `all_pct_window`, `largest`, `has_tiktoken`. When an enrichment step fails, the documented keys are still filled with safe fallbacks and the step is named in a `degraded` array (e.g. `"largest"`, `"scopes"`) |
400
400
| GET |`/api/doctor[?scope=all]`| Store.doctor (global), including filesystem/index drift and transaction-artifact diagnostics; `?scope=all` adds `scopes` + `duplicates` (`scopes.find_duplicates()`), and on an enrichment failure both are returned as `[]` with an entry appended to `degraded` (`[{"section", "reason"}]`), so a client can tell "no duplicates" from "the scan crashed" |
401
-
| GET | `/api/doctor?scope=SCOPE&hygiene=1` | Adds the bounded, deterministic, read-only Skill Hygiene Report under `hygiene`; uses only configured observed scope records, preserves ordinary Doctor output, rejects unknown scopes and `explain`, and returns degraded/unavailable evidence without a new endpoint or mutation. The report includes an advisory `ignored-frontmatter` finding for a documented behavioural key (`disable-model-invocation`, `allowed-tools`, …) that the reading consumer does not document; scopes without a documented key list (`global`, `commandcode`, `cursor`, project scopes) add a `frontmatter-key-support` unavailable signal instead. The report's `lockfiles` section reads the `skills` CLI's global `.skill-lock.json` and (when a project root is supplied) `skills-lock.json`, comparing declared copies read-only; no project root is supplied over HTTP, so that lock is reported unavailable. The report's `claude_listing` section estimates the Claude Code skill listing from the `claude-code` scope: entries honour `skillOverrides` (`off` excluded, `name-only` counted as its name), the per-entry cap is `skillListingMaxDescChars` (default 1,536) over `description` plus `when_to_use`, and the character budget is `SLASH_COMMAND_TOOL_CHAR_BUDGET` or `skillListingBudgetFraction` times the token window with the character figure marked as an estimate. `status` is `within_budget`, `over_budget_estimate`, or `unknown` when a settings file exists but could not be parsed, and `name_only_candidates` are ordered by description size only because Claude Code's invocation-count order is not observable. No project root is supplied over HTTP, so project `.claude/skills` instances are reported unavailable. An `agent-parse-risk` warning names instances whose frontmatter a stricter agent parser drops (empty block, unquoted `: `, byte-order mark before `---`). With `scope=codex` or `scope=all`, the read-only `codex_config` section and a `codex-config-dead-entry` warning list Codex `[[skills.config]]` path entries that name a folder, a missing file or a non-`SKILL.md` file and so never apply; v2 Quality lists each with the `SKILL.md` path to use. With `scope=all`, the read-only `agents_bridge` section and an `agents-bridge-gap` info finding name enabled `~/.agents/skills` skills that Claude Code cannot see, with the existing `sync` copy as the remedy (other scopes report it unavailable). |
401
+
| GET | `/api/doctor?scope=SCOPE&hygiene=1` | Adds the bounded, deterministic, read-only Skill Hygiene Report under `hygiene`; uses only configured observed scope records, preserves ordinary Doctor output, rejects unknown scopes and `explain`, and returns degraded/unavailable evidence without a new endpoint or mutation. The report includes an advisory `ignored-frontmatter` finding for a documented behavioural key (`disable-model-invocation`, `allowed-tools`, …) that the reading consumer does not document; scopes without a documented key list (`global`, `commandcode`, `cursor`, project scopes) add a `frontmatter-key-support` unavailable signal instead. The report's `lockfiles` section reads the `skills` CLI's global `.skill-lock.json` and (when a project root is supplied) `skills-lock.json`, comparing declared copies read-only; no project root is supplied over HTTP, so that lock is reported unavailable. The report's `claude_listing` section estimates the Claude Code skill listing from the `claude-code` scope: entries honour `skillOverrides` (`off` excluded, `name-only` counted as its name), the per-entry cap is `skillListingMaxDescChars` (default 1,536) over `description` plus `when_to_use`, and the character budget is `SLASH_COMMAND_TOOL_CHAR_BUDGET` or `skillListingBudgetFraction` times the token window with the character figure marked as an estimate. `status` is `within_budget`, `over_budget_estimate`, or `unknown` when a settings file exists but could not be parsed, and `name_only_candidates` are ordered by description size only because Claude Code's invocation-count order is not observable. No project root is supplied over HTTP, so project `.claude/skills` instances are reported unavailable. An `agent-parse-risk` warning names instances whose frontmatter a stricter agent parser drops (empty block, unquoted `: `, byte-order mark before `---`). With `scope=codex` or `scope=all`, the read-only `codex_config` section and a `codex-config-dead-entry` warning list Codex `[[skills.config]]` path entries that name a folder, a missing file or a non-`SKILL.md` file and so never apply; v2 Quality lists each with the `SKILL.md` path to use. The read-only `codex_listing` section estimates Codex's `~/.agents/skills` listing in tokens against 2% of the context window and adds a `codex-listing-budget` info finding when over it; an `opencode-output-truncation` warning names enabled skills in OpenCode-read scopes whose `SKILL.md` exceeds 2,000 lines or 50 KiB. With `scope=all`, the read-only `agents_bridge` section and an `agents-bridge-gap` info finding name enabled `~/.agents/skills` skills that Claude Code cannot see, with the existing `sync` copy as the remedy (other scopes report it unavailable). |
402
402
| GET |`/api/doctor?explain=CONSUMER[&project=DIR][&skill=NAME]`| adds the read-only effective-resolution report (issue #12, `effective.explain`) under `explain`; derived at read time, writes nothing, and reports `unknown-consumer`/`missing-project` as explicit results. **The report is confined to the manager's data directory** plus any extra root the operator passed at server construction; a request cannot widen that boundary (SEC-2/SEC-3): every path outside it is replaced by `<redacted>` with `paths_redacted: true`, and a `project` outside it returns resolution `project-outside-managed-roots`**without being walked** (no nested-root search, no instance read). Consumers include `commandcode`, `codex`, `claude-code`, `gemini`, the corrected `opencode`, `cline`, `kiro`, `amp`, `roo`, `zed`, plus `cursor`, `copilot` and `devin` with `undocumented-precedence`; a documented `home`-relative root is redacted exactly like an absolute `path` root. The CLI passes no boundary and stays fully transparent |
403
403
| GET |`/api/tokens?window=&name=&scope=&text=`| token/context estimate: with `text=` it estimates that text, with `name=` it estimates one skill's document (scope-qualified when `scope=` is a scope id, otherwise the first match across scopes), and with neither it aggregates over `scope` (default `all`). Aggregate responses add `window`, `window_tokens` and `pct_window`; `window` selects the context window (claude, claude-haiku, gpt-5.6, gpt-5, gpt-4o, gemini, gemini-2m) |
404
404
| GET |`/api/history?name=&limit=`| Store.history (name optional) |
Copy file name to clipboardExpand all lines: docs/44-overnight-user-problems-2026-11-13.md
+41-8Lines changed: 41 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
1
# Overnight User Problems — 2026-11-13
2
2
3
-
**Version 0.1.0**
3
+
**Version 0.2.0**
4
4
5
-
**AI manifest**: Ranked research record from one unattended improvement round on 2026-11-13: which real skill-management problems reported since 2026-10-01 this tool can detect locally, which three were fixed, and what is left for later rounds. Evidence is GitHub issues read on 2026-11-13; reaction counts on recent issues are small, so the ranking is judgment, not votes.
5
+
**AI manifest**: Ranked research record from two unattended improvement rounds on 2026-11-13: which real skill-management problems reported since 2026-10-01 this tool can detect locally, which three were fixed, and what is left for later rounds. Evidence is GitHub issues read on 2026-11-13; reaction counts on recent issues are small, so the ranking is judgment, not votes.
6
6
7
7
## 1. Method
8
8
@@ -21,14 +21,14 @@ deterministic check can catch it before the agent does.
21
21
22
22
| # | Problem | Evidence | Locally detectable? |
23
23
|---|---|---|---|
24
-
| 1 | Listing budgets silently truncate descriptions (Claude Code and Codex; Codex uses 2% of the window, fallback 8,000 characters) | claude-code #107255; codex #19679 (40 reactions) | Yes; Claude Code already estimated (`claude_listing`), Codex not yet|
24
+
| 1 | Listing budgets silently truncate descriptions (Claude Code and Codex; Codex uses 2% of the window, fallback 8,000 characters) | claude-code #107255; codex #19679 (40 reactions) | Yes; Claude Code already estimated (`claude_listing`); Codex **fixed in round 2**|
25
25
| 2 | A UTF-8 byte-order mark before `---` makes Codex skip the skill ("missing YAML frontmatter delimited by ---") | codex #13918 (updated 2026-10-28) | Yes — **fixed this round**|
26
26
| 3 | Frontmatter quirks drop skills in strict parsers | gemini-cli #25693| Partly — the existing lint now **reaches Doctor and Quality** this round |
27
27
| 4 | A Codex `[[skills.config]]``path` entry naming the skill **folder** silently disables nothing; it must name `SKILL.md`| codex #51044 (2026-10-05), codex #60951| Yes — **fixed this round**|
28
28
| 5 |`disable-model-invocation` ignored by some agents | opencode #53172, claude-code #98898| Partly; the ignored-frontmatter finding covers the documented part |
29
29
| 6 | Skills under `~/.agents/skills` invisible to some agents | claude-code #31005 (619 reactions), opencode #41213| Partly; Claude Code covered by `agents_bridge`|
0 commit comments