Skip to content

Concise skills rollout: docs-hygiene (10 skills, 9 model-invoked) #6554

Open

Description

@kyle-sexton

Part of #6476. Rewrite docs-hygiene's skills to the skill criteria in one draft PR, following the per-plugin runbook (/playbooks:skill-authoring, reference/rewrite-a-plugin.md). The runbook and the rewrite protocol it cites decide what ships; this issue holds only what is specific to the plugin.

The plugin today

  • Skills: audit-derivability, audit-encapsulation, audit-noise, audit-progressive-disclosure, compress, extract-ssot, rename-references, setup (user-invoked), write-for-agents, write-for-humans.
  • Outcome eval cases under evals/: 4. Probe files under probes/: 0.
  • 1 agent definition(s): out of scope for this skills pass unless the umbrella's agent pilot has landed.

Done when

  • The PR merges with a per-skill decision table in its body, and every shipped description and body was measured.
  • Any skill left unmeasured, and why, is named in the PR.

Needs a person

  • Approve the eval spend for this plugin (the /evals:plugin-eval estimate) before the measured passes.
  • Review the draft PR and mark it ready.

Generated by Claude Code

Activity

  1. added
    needs-triageNot yet classified. Floor until a type and one priority tier are set.
    on Oct 7, 2026
  2. github-actions commented on Oct 7, 2026

    @github-actions
    Contributor

    Thanks for filing this. This is a clear, well-scoped sub-task of the fleet-wide concise-skills rollout tracked in #6476: rewrite the docs-hygiene plugin's 10 skills (9 model-invoked, 1 user-invoked) to the skill criteria via the per-plugin runbook, producing a per-skill decision table with measured descriptions and bodies in the PR, and naming any skill left unmeasured.

    Scope, done-when criteria, and the "needs a person" items (eval spend approval, draft PR review) are already spelled out, so nothing appears missing. The plugin's lone agent definition is correctly called out as out of scope for this pass. I didn't find a duplicate issue for this specific plugin's rollout among the other fleet sub-tasks under #6476.

    Automated triage. A maintainer reviews it.

  3. removed
    needs-triageNot yet classified. Floor until a type and one priority tier are set.
    on Oct 12, 2026
  4. added theissue type on Oct 12, 2026
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: mediumReal value, no hard deadline; normal backlog flow.

    Type

    Fields

    No fields configured for Task.

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions