Skip to content

docs: replace restated upstream facts with pointers in knowledge and computer-use #12775

Open

Description

@kyle-sexton

Refs #12694

Outcome

14 passages in 9 files state a fact an external source owns. Rewrite each as a pointer to the live upstream section, or remove it, so the next upstream change cannot leave a stale copy here. Plugins: knowledge, computer-use.

Done when

  • Every row below is fixed: the restated value is deleted, the local decision stays in this repository's own words, and the pointer goes to the exact upstream section with an as-of date and a recheck trigger, per .claude/rules/skill-bodies-state-current-rules.md. A record beside a restated value does not fix it. A row marked Remove has no local dependency on the fact.
  • The PR passes check-stamps.sh --trigger-less (plugins/attribution/skills/audit/scripts/check-stamps.sh) on the files it touches.
  • Each touched plugin has a changelog fragment.

Scope: the knowledge and computer-use rows of #12694 only: docs/contracts/plugin-reconfiguration/README.md, plugins/knowledge/README.md, plugins/knowledge/skills/distill/SKILL.md, plugins/knowledge/skills/docpage-digest/SKILL.md, plugins/knowledge/skills/docpage-digest/context/anthropic-docs-profile.md, plugins/knowledge/skills/setup/SKILL.md, plugins/computer-use/README.md, plugins/computer-use/skills/diagnose/SKILL.md, plugins/computer-use/skills/setup/SKILL.md. The context-guard and disk-hygiene rows belong to the sibling child.

Rows

knowledge

computer-use

  • plugins/computer-use/README.md:32-34 (r060). Pointer: https://code.claude.com/docs/en/computer-use#screenshots-are-downscaled-automatically Drop the pixel-budget explanation and the claim that smaller monitors do not help; keep the decision that zoom is the lever, and point at the downscaling section. Same text also at: plugins/computer-use/skills/diagnose/SKILL.md:75-77, plugins/computer-use/skills/diagnose/SKILL.md:37-38; a row of its own covers it only if listed.
  • plugins/computer-use/skills/diagnose/SKILL.md:75-77 (r061). Pointer: https://code.claude.com/docs/en/computer-use#screenshots-are-downscaled-automatically Drop the megapixel-count explanation; keep the instruction to read the reference file before advising on resolution, and point at the downscaling section. Same text also at: plugins/computer-use/README.md:32-34, plugins/computer-use/skills/diagnose/SKILL.md:37-38; a row of its own covers it only if listed.
  • plugins/computer-use/skills/setup/SKILL.md:44-46,117-119 (r062). Pointer: none found; Upstream owner of the computer-use MCP tool descriptions (list_granted_applications, request_access); the fetched computer-use page does not name them. Search the docs for a tool reference or confirm via the /mcp tool listing. Drop what list_granted_applications returns and its read-only/no-side-effect description, in both places; keep the decision to use it as the check's probe, with a pointer.
  • plugins/computer-use/skills/setup/SKILL.md:60-61,117-118 (r063). Pointer: https://code.claude.com/docs/en/computer-use#approve-apps-per-session Drop the statement that request_access raises a consent dialog, in both places; keep the rule never to call it during a check, and point at the approval section.
  • plugins/computer-use/skills/setup/SKILL.md:65-66 (r064). Pointer: none found; Upstream doc on whether synthesized input resets the OS idle timer (Windows/macOS input injection or idle-detection docs); the computer-use page does not cover it. If none exists, reclassify as local measurement. Drop the claim that synthesized input does not reset the idle timer; keep the decision to probe and report the three timeouts, and point at an owner source once found. Same text also at: plugins/computer-use/README.md:29-31, plugins/computer-use/skills/diagnose/SKILL.md:42, plugins/computer-use/skills/setup/SKILL.md:79-81; a row of its own covers it only if listed.
  • plugins/computer-use/skills/setup/SKILL.md:104-107 (r065). Pointer: https://code.claude.com/docs/en/computer-use#approve-apps-per-session (confirm the section) Drop the description of the allowlist gate's refusal and its error text; keep reporting focus-stealing utilities as INFO with the retry pattern, and point at the approval section. Same text also at: plugins/computer-use/skills/diagnose/SKILL.md:41, plugins/computer-use/skills/diagnose/SKILL.md:80-81; a row of its own covers it only if listed.

Notes

Drafted by the issue-triage session. Agent choice, not an owner answer. Split from #12694 by whole plugins, so no file is touched by both children; every file above exists on origin/main. Size Medium from the passage count (14 of the parent's 28, which intake sized Large). Three rows (r318, r062, r064) have no pointer found yet and need a docs search before writing; the rule for each is in its row.

Lines are as of 3bd42cabfe (https://github.com/melodic-software/claude-code-plugins/blob/3bd42cabfe6bdef37a05778d396869af0381bb51); locate each passage by its text if main has moved. Each rNNN is that row's number in the order of #7292's "Findings by plugin". Pointers are candidates: fetch each before writing it, and confirm the section still documents the fact.

Related

Activity

  1. added theissue type on Nov 3, 2026
  2. added
    priority: lowNice-to-have, cosmetic, or speculative; opportunistic.
    status: readyTriaged, unblocked, and fully specified; eligible to pick up.
    work-class: scopedA briefed fix or small feature; blast radius bounded by the brief, tests exist.
    on Nov 3, 2026
  3. added
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    on Nov 3, 2026
  4. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor
    No description provided.
  5. melodic-automation-lanes commented on Nov 3, 2026

    @melodic-automation-lanes
    Contributor

    This records a re-fire of an earlier refusal, not a new refusal. The lanes kill switch stopped run 41594365657, the work-resolve-issue run that agent-ready started, before it did any work; that run ended at 2026-11-03T08:38:28Z. work-unblock has now removed and added agent-ready back to start a fresh run. A kill-switch refusal is no fault in this issue or the lanes, so it never counts against later re-fires; after limits.limit-stops-per-issue of them since a person last added agent-ready or a run last reported, work-unblock waits longer before each one, up to 24 hours.

  6. added
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    and removed
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    on Nov 3, 2026
  7. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor
    No description provided.
  8. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor
    No description provided.
  9. melodic-automation-lanes commented on Nov 3, 2026

    @melodic-automation-lanes
    Contributor

    The lanes App's pull request #12822 for this issue was closed without merging. work-unblock removed status: ready and agent-ready, so the hourly triage sweep sends it back to intake triage, which decides what work is left and admits it again.

  10. removed
    status: readyTriaged, unblocked, and fully specified; eligible to pick up.
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    on Nov 3, 2026
  11. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor

    The triage sweep dispatched intake triage for this issue (dispatch 1; 2 runs that reach intake, or 6 dispatches, hand it to a maintainer).

  12. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor

    Proposed work class: work-class: scoped
    Basis: automated intake triage; the lanes App applied this class.

    Size: Medium
    Complexity: Low
    Uncertainty: Knowable
    Flags: none
    Blocked by: none

    Understood: this is a docs-only cleanup across 9 files in the knowledge and computer-use plugins. It replaces 14 restated upstream facts with dated pointers to the live upstream section, or removes them. Each plugin also gets a changelog fragment, and the PR must pass check-stamps.sh --trigger-less. Three rows (r318, r062, r064) have no upstream pointer yet, so a docs search comes first. The issue gives the fallback for each row. I found no duplicate among the open issues. #12694 is the parent, and this issue is its split-out child.

    Automated triage, applied by the lanes App.

  13. added
    status: confirmedA maintainer confirmed the item is real and in scope; ready to be worked.
    and removed
    status: readyTriaged, unblocked, and fully specified; eligible to pick up.
    on Nov 3, 2026
  14. melodic-automation-lanes commented on Nov 3, 2026

    @melodic-automation-lanes
    Contributor

    Not admitted to the issue lane: merged pull request #12913 names it with Refs: after its newest decision or refinement comment, so its work may already be done: close the issue if it is, or post a comment whose first line is **Decision recorded.** saying what is left, which sends it back through intake. Admission takes the issue once each of those is met, when intake triages it again (.github/actions/resolve-config/admission-rules.json).

  15. melodic-automation-lanes commented on Nov 3, 2026

    @melodic-automation-lanes
    Contributor

    The latest triage verdict holds nothing: admission moved the issue to status: confirmed; its comment says why.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    priority: lowNice-to-have, cosmetic, or speculative; opportunistic.status: confirmedA maintainer confirmed the item is real and in scope; ready to be worked.work-class: scopedA briefed fix or small feature; blast radius bounded by the brief, tests exist.

    Type

    Fields

    Work status

    confirmed

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions